Qu'est-ce qu'opusplan dans Claude Code ? Opus pour planifier, Sonnet pour implémenter : réglage et points de vigilance

Vous voulez confier uniquement la planification à un modèle intelligent, et laisser l'écriture du code à un modèle plus rapide et moins cher. Claude Code possède un réglage qui le fait automatiquement : opusplan.

La réponse courte : opusplan est un réglage de modèle qui tourne sur Opus pendant le mode planification et sur Sonnet le reste du temps. Il suffit de taper /model opusplan ou de l'écrire dans le champ model de settings.json. En revanche, il n'apparaît pas dans la liste de /model : si vous ne connaissez pas son nom, vous ne le trouverez pas. Et comme le modèle change chaque fois que vous entrez en mode planification ou en sortez, gardez à l'esprit que chaque bascule relit toute la conversation sans le cache.

En s'appuyant sur la documentation officielle, le journal des modifications de Claude Code (CHANGELOG) et les issues GitHub au 15 septembre 2026, cet article fait le point sur la configuration, le déroulement d'une session, les raisons de son absence dans la liste, les précautions liées aux tarifs et au cache, et les différences avec des mécanismes similaires (l'outil advisor et les sous-agents).

1. Ce qu'est opusplan : Opus uniquement en mode planification

opusplan est un alias de modèle que l'on peut passer à /model, au même titre que sonnet ou opus. La documentation officielle le décrit comme un mode spécial qui utilise opus en mode planification, puis bascule sur sonnet pour l'exécution.

Le seul critère de bascule est le fait d'être ou non en mode planification. Le mode planification est l'état dans lequel Claude lit des fichiers et lance des commandes pour enquêter, rédige un plan et ne modifie pas vos sources tant que vous ne l'avez pas approuvé (la vue d'ensemble des modes d'autorisation est traitée dans Modes d'autorisation de Claude Code : les 5 modes expliqués).

Source : documentation officielle Claude Code, « Model configuration » (au 15 septembre 2026). La cible dépend du fournisseur : sur Amazon Bedrock et l'Agent Platform de Google Cloud, par exemple, sonnet correspond à Sonnet 4.5

Il existe un autre mécanisme similaire. Une session qui tourne sur Haiku passe automatiquement à Sonnet, mais seulement pendant le mode planification (introduit dans la v2.0.17 en même temps que Haiku 4.5 ; à son lancement, ce passage automatique ne se faisait pas sur Amazon Bedrock ni sur Google Vertex AI). Celui-ci fonctionne sans aucun réglage.

2. Comment le configurer

On l'indique de la même façon que n'importe quel autre modèle. Voici les méthodes, dans l'ordre de priorité décroissant donné par la documentation officielle.

Taper /model opusplan ne se contente pas de changer la session en cours : la valeur est écrite dans le model de vos paramètres utilisateur et devient aussi la valeur par défaut des nouvelles sessions. Pour l'essayer le temps d'une seule session, lancez Claude Code avec claude --model opusplan.

{
  "model": "opusplan"
}

Trois autres réglages sont utiles à connaître.

• Figer les versions des modèles : l'Opus qu'opusplan utilise en mode planification est déterminé par ANTHROPIC_DEFAULT_OPUS_MODEL, et le Sonnet utilisé le reste du temps par ANTHROPIC_DEFAULT_SONNET_MODEL. Sur Amazon Bedrock et les fournisseurs similaires, indiquez-y les identifiants de modèle de votre fournisseur
• Utiliser un contexte de 1M tokens : sur les forfaits où Opus passe automatiquement à 1M, comme Max, Team et Enterprise, le côté Opus d'opusplan passe lui aussi à 1M. Sinon, pour avoir 1M des deux côtés, indiquez opusplan[1m]. Le choisir avec /model opusplan[1m] nécessite la v2.1.265 ou une version ultérieure ; avant, passez par --model ou par le fichier de paramètres
• Inutilisable dans la variable d'environnement du modèle par défaut : mettre opusplan dans ANTHROPIC_DEFAULT_MODEL, qui fixe la valeur par défaut des nouvelles sessions, est ignoré. Pour en faire votre valeur par défaut, tapez /model opusplan ou écrivez-le dans le model de settings.json

Source : documentation officielle Claude Code, « Model configuration » (Setting your model, Environment variables, Extended context, opusplan model setting), « Settings reference » (model)

3. Le déroulement d'une session

Indiquer opusplan ne suffit pas : vous restez sur Sonnet. Il ne passe sur Opus que lorsque vous entrez vous-même en mode planification.

1. Entrer en mode planification : dans le terminal, basculez avec Shift+Tab ou commencez votre demande par /plan. Pour démarrer directement dans ce mode, utilisez claude --permission-mode plan. Dans l'application desktop, choisissez-le dans le sélecteur de mode d'autorisation (mode selector)
2. Opus rédige le plan : il lit des fichiers et lance des commandes pour enquêter, puis rassemble un plan sans rien modifier. Vous pouvez aussi appuyer sur Ctrl+G pour ouvrir le plan dans votre éditeur et le réécrire directement
3. Approuver le plan : choisissez entre continuer en mode automatique (« Yes, and use auto mode »), approuver les modifications une par une (« Yes, manually approve edits ») ou continuer à planifier (« No, keep planning ») ; quand le mode automatique n'est pas disponible, la première option devient l'acceptation automatique des modifications (« Yes, auto-accept edits »). L'approbation fait sortir du mode planification, et c'est Sonnet qui implémente à partir de là
4. Pour planifier à nouveau : revenez en mode planification avec Shift+Tab, ou commencez votre demande suivante par /plan. Pendant ce temps, c'est de nouveau Opus

Si vous réglez le paramètre showClearContextOnPlanAccept sur true, une option pour approuver en effaçant le contexte (« Yes, clear context and … », la suite indiquant le mode d'autorisation) s'ajoute en tête des choix d'approbation. Elle abandonne notamment le contenu des fichiers lus pendant la planification et démarre l'implémentation avec le plan seul (la valeur par défaut est false). Comme l'explique la section 5, avec opusplan, cela compte aussi pour le coût.

Source : documentation officielle Claude Code, « Choose a permission mode » (Analyze before you edit with plan mode, Review and approve a plan), « Settings reference » (showClearContextOnPlanAccept), « Desktop » (choix du mode d'autorisation)

Ne demandez pas au modèle sur quel modèle il tourne. Dans une discussion GitHub de septembre 2025, un membre de l'équipe d'Anthropic a écrit qu'au lieu de demander au modèle ce qu'il est, il faut vérifier ce qu'affiche l'application. Les moyens de le vérifier sont réunis dans la question Q3 de la FAQ.

4. Pourquoi il n'apparaît pas dans la liste de /model

opusplan n'est pas une nouveauté. S'il n'apparaît pas dans la liste, c'est qu'il a été retiré de l'interface à un moment donné. En remontant le CHANGELOG et les issues GitHub, on obtient la chronologie suivante.

Source : Claude Code CHANGELOG, issue GitHub #8358, #26556, #27237 (toutes consultées le 15 septembre 2026)

🟡 Anthropic n'a pas expliqué à nouveau pourquoi il n'apparaît pas dans la liste aujourd'hui. L'explication de septembre 2025 comparait Sonnet 4.5 et Opus 4.1, tels qu'ils étaient alors. On ne sait pas si le même jugement vaut toujours pour le duo Opus 5 et Sonnet 5. En revanche, la documentation officielle contient toujours une section sur opusplan, et le CHANGELOG mentionne des corrections faites en 2026 : il reste donc utilisable en tant que réglage.

Certains signalements, comme l'issue #27237, font aussi état de versions choisies différentes de ce qui était attendu. Toutefois, l'identifiant de modèle cité dans ce signalement est au format de Google Cloud, et la documentation officielle actuelle fait elle aussi correspondre sonnet à Sonnet 4.5 sur Google Cloud : il se peut donc que le comportement ait été conforme à la spécification (c'est mon interprétation). Si cela vous préoccupe, figez les versions avec les deux variables d'environnement ci-dessus et vérifiez quel modèle a réellement tourné.

5. Tarifs et cache : chaque bascule entraîne une relecture complète

La plupart du temps, on utilise opusplan pour réduire la consommation ou le coût. Confier l'implémentation à Sonnet fait baisser le prix par token.

Source : Claude Platform Docs, « Pricing » (par million de tokens, au 15 septembre 2026)

Mais il y a un coût facile à négliger. Le cache de prompt est distinct pour chaque modèle, et la documentation officielle précise qu'avec opusplan, entrer en mode planification ou en sortir est un changement de modèle qui oblige à reconstruire le cache à chaque fois. Autrement dit, la première réponse de Sonnet juste après la sortie du mode planification, et la première réponse d'Opus juste après y être revenu, lisent toute la conversation jusque-là sans le cache.

Pour en donner un ordre de grandeur, j'ai estimé le coût d'une bascule effectuée alors que la conversation atteint 100 000 tokens. Avec un abonnement, dans les limites de votre forfait, le cache de la conversation principale dure 1 heure : les écritures sont donc comptées au tarif de 1 heure. Notez qu'avec une clé API ou via un fournisseur cloud, vous pouvez aussi passer le cache de la conversation principale à 1 heure en réglant promptCacheTtl sur 1h (v2.1.242 et versions ultérieures) et, à l'inverse, qu'avec un abonnement le cache retombe à 5 minutes tant que vous payez avec des crédits d'utilisation supplémentaires (usage credits) au-delà de votre forfait.

Source : mon estimation à partir des tarifs officiels (100 000 tokens × tarif). 🟡 Rien n'indique officiellement que les limites d'un abonnement diminuent dans la même proportion que ces montants. Durée de vie du cache : documentation officielle Claude Code, « How Claude Code uses prompt caching »

Si vous continuiez à lire ces mêmes 100 000 tokens sur Opus, chaque lecture en cache coûterait environ 0,05 $. Si vous entrez en mode planification et en sortez à de nombreuses reprises alors que les échanges d'implémentation restent courts, les écritures dues aux bascules peuvent finir par coûter plus cher. Voici trois façons de limiter les frais.

• Planifier tôt dans la conversation : en basculant tant que le contexte est encore petit, la quantité à réécrire reste petite elle aussi
• Effacer le contexte au moment d'approuver : activez showClearContextOnPlanAccept et choisissez l'option qui efface le contexte ; Sonnet démarre alors avec le plan seul et relit moins
• Ne pas faire d'allers-retours fréquents entre planification et implémentation : chaque retour en mode planification provoque aussi une relecture côté Opus

Un mot aussi sur les limites des abonnements. La limite de session et la limite hebdomadaire sont communes à tous les modèles, et il existe à côté des limites par famille de modèles, comme la « limite Opus » et la « limite Sonnet ». Comme opusplan utilise Opus en mode planification, une fois la limite Opus atteinte, vous ne pouvez plus utiliser Opus en mode planification. La page des tarifs indique qu'Opus est disponible même avec le forfait Pro, mais selon la documentation officielle, utiliser Opus avec un contexte de 1M sur Pro nécessite des crédits d'utilisation supplémentaires (usage credits).

Source : documentation officielle Claude Code, « How Claude Code uses prompt caching » (Switching models, Changing permission mode, Which TTL each request gets), « Error reference » (limites communes à tous les modèles et limites par famille de modèles), « Model configuration » (Extended context), page des tarifs de Claude (modèles par forfait)

6. Les différences avec l'outil advisor et les sous-agents

opusplan n'est pas la seule façon de combiner un modèle puissant et un modèle rapide. La documentation officielle compare les options selon le moment où le modèle puissant intervient.

Source : documentation officielle Claude Code, « Escalate hard decisions with the advisor tool » (Compare with related features)

L'outil advisor garde la session principale sur un modèle rapide, tandis que Claude consulte un modèle plus puissant en cours de travail. Contrairement à opusplan, l'activer ou le désactiver ne casse pas le cache de la session principale. En revanche, à chaque consultation, l'advisor lit toute la conversation, et cette lecture n'est pas mise en cache. Au 15 septembre 2026, c'est une fonctionnalité expérimentale, disponible uniquement sur l'Anthropic API (pas sur Amazon Bedrock ni les fournisseurs similaires).

Les sous-agents permettent de faire tourner uniquement le travail confié sur un autre modèle. La configuration et les mesures sont traitées dans Claude Code : exécuter les sous-agents sur un autre modèle.

Source : documentation officielle Claude Code, « Escalate hard decisions with the advisor tool » (Cost, Impact on prompt caching, Requirements)

7. Les usages qui s'y prêtent et ceux qui ne s'y prêtent pas

À partir du fonctionnement décrit jusqu'ici, voici les éléments pour décider (il ne s'agit pas d'une recommandation officielle, mais de ma propre synthèse tirée du fonctionnement).

En cas de doute, le plus sûr est de faire une fois le même type de tâche avec opusplan et une fois avec votre modèle habituel, puis de comparer les chiffres de /usage et le résultat. La façon d'examiner en détail la consommation session par session est présentée dans Claude Code : mesurer la consommation par session.

FAQ

Q1. J'ai ouvert /model, mais je ne trouve pas opusplan.
Il n'apparaît pas dans la liste, et c'est voulu (au 15 septembre 2026). Indiquez-le en tapant son nom : /model opusplan. Tapé de cette façon, il est aussi enregistré comme valeur par défaut des nouvelles sessions. Pour ne l'utiliser que cette fois, lancez Claude Code avec claude --model opusplan.

Q2. J'ai choisi opusplan, mais je reste sur Sonnet en permanence.
C'est normal. opusplan ne passe sur Opus que pendant le mode planification, et n'y entre pas de lui-même. Basculez avec Shift+Tab, ou commencez votre demande par /plan.

Q3. Existe-t-il un moyen de vérifier sur quel modèle il tourne en ce moment ?
Vérifiez ce qu'affiche l'application plutôt que de le demander au modèle. /status indique le modèle actuel ; par ailleurs, la ligne d'état transmet le modèle actuel à votre script, ce qui permet de la configurer pour afficher le nom du modèle. Après coup, le message.model de chaque réponse dans les journaux de conversation (les fichiers JSONL de ~/.claude/projects) enregistre le modèle qui a réellement répondu.

Q4. Fonctionne-t-il sur Amazon Bedrock ou Google Cloud ?
Oui. Indiquez les identifiants de modèle de votre fournisseur dans ANTHROPIC_DEFAULT_OPUS_MODEL et ANTHROPIC_DEFAULT_SONNET_MODEL pour choisir les versions utilisées par opusplan. Si les paramètres gérés de votre organisation (availableModels) excluent l'Opus le plus récent, sur l'Anthropic API et Claude Platform on AWS, la planification se fait avec l'Opus le plus récent parmi ceux autorisés, et si tous les Opus sont exclus, la session reste sur Sonnet même en mode planification. Sur Bedrock, Google Cloud, Microsoft Foundry et les fournisseurs similaires, si le modèle est exclu, la planification se fait sur le modèle d'origine de la session, même en mode planification (ces deux comportements s'appliquent depuis la v2.1.205).

Q5. Qu'est-ce que opusplan[1m] ?
C'est l'indication qui utilise un contexte de 1 million de tokens à la fois pour l'Opus du mode planification et pour le Sonnet de l'exécution. Sur les forfaits où Opus passe automatiquement à 1M, comme Max, Team et Enterprise, le côté Opus passe à 1M même sans elle. Par ailleurs, sur l'Anthropic API, Sonnet 5 tourne toujours avec 1M, même sans rien indiquer. /model accepte cette écriture à partir de la v2.1.265.

Sources

• Claude Code Docs — Model configuration (description d'opusplan, cible des alias, méthodes de réglage et ordre de priorité, variables d'environnement, contexte de 1M, availableModels et passage à un modèle supérieur en mode planification)
• Claude Code Docs — Choose a permission mode (entrer en mode planification, approuver un plan)
• Claude Code Docs — Settings reference (model, showClearContextOnPlanAccept)
• Claude Code Docs — How Claude Code uses prompt caching (changement de modèle et cache, bascule du mode planification avec opusplan, durée de vie du cache)
• Claude Code Docs — Escalate hard decisions with the advisor tool (comparaison avec les fonctionnalités voisines, coût, effet sur le cache)
• Claude Code Docs — Error reference (limites d'utilisation)
• Claude Code Docs — Desktop (choix du modèle et du mode d'autorisation)
• Claude Code CHANGELOG (v1.0.77, v1.0.88, v2.0.17, v2.1.172, v2.1.265)
• Issue GitHub #8358, #26556, #27237 (retrait de l'écran de sélection, explication du membre de l'équipe d'Anthropic, demande d'affichage dans la liste, signalement sur le choix des versions)
• Claude Platform Docs — Pricing, page des tarifs de Claude (tarifs par modèle, modèles par forfait)

Articles liés

• Claude Code : exécuter les sous-agents sur un autre modèle : répartir les modèles selon les tâches
• Modes d'autorisation de Claude Code : les 5 modes expliqués : les modes d'autorisation, dont le mode planification
• Claude Code : mesurer la consommation par session : comment comparer la consommation
• Claude Code : qu'est-ce qui dévore vraiment votre contexte ? : pourquoi la quantité relue devient importante
• Astuces pour économiser les tokens Claude Code : d'autres postes à réduire