Ce que c'est et pourquoi ça compte
Vous utilisez Opus pour tout et, en milieu de semaine, la limite de votre forfait est atteinte. Pourtant, presque toute une session est de la routine : lire des fichiers, changer deux lignes, lancer les tests. Opus ne sert qu'à quelques moments : quand vous choisissez l'approche, quand une erreur revient sans cesse, avant de dire que c'est fini.
C'est ce que fait l'advisor. Vous travaillez avec un modèle plus léger, par exemple Sonnet, et vous choisissez un modèle plus fort comme conseiller. Aux moments clés, Claude le consulte : l'advisor lit toute la conversation, appels d'outils compris, et lui donne un conseil avant qu'il continue. C'est Claude qui décide quand l'appeler.
C'est pour les longues sessions : un gros refactoring (réécrire le code sans changer ce qu'il fait), un bug qui revient, un travail à revérifier avant de le clore. Sur les tâches courtes, il apporte peu. Et il est expérimental : comportement, tarifs et disponibilité peuvent changer.
1. Ce qu'il vous faut, et où ça ne marche pas
S'il manque l'une de ces trois choses, l'advisor reste éteint :
- L'API d'Anthropic, directement ou via un abonnement. Il n'existe pas sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ni Microsoft Foundry.
- Un modèle principal récent : Fable, Opus, Sonnet ou Haiku. Et Claude Code à jour.
- Les feature flags, les interrupteurs que Claude Code télécharge depuis Anthropic : avec DISABLE_TELEMETRY ou une variable du même genre, l'advisor ne s'allume pas.
Pour le supprimer complètement, il y a CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 : la commande /advisor disparaît et advisorModel est ignoré.
2. Les trois façons de l'activer
Quand il est actif, au démarrage de la session vous voyez l'avis Advisor Tool (experimental) is on and may use more tokens.
Façon 1 : la commande /advisor
Tapez /advisor tout seul et un menu s'ouvre avec les modèles qui peuvent servir de conseiller et l'option No advisor. Ou tapez directement le modèle :
/advisor opus
Il répond Advisor set to et le nom du modèle, et enregistre votre choix dans advisorModel de vos réglages utilisateur : il vaut aussi pour les sessions suivantes. Pour l'éteindre :
/advisor off
Façon 2 : advisorModel dans les réglages
Pour l'avoir par défaut sans ouvrir de session, écrivez-le dans ~/.claude/settings.json. Si le fichier contient déjà d'autres réglages, ajoutez seulement la ligne, avec la virgule :
{
"advisorModel": "opus"
}Façon 3 : le flag --advisor, pour une seule session
Pour l'essayer sans toucher à votre réglage par défaut, lancez Claude Code ainsi. Cela ne vaut que pour cette session et passe avant advisorModel. Si le modèle principal ne prend pas en charge l'advisor, ou si le modèle demandé ne peut pas servir de conseiller, il s'arrête aussitôt avec une erreur.
claude --advisor opus
3. Les six paires de modèles, et quand les utiliser
La règle : l'advisor doit être au même niveau que le modèle principal ou au-dessus. Par exemple, avec la dernière version d'Opus comme modèle principal, seuls Fable ou un Opus de la même génération conviennent. Si vous choisissez un advisor plus faible, Claude Code ne l'utilise pas et vous le signale par un avis.
Les six paires de la documentation officielle :
- Sonnet + Opus comme advisor : la paire par laquelle commencer. Sonnet fait le travail de routine et confie à Opus la planification, les échecs peu clairs et la vérification finale.
- Sonnet + Fable comme advisor : les conseils de Fable aux moments de décision, sans faire tourner Fable toute la session. Nécessite l'accès à Fable.
- Haiku + Opus comme advisor : le modèle principal le moins cher avec une planification solide. Ça coûte plus que Haiku seul, mais moins que de passer à Sonnet ou à Opus.
- Opus + Opus comme advisor : un second Opus vérifie le premier. Pour les travaux à fort enjeu, où un contrôle indépendant compte plus que le coût.
- Fable + Fable comme advisor : la paire la plus puissante. Nécessite l'accès à Fable, et avec Fable comme modèle principal Claude Code n'applique pas d'advisor Opus ou Sonnet.
- Sonnet + Sonnet comme advisor : un second avis peu coûteux, pour les oublis de routine.
Pour Fable, regardez /model : avec l'API d'Anthropic, il y est, sauf si votre organisation l'exclut. Sur certains forfaits, Fable est facturé sur les crédits d'usage, comme advisor aussi, et vous acceptez d'abord une fois le consentement avec /model fable. Mais Fable devient alors votre modèle principal : revenez au vôtre avec /model sonnet, puis tapez /advisor fable.
4. Quand il l'appelle et ce que vous voyez
Claude le consulte en général avant de choisir une approche, quand une erreur revient et avant de dire qu'il a fini. Aucun réglage ne permet de le limiter ou de le forcer : si vous le voulez plus ou moins souvent, dites-le dans le prompt.
Pendant la consultation, vous voyez une ligne Advising avec le nom du conseiller. Ensuite, la ligne vous dit comment ça s'est passé :
- Reviewed : l'advisor a lu la conversation. S'il y a un conseil lisible, ouvrez-le avec Ctrl+O.
- Declined : l'advisor n'a pas voulu donner de conseil. La raison, s'il y en a une, se lit avec Ctrl+O.
- Unavailable : l'appel a échoué, et la ligne affiche le code d'erreur.
Claude suit le conseil, mais pas aveuglément : si une étape recommandée échoue ou si les fichiers disent le contraire, il vous montre le conflit.
5. Ce qu'il coûte vraiment
Chaque appel fait lire toute la conversation à l'advisor, aux tarifs du modèle conseiller et en plus du modèle principal. Avec l'API, vous payez ces tokens ; avec un abonnement, ils comptent dans les limites d'usage du forfait, sauf Fable sur les forfaits où il passe sur les crédits d'usage. En général, ça coûte moins que de faire tourner le modèle fort toute la session, mais plus que le modèle léger seul. Vous le voyez dans /usage.
L'activer ou l'éteindre en cours de session ne jette pas le cache du modèle principal, la partie de la conversation déjà mémorisée qui rend les requêtes suivantes moins chères. Changer de modèle avec /model, si.
Les chiffres d'Anthropic, mesurés via l'API et non dans Claude Code (The advisor strategy, 9 avril 2026, claude.com/blog/the-advisor-strategy) :
- Sonnet avec un advisor Opus : 2,7 points de plus sur SWE-bench Multilingual, un test de programmation, et un coût par tâche inférieur de 11,9 % à Sonnet seul.
- Haiku avec un advisor Opus sur BrowseComp, un test de recherche sur le web : 41,2 %, contre 19,7 % seul.
- Haiku avec Opus reste 29 % derrière Sonnet seul en score, mais coûte 85 % de moins par tâche.
6. Les prompts à copier
Dans le chat de Claude Code, avec l'advisor activé. Remplacez les parties entre [ ] par les vôtres.
Avant de choisir l'approche
Avant d'écrire du code, consulte l'advisor sur le plan. Je veux [ajouter la connexion avec Google] : propose deux approches, demande à l'advisor laquelle tient le mieux et dis-moi ce qu'il t'a conseillé.
Quand une erreur revient sans cesse
Cette erreur est revenue trois fois : [colle l'erreur]. Avant une autre correction, consulte l'advisor et dis-moi quelle est selon lui la vraie cause.
Le plan de session pour un long refactoring
Refactoring de [src/api] sans changer ce que fait le code. 1. Lis le code, écris le plan dans PLAN.md et consulte l'advisor sur le plan. 2. Un fichier à la fois, avec les tests après chacun. 3. Si un test échoue deux fois pour la même raison, arrête-toi et consulte l'advisor. 4. Pas d'advisor pour les modifications de routine. 5. Avant de dire que tu as fini, consulte l'advisor pour la vérification finale et dis-moi ce qu'il a trouvé.
Les erreurs les plus courantes
- L'activer pour un travail de dix minutes : /model suffit.
- Donner le consentement avec /model fable et rester sur Fable sans le vouloir.
Check-list
- Au démarrage, je vois l'avis Advisor Tool (experimental) is on
- Mon advisor est au même niveau que mon modèle principal ou au-dessus
- J'ai vu une ligne Advising et lu le conseil avec Ctrl+O
- Après la session, j'ai regardé dans /usage combien l'advisor a consommé
Questions fréquentes
Quelle différence entre l'advisor et opusplan ?
opusplan utilise Opus en plan mode, puis passe à Sonnet. L'advisor intervient en cours de travail, quand Claude le décide.
Et avec un subagent ou avec /model ?
Le subagent utilise son modèle pour toute la tâche que vous lui confiez ; /model change le modèle pour tout. L'advisor n'intervient qu'aux moments de décision.