Claude Code Advisor : configurer Sonnet + Opus et vérifier les appels

Utilisez advisor dans Claude Code pour que Sonnet assure le travail courant de programmation et qu’Opus examine les décisions difficiles. Lancez claude --model sonnet --advisor opus, puis vérifiez une entrée Advising et son résultat avant de vous fier à la revue. Le modèle choisit quand consulter ; ces appels consomment des jetons supplémentaires et peuvent cesser si une passerelle rejette l’outil.

Au 2026-11-06, la fonction advisor reste expérimentale. Les exemples supposent que la CLI est installée, que l’authentification fonctionne et qu’une requête normale aboutit directement auprès d’Anthropic. Les comptes avec abonnement et ceux avec facturation API peuvent utiliser cette voie. La compatibilité d’une passerelle doit être vérifiée séparément.

Quand choisir advisor plutôt qu’un autre modèle ?

Choisissez advisor pour une refactorisation, un bug récurrent ou une réalisation qui comporte quelques décisions difficiles. Sonnet reste chargé de la tâche. Lors d’une consultation, le second modèle examine la conversation, y compris les appels d’outils et leurs résultats.

Anthropic décrit cette répartition dans sa stratégie avec conseiller. Elle ne garantit ni des résultats du niveau d’Opus pour chaque tâche ni une économie fixe.

Votre besoin	Que choisir	Ce qui change
Des conseils ponctuels pendant l’exécution	Advisor	Claude décide quand consulter un autre modèle
Planifier avec Opus, puis réaliser avec Sonnet	`opusplan`	Le mode plan utilise Opus, sous réserve d’accès au modèle ; Sonnet assure l’exécution
Confier une recherche ou une revue distincte	Un sous-agent avec un `model` défini	Le modèle choisi exécute la tâche déléguée
Un raisonnement plus poussé pour les prochaines requêtes de la session principale	`/model`	Vous changez le modèle principal

Pour une tâche courte qui demande peu de planification, commencez sans advisor. Si presque chaque étape nécessite Opus, passez la session principale à Opus 5.5.

La commande de lancement ne crée pas trois sous-agents Haiku pour la recherche, grep et la documentation. Pour cette configuration distincte, suivez les instructions de sélection du modèle des sous-agents. L’option CLI documentée est --agents, avec du JSON. Ne la remplacez pas par la commande --subagents haiku qui circule dans certains exemples.

Activez advisor de l’une de ces trois façons

Pour votre premier essai, utilisez l’option de lancement : elle ne modifie pas votre choix de conseiller enregistré. Vérifiez d’abord la version du client dans Bash :

claude --version

Utilisez 2.1.284 ou une version ultérieure pour cet exemple avec Sonnet 5.5 et Opus 5.5. Ce minimum vient des exigences des modèles ; il ne correspond pas à la première version d’advisor. La commande documentée pour mettre la CLI à jour est claude update.

Pour une seule session : utilisez —advisor

Exécutez ceci dans Bash, depuis le répertoire du projet :

claude --model sonnet --advisor opus

Au 2026-11-06, ces alias désignent Sonnet 5.5 et Opus 5.5 dans les configurations actuelles d’accès direct à Anthropic. Leur correspondance peut changer ou être redéfinie. Pour préciser explicitement les versions :

claude --model claude-sonnet-5-5 --advisor claude-opus-5-5

L’option remplace la valeur de advisorModel pour cette session. La documentation d’advisor précise qu’il est normal de ne pas voir --advisor dans claude --help.

Pendant une session : utilisez /advisor

Saisissez ceci dans Claude Code :

/advisor opus

Vous devez voir Advisor set to, suivi du nom du modèle. La commande /advisor sans argument ouvre le sélecteur de modèles.

Dans une session de terminal locale, ce choix devient normalement votre valeur par défaut enregistrée. La référence des paramètres décrit des règles distinctes pour sa conservation dans les sessions distantes.

Pour les prochaines sessions : définissez advisorModel

Ajoutez cette propriété à vos paramètres utilisateur dans ~/.claude/settings.json :

{
  "advisorModel": "opus"
}

Conservez les autres paramètres du fichier. Cette propriété choisit le conseiller ; elle ne définit pas Sonnet comme modèle principal.

Après l’activation, recherchez ce message :

Advisor Tool (experimental) is on and may use more tokens · /advisor

Le message confirme que la fonction est activée. Il ne prouve pas qu’une consultation a eu lieu.

Quelles paires de modèles fonctionnent ?

Choisissez un conseiller que Claude Code classe au moins au niveau du modèle principal. Les exemples ci-dessous viennent du tableau actuel des paires acceptées, vérifié le 2026-11-06.

Modèle principal	Conseiller	Usage prévu
Sonnet 5.5	Opus 5.5	Réalisation courante avec une revue plus poussée
Haiku 5.5	Opus 5.5	Un modèle principal plus léger avec des consultations approfondies
Sonnet 5.5	Sonnet 5.5	Une seconde revue avec le même modèle
Opus 5.5	Opus 5.5	Une seconde revue par Opus
Opus 4.7 ou Opus 4.8	Sonnet 5.5	Une paire documentée entre familles différentes

Haiku 5.5 comme modèle principal ou conseiller exige 2.1.293 ou une version ultérieure. Sonnet 5.5 comme conseiller d’Opus 4.7 ou d’Opus 4.8 exige 2.1.287 ou une version ultérieure. Haiku 4.5 peut demander conseil, mais ne peut pas tenir le rôle de conseiller.

Ce sont des combinaisons acceptées, pas un classement garanti de qualité pour votre dépôt. La liste de modèles autorisés availableModels de votre organisation peut encore bloquer un choix. Un choix --advisor interdit ou inéligible peut interrompre le lancement interactif avec une erreur. Un conseiller moins bien classé ou un ID de modèle inconnu peut laisser la session principale fonctionner sans advisor.

Les sous-agents héritent de la configuration d’advisor et vérifient la paire avec leur propre modèle. Comptez leurs éventuelles consultations lorsque vous évaluez la consommation totale.

Comment prouver que le conseiller a été appelé ?

Utilisez le journal des appels d’outils comme preuve, puis examinez la consommation. Un message au démarrage ou l’affirmation de Claude qu’il a consulté Opus ne suffit pas.

Essayez ce prompt en lecture seule dans un dépôt que vous connaissez. Il demande d’examiner l’authentification et de proposer une petite refactorisation, sans modifier de fichiers :

Inspect this repository's authentication flow without changing files.
Propose one small refactor and identify its main regression risk.
Consult the advisor before presenting the plan.
Include the tests that would check the proposed change.

C’est une vérification suggérée, pas la garantie d’un appel. Claude choisit le moment. La planification, les erreurs récurrentes et les vérifications finales sont des occasions fréquentes, pas trois déclencheurs fixes.

Aucun paramètre d’advisor dans Claude Code ne permet de forcer les appels ou d’en plafonner le nombre. Des instructions dans un prompt ou dans CLAUDE.md peuvent demander plus de consultations, mais ne rendent pas la revue obligatoire.

Recherchez Advising avec le nom du modèle conseiller. Interprétez ensuite le résultat :

Résultat	Ce qu’il établit	Étape suivante
Reviewed	Le conseiller a examiné la conversation	Appuyez sur `Ctrl+O` si des conseils lisibles ont été renvoyés ; examinez le plan obtenu
Declined	L’appel a eu lieu, mais le conseiller a refusé de donner un avis	Lisez le motif, s’il est disponible, et reconsidérez la demande
Unavailable	L’appel a échoué	Examinez `Advisor unavailable (<error_code>)` et recherchez la cause de cet échec
Aucune entrée `Advising`	Aucune consultation observée	Demandez-en une explicitement ; si rien n’apparaît, vérifiez l’activation et le routage

Exécutez /usage après cette vérification. La consommation du conseiller entre dans les totaux de la session, mais une hausse seule ne démontre pas une revue réussie. Consultez aussi le résultat dans le journal.

Combien coûte une consultation du conseiller ?

Prévoyez le coût de lecture de la conversation par un autre modèle. Les jetons du conseiller s’ajoutent à la consommation du modèle principal.

Avec la facturation API, l’entrée et la sortie du conseiller suivent les tarifs de son modèle. Avec un abonnement, l’activité du conseiller dans ce scénario Sonnet/Opus compte dans les limites d’utilisation du forfait. Il n’offre pas un quota distinct de revues illimitées.

Au 2026-11-06, les tarifs standard d’Anthropic pour Opus 5.5 sont de $4 par million de jetons d’entrée et de $20 par million de jetons de sortie.

Voici une estimation hypothétique limitée au conseiller. Elle suppose une facturation directe par Anthropic API et les tarifs mondiaux standard. Elle compte 50,000 jetons d’entrée sans cache et 2,000 jetons de sortie facturés. La sortie facturée comprend les jetons de raisonnement.

Advisor token cost
= (50,000 × $4 + 2,000 × $20) / 1,000,000
= $0.24

Ce n’est pas un forfait par consultation. Ce calcul exclut le travail du modèle principal et ne mesure pas la part du quota d’abonnement consommée. Un historique plus volumineux ou une réponse plus longue du conseiller augmente l’estimation.

La documentation de Claude Code indique que chaque consultation relit tout l’historique sans réutiliser de cache propre au conseiller. Activer ou désactiver /advisor préserve le cache de prompt du modèle principal. Les conseils reçus peuvent entrer dans ce cache lors des tours suivants.

Cette description concerne Claude Code. La documentation des appels directs à l’API Messages propose désormais une option caching distincte pour le conseiller. Elle ne fait pas partie de la configuration de ce parcours dans la CLI.

Avant d’adopter la paire, comparez le coût total pour une même tâche terminée. Gardez les mêmes critères de validation et comptez les nouvelles tentatives ainsi que les échecs. Pour les sessions riches en contexte, mesurez le contexte ajouté par MCP avant d’attribuer toute hausse à advisor.

Le montant en dollars affiché par /usage reste une estimation. Vérifiez les sommes facturées dans le relevé du fournisseur.

Corrigez les erreurs 400 et les désactivations silencieuses via une passerelle

Choisissez la correction selon la cause. Une fonction non activée, une paire de modèles refusée et un outil serveur non pris en charge demandent des démarches différentes.

Aucun message au démarrage ni activité du conseiller

Vérifiez les variables d’environnement et la section env des paramètres avant de changer de modèle. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 désactive entièrement la fonction.

Vérifiez aussi DISABLE_TELEMETRY et CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Ces variables peuvent désactiver le mécanisme de feature flags nécessaire à advisor. Consultez leurs effets documentés, notamment les conditions liées à la première session et aux identifiants utilisés avec une passerelle.

Si l’organisation a choisi ces paramètres délibérément, utilisez une configuration approuvée ou une autre méthode de revue. Si un paramètre local facultatif a causé le problème, supprimez-le à l’endroit où il est défini et relancez le client. Répétez le prompt de vérification et examinez le journal. Changer une variable d’environnement ne suffit pas à prouver que la fonction marche.

La session fonctionne, mais la paire de modèles a été refusée

Vérifiez les ID effectivement utilisés pour les deux modèles et availableModels. Un conseiller enregistré peut rester inactif si le modèle principal est incompatible.

Si l’API rejette une paire jointe à la requête, Claude Code réessaie sans advisor. La conversation peut continuer sans erreur visible. Sélectionnez un conseiller accepté, puis utilisez /clear, /compact ou une nouvelle session avant de vérifier à nouveau.

Conservez le contexte utile à la tâche avant d’effacer la conversation. Cette procédure concerne le refus d’une paire, pas tous les refus d’une passerelle.

Le message Input tag ‘advisor_20260301’ apparaît

Une erreur 400 ou 422 contenant Input tag 'advisor_20260301' indique que la passerelle ou le service en amont a rejeté le type d’outil advisor.

À partir de 2.1.280, Claude Code reconnaît ce refus et réessaie une fois sans l’entrée advisor ni sa valeur bêta. La session peut reprendre la programmation alors que le conseiller reste absent.

Le guide de compatibilité des passerelles précise la durée de cet état. Les requêtes vers la même URL de base omettent advisor jusqu’à la fermeture de Claude Code. La commande /advisor est indisponible pendant ce temps. Après avoir corrigé le routage, quittez complètement Claude Code et relancez-le. /clear seul n’est pas la méthode documentée pour réinitialiser cet état.

Si votre client est ancien, commencez par le mettre à jour. Si l’erreur persiste avec un client à jour, demandez à l’opérateur de la passerelle de vérifier la définition de l’outil :

L’entrée de tools de type advisor_20260301 atteint un service Anthropic qui la prend en charge.
La valeur associée de anthropic-beta, advisor-tool-2026-03-01, accompagne cette entrée.
Le corps des erreurs renvoyées par le service en amont conserve le texte que Claude Code utilise pour reconnaître le refus.

Si retirer l’outil et son en-tête permet aux requêtes normales d’aboutir, cela démontre un repli sans advisor. Cela ne confirme pas la compatibilité avec advisor.

Au 2026-11-06, BetterToken répertorie claude-sonnet-5-5 et claude-opus-5-5. Sa configuration pour Claude Code utilise https://bettertoken.ai comme ANTHROPIC_BASE_URL, sans /v1. La disponibilité des modèles ne confirme pas la prise en charge d’advisor. Obtenez une confirmation pour le routage utilisé et vérifiez une consultation réelle.

Si les requêtes Messages normales échouent aussi, isolez d’abord le problème de connexion avec le guide de requête minimale à Claude API. Répétez ensuite la vérification propre à advisor.

Désactivez advisor

Pour arrêter les consultations, utilisez la commande dans la session :

/advisor off

Pour une désactivation complète, définissez cette variable dans Bash avant le lancement :

export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1
claude

Avec cette variable définie, /advisor devient indisponible et Claude Code ignore advisorModel. Il accepte --advisor, mais l’option reste sans effet.