Instantané de la documentation · CLI 7.30.1 · SDK 2.6.53. Desktop utilise le runtime fourni avec sa propre version. Les commandes et exemples restent identiques à la source anglaise. Source anglaise

Choisir et changer de modèle

Trouver un modèle utilisable

Commencez par connecter un fournisseur. Dans le terminal, saisissez /models, recherchez parmi les fournisseurs connectés et choisissez un modèle. Favoris et choix récents permettent de le retrouver.

Le sélecteur regroupe les modèles par fournisseur. Les modèles sans sortie texte ou appel d’outils requis peuvent être masqués ou désactivés. Les modèles locaux gérés peuvent apparaître avant le téléchargement des poids ; terminez leur préparation avant utilisation.

Pour connaître les identifiants de votre CLI installé, exécutez :

ax-code models
ax-code models --json --verbose

Copiez l’identifiant complet provider/model. Un même nom affiché via deux fournisseurs peut avoir des identifiants, capacités et limites différents.

Choisir pour une exécution

Remplacez la valeur d’exemple par un identifiant affiché par votre installation. La première commande ouvre le terminal ; la seconde exécute une consigne. Placez celle-ci après --.

MODEL='provider/model'
ax-code --model "$MODEL"
ax-code run --model "$MODEL" -- "Explain the project entry point without changing files."

Les alias de famille deepseek, glm et qwen choisissent des modèles Flash compatibles via les connexions disponibles. Leur cible peut changer entre versions. Utilisez un identifiant complet pour demander une version ou une gamme précise ; une référence seule n’est pas un identifiant complet.

Enregistrer un modèle par défaut

Intégrez ce champ au fichier ax-code.json de projet ou global existant ; remplacez la valeur indicative, pas le fichier entier :

{
  "model": "provider/model"
}

Redémarrez après modification. Sans modèle explicite, les choix d’agent, de session ou récents peuvent intervenir ; vérifiez le modèle actif avant d’envoyer la tâche. Desktop gère ses propres réglages.

Choisir selon la tâche

Commencez par une petite question sur le dépôt. Pour modifier du code, vérifiez l’appel d’outils et lancez les contrôles du projet. Pour les images, vérifiez l’entrée image. Pour les tâches longues, consultez les limites de contexte et de sortie plutôt que le seul nom.

Comparez les candidats avec la même tâche, les mêmes entrées et critères d’acceptation. Considérez la latence, les conditions du fournisseur, le traitement des données et la mémoire locale. Aucun modèle ne garantit une modification correcte.

L’effort de raisonnement et le routage automatique sont distincts. Commencez par un modèle explicite avant d’activer le routage. La génération Wiki peut utiliser son propre wiki.model, indépendamment de la session au premier plan.

Si le modèle ne fonctionne pas

Absent de la liste : vérifiez que le fournisseur est connecté et activé, puis les filtres de capacités et la découverte de la passerelle. N’inventez pas un identifiant à partir d’un nom commercial.
Accès non autorisé ou interdit : vérifiez l’identifiant exact demandé et les droits du compte et de la clé. Une connexion ou une liste réussie ne prouve pas le droit d’exécution.
Erreur de préparation locale ou de mémoire : terminez le téléchargement et le chargement, puis vérifiez les exigences matérielles. Réduisez la charge ou choisissez un modèle compatible plus petit.

Étapes suivantes

Référence des fournisseurs et modèles · Récupération des modèles · Sélection AX Engine · Démarrage Wiki · Accueil de la documentation