L’outil advisor est expérimental et nécessite Claude Code v2.1.98 ou ultérieur avec l’API Anthropic. Il n’est pas disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. Le comportement, la tarification et la disponibilité peuvent changer.
Quand utiliser l’advisor
L’advisor convient aux tâches longues et multi-étapes où la plupart des tours sont routiniers mais la qualité du plan détermine le résultat. Les exemples incluent les grandes refactorisations, les sessions de débogage où une erreur se reproduit constamment, et les tâches que vous voulez vérifier indépendamment avant que Claude les déclare terminées.
Il ajoute moins de valeur sur les tâches courtes où il y a peu à planifier, ou sur le travail où chaque tour a besoin du modèle le plus puissant. Pour ceux-ci, changez le modèle principal à la place, ou consultez comment l’advisor se compare avec opusplan et les sous-agents pour d’autres façons d’obtenir un deuxième avis.
Activer l’advisor
Vous pouvez définir le modèle advisor de trois façons :
- Commande
/advisor : définir ou modifier l’advisor en milieu de session et l’enregistrer comme valeur par défaut
- Paramètre
advisorModel : configurer une valeur par défaut persistante dans votre fichier de paramètres
- Drapeau
--advisor : définir l’advisor pour une seule session au lancement
Si l’une de ces options définit un modèle advisor, l’advisor est activé pour les sessions dont le modèle principal le supporte. Pour arrêter de l’utiliser, consultez Désactiver l’advisor.
Pour utiliser Fable 5 comme advisor, vous avez besoin de Claude Code v2.1.170 ou ultérieur et de l’accès à Fable 5 pour votre organisation. Utiliser la commande /advisor
Exécutez /advisor sans arguments pour ouvrir un sélecteur listant les modèles advisor disponibles, ou passez le modèle directement :
Votre sélection est enregistrée dans advisorModel dans vos paramètres utilisateur et persiste entre les sessions. Si votre modèle principal actuel ne supporte pas l’advisor, la sélection est toujours enregistrée et s’active lorsque vous basculez vers un modèle principal compatible avec /model.
Définir advisorModel dans les paramètres
Pour configurer l’advisor comme valeur par défaut sans ouvrir une session, définissez-le dans votre fichier de paramètres :
{
"advisorModel": "opus"
}
Utiliser le drapeau --advisor
Pour définir l’advisor pour une seule session sans modifier votre paramètre enregistré, lancez avec le drapeau :
Le drapeau a la priorité sur le paramètre advisorModel pour cette session. Contrairement à /advisor, qui enregistre une sélection inactive, le drapeau se termine avec une erreur si le modèle principal de la session ne supporte pas l’advisor.
Choisir un modèle advisor
L’advisor doit être au moins aussi capable que le modèle principal. Les advisors acceptés pour chaque modèle principal sont :
| Modèle principal | Advisors acceptés | Notes |
|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku peut appeler l’advisor mais ne peut pas en être un |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Opus 4.6 ou ultérieur | Fable, Opus à la version du modèle principal ou ultérieure | Un Opus 4.7 principal avec un advisor Opus 4.6 est rejeté |
| Fable 5 (v2.1.170+) | Fable | Un advisor Opus ou Sonnet est rejeté |
opus, sonnet, ou fable. Ces alias se résolvent à la dernière version de chaque modèle. Vous pouvez également passer un ID de modèle complet tel que claude-opus-4-8.
Les sous-agents héritent de l’advisor configuré et appliquent la même vérification d’appairage par rapport à leur propre modèle.
Claude Code valide l’appairage avant d’envoyer une requête :
- Si l’advisor est moins capable que le modèle principal, l’advisor n’est pas attaché aux requêtes du modèle principal. La sortie de la commande
/advisor et une notification le montrent. Les sous-agents dont le modèle propre satisfait l’appairage peuvent toujours utiliser l’advisor.
- Si le modèle principal ou l’advisor est un modèle que Claude Code ne reconnaît pas, l’advisor n’est pas attaché.
Appairages de modèles courants
Tout appairage accepté fonctionne. Ces combinaisons équilibrent le coût par rapport à la capacité de différentes façons :
| Appairage | Quand l’utiliser |
|---|
| Sonnet principal + advisor Opus | Sonnet gère le travail routinier et escalade la planification, les défaillances ambiguës et les vérifications d’achèvement à Opus |
| Sonnet principal + advisor Fable | Conseils Fable 5 aux points de décision sans exécuter Fable 5 partout. Nécessite v2.1.170 ou ultérieur et l’accès à Fable 5 |
| Haiku principal + advisor Opus | Modèle principal au coût le plus bas avec une planification puissante. Attendez-vous à un coût plus élevé que Haiku seul mais inférieur au basculement du modèle principal vers Sonnet ou Opus |
| Opus principal + advisor Opus | Un deuxième Opus examine le premier. Utile pour les tâches à enjeux élevés où une vérification indépendante importe plus que le coût |
| Fable principal + advisor Fable | Appairage de plus haute capacité lorsque Fable 5 est disponible (v2.1.170+). Fable est un niveau supérieur à Opus et Sonnet, donc c’est le seul advisor accepté pour un modèle principal Fable |
| Sonnet principal + advisor Sonnet | Un deuxième avis à coût inférieur pour attraper les oublis routiniers |
Quand Claude consulte l’advisor
Claude décide quand appeler l’advisor. Il tend à consulter avant de s’engager dans une approche, lorsqu’une erreur se reproduit constamment, et avant de déclarer une tâche terminée, mais le timing est piloté par le modèle plutôt que basé sur des règles.
Vous pouvez demander une consultation dans votre invite de la même façon que vous demanderiez n’importe quel outil, par exemple consulter l'advisor avant de continuer. Il n’y a pas de paramètre pour limiter ou forcer les appels advisor ; si vous voulez que Claude consulte plus ou moins souvent pendant une tâche, dites-le dans vos instructions.
Ce que vous voyez pendant une session
Quand Claude appelle l’advisor, la transcription affiche une ligne Advising avec le nom du modèle advisor pendant que l’appel est en cours. Quand le résultat revient, la ligne confirme que l’advisor a examiné la conversation. Appuyez sur Ctrl+O pour l’agrandir et lire les conseils complets de l’advisor.
Claude suit généralement les conseils de l’advisor, mais s’adapte lorsque ses propres preuves contredisent une affirmation spécifique : si une étape recommandée échoue lorsqu’elle est essayée, ou si le contenu du fichier contredit le conseil, Claude met en évidence le conflit plutôt que de suivre le conseil inconditionnellement.
L’advisor reçoit toujours la conversation complète, et Claude contrôle le timing. Pour plus de contrôle ou une configuration différente, consultez comment l’advisor se compare avec les sous-agents et opusplan.
Coût
Chaque appel advisor envoie la conversation au modèle advisor, donc il consomme des tokens aux tarifs du modèle advisor en plus de l’utilisation de votre modèle principal. Avec la facturation API, les tokens advisor sont facturés aux tarifs d’entrée et de sortie du modèle advisor. Sur les plans d’abonnement, l’utilisation de l’advisor compte vers les limites d’utilisation de votre plan.
Claude appelle l’advisor aux points de décision plutôt que sur chaque tour, donc associer un modèle principal plus rapide avec un advisor plus puissant coûte généralement moins cher que d’exécuter le modèle plus puissant partout. L’utilisation de l’advisor compte vers les totaux de session affichés par /usage.
Pour savoir comment les tokens advisor sont signalés dans les réponses API, consultez Utilisation et facturation dans la documentation de l’API Claude.
Impact sur la mise en cache des invites
Activer ou désactiver l’advisor en milieu de session n’invalide pas le cache d’invite de votre modèle principal. Contrairement au changement de modèle ou de niveau d’effort, basculer /advisor garde le préfixe en cache intact, et les conseils retournés par l’advisor sont mis en cache dans la transcription sur les tours ultérieurs.
La propre lecture de la conversation par le modèle advisor n’est pas mise en cache. Chaque appel advisor traite la transcription complète à nouveau, sans réutilisation entre les appels.
Exigences
L’outil advisor nécessite tous les éléments suivants :
- Claude Code v2.1.98 ou ultérieur : exécutez
claude update pour mettre à niveau.
- API Anthropic uniquement : l’advisor est un outil exécuté par le serveur. Il n’est pas disponible sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. Via une passerelle LLM configurée avec
ANTHROPIC_BASE_URL, la disponibilité dépend de si la passerelle transfère la requête intacte à l’API Anthropic.
- Modèle principal supporté : Opus 4.6 ou ultérieur, Sonnet 4.6, ou Haiku 4.5. Fable 5 se qualifie également sur Claude Code v2.1.170 ou ultérieur.
Désactiver l’advisor
Pour arrêter d’utiliser l’advisor et effacer votre advisorModel enregistré, exécutez /advisor off ou choisissez No advisor dans le sélecteur /advisor :
Pour désactiver complètement l’outil advisor, y compris la commande /advisor et le drapeau --advisor, définissez CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. Consultez Variables d’environnement.
L’advisor est l’une de plusieurs façons de combiner les forces des modèles. Choisissez en fonction de quand vous voulez qu’un deuxième modèle soit impliqué.
| Approche | Quand le modèle plus puissant s’exécute | Comment il démarre |
|---|
| Outil advisor | Aux points de décision en milieu de tâche | Claude l’appelle quand il a besoin de conseils |
opusplan | Pendant le mode plan, puis bascule vers Sonnet pour l’exécution | Vous entrez en mode plan |
Sous-agents avec model défini | Pour l’ensemble de la sous-tâche déléguée | Claude délègue, ou vous invoquez le sous-agent |
/model | Pour tous les tours ultérieurs | Vous changez de modèle |
Voir aussi
