Mode planification de Claude Code : comment l’utiliser et quand il fait gagner du temps et économiser des tokens
Le mode plan de Claude Code vous permet d’examiner une approche avant le début de sa mise en œuvre. Ce guide explique comment activer et quitter le mode plan de Claude Code, en faire votre mode par défaut et déterminer quand la planification peut faire gagner du temps et économiser des tokens en réduisant les recherches inutiles et les cycles de révision.
Ce que fait le mode plan de Claude Code
Le mode plan sépare la proposition d’une modification de sa mise en œuvre. Claude examine la tâche, propose une approche et attend votre approbation pour que vous puissiez examiner et ajuster le plan avant de poursuivre.
Le La FAQ destinée aux utilisateurs de Claude Code, datée du 7 août 2026, décrit plan comme une planification en lecture seule qui attend une approbation. Cela la rend utile lorsque vous souhaitez vérifier que Claude a bien compris une tâche avant d’autoriser sa mise en œuvre.
Lecture seule ne signifie pas absence d’outils. Claude peut lire des fichiers et utiliser des outils en lecture seule pendant la planification. L’historique des versions disponible au 14 août 2026 comprend un correctif pour les appels d’outils en lecture seule dans les sessions qui démarrent en mode Plan. Il serait donc trompeur d’affirmer que la planification empêche toute commande ou toute inspection du dépôt.
Le mode Plan et les autres modes d’autorisation
La planification détermine si Claude propose un travail ou l’exécute. Le mode d’autorisation utilisé pour l’implémentation détermine les actions qui nécessitent une approbation.
| Mode | Comportement documenté | Points à prendre en compte |
|---|---|---|
plan |
Planification en lecture seule ; attend l’approbation | Utilisez-le pour examiner l’approche avant l’implémentation. |
| Manuelle | Demande une autorisation avant les modifications ou commandes risquées | Attendez-vous à des demandes d’approbation pour ces actions pendant l’implémentation. |
acceptEdits |
Accepte automatiquement les modifications de fichiers ; les commandes peuvent toujours nécessiter une approbation | Les modifications de fichiers et les autorisations relatives aux commandes sont distinctes. |
auto |
Approuve automatiquement les actions avec un contrôle de sécurité en arrière-plan | La disponibilité dépend des modèles pris en charge et des paramètres de l’organisation. |
À la date de publication, le nom affiché de l’ancien default mode d’autorisation est Manuelle. La version 2.1.200 a introduit ce changement d’affichage et accepté manual aux côtés de default dans les paramètres de configuration et de ligne de commande concernés.
Comment activer et quitter le mode Plan
Trois méthodes permettent d’y accéder : parcourir les modes d’autorisation pendant une session, utiliser /plan, ou démarrer Claude Code avec l’option du mode Plan.
Utiliser Maj+Tab pendant une session
Appuyez sur Maj+Tab pour parcourir les modes d’autorisation jusqu’à sélectionner le mode Plan. Depuis l’état initial habituel décrit dans le guide d’Anthropic d’avril 15, la première pression active acceptEdits et la seconde active le mode Plan.
Considérez « appuyer deux fois » comme une description de cet état initial, plutôt que comme une règle universelle. Votre session peut déjà se trouver dans un autre mode : vérifiez donc le mode sélectionné à mesure que vous les parcourez.
Pour quitter le mode Plan, utilisez Maj+Tab afin de passer au mode d’autorisation souhaité pour l’implémentation. Examinez d’abord le plan, puis exécutez le travail convenu dans ce mode.
Activer directement avec /plan
Dans une session, utilisez :
/plan
Vous pouvez également inclure la tâche immédiatement :
/plan fix the auth bug
L’argument de description a été ajouté dans la version v2.1.72 le 10 mars 2026. Il active le mode Plan et lance la planification de cette tâche, ce qui vous permet de préciser à la fois le mode et la tâche dans une seule commande.
Démarrer une nouvelle session en mode Plan
Pour commencer avec la planification sélectionnée, exécutez :
claude --permission-mode plan
Cette méthode est utile lorsque vous savez déjà que la tâche nécessite une investigation et un examen avant l’implémentation. Pour les usages associés en ligne de commande, consultez le référence de la CLI de Claude Code.
Ces méthodes d’accès conduisent au même processus de planification. Choisissez le raccourci pour une conversation en cours, /plan lorsque vous souhaitez une commande explicite, et l’option de démarrage lorsque la planification doit être le mode initial de la session.
Élaborer un plan prêt pour l’implémentation
Un plan Claude Code utile doit permettre d’évaluer facilement la modification proposée. Fournissez à Claude suffisamment de contexte pour identifier le code pertinent et suffisamment de critères d’acceptation pour comprendre ce qui constitue une implémentation réussie.
Le guide sur le contexte et l’amélioration des prompts recommande de fournir des références aux fichiers pertinents et d’examiner le plan dans la conversation avant de changer de mode et d’implémenter une étape.
Fournir les chemins connus et les critères d’acceptation
Référencez les fichiers avec @path/to/file lorsque vous savez déjà où se trouve le code pertinent. Le guide indique que fournir ces références est plus rapide et utilise moins de tokens que de demander à Claude de localiser les fichiers.
Associez ces chemins à une définition concrète de la réussite. Pour un bug d’authentification, par exemple, vous pourriez décrire le comportement défaillant, identifier les fichiers pertinents et préciser le comportement attendu après la correction. Il s’agit d’une suggestion pour formuler une tâche, et non d’une affirmation concernant un dépôt particulier.
Informations utiles à inclure :
- Le comportement à modifier.
- Les fichiers pertinents que vous connaissez déjà.
- Les contraintes sur le périmètre de la modification.
- Les critères d’acceptation du travail terminé.
L’objectif est de réduire l’incertitude avant l’implémentation. Une description détaillée du résultat souhaité est plus utile qu’une demande de plan qui n’explique pas ce que la modification doit accomplir.
Examiner le plan avant de l’approuver
Vérifiez que l’approche proposée répond au comportement demandé et respecte le périmètre prévu. Pour un travail portant sur plusieurs fichiers, examinez la manière dont les étapes s’articulent avant d’autoriser les modifications.
Si le plan révèle un malentendu, corrigez-le dans la conversation. Les recommandations d’Anthropic prévoient explicitement l’examen et l’ajustement du plan avant de changer de mode et d’implémenter une étape.
L’approbation marque le passage de l’examen de l’approche à l’implémentation. Le mode d’autorisation sélectionné pour l’implémentation reste important : approuver un plan ne rend pas le mode Manuel, acceptEdits, ainsi que auto équivalents.
Quand la planification fait gagner du temps et économiser des tokens
Le mode de planification de Claude Code est particulièrement utile lorsque dissiper l’incertitude en amont permet d’éviter un travail d’implémentation inutile. Les modifications portant sur plusieurs fichiers s’y prêtent bien, car une hypothèse incorrecte peut affecter plusieurs parties de la modification proposée.
Les mécanismes d’économie étayés sont précis : repérer les malentendus avant qu’ils ne produisent un diff volumineux, réduire les cycles de révision en définissant la réussite dès le départ et éviter les recherches de fichiers inutiles en fournissant les chemins connus.
Utiliser la planification lorsque le périmètre doit être examiné
Envisagez le mode Plan lorsqu’une tâche porte sur plusieurs fichiers ou lorsque vous devez confirmer l’approche avant de commencer les modifications. L’examen du plan vous permet de restreindre le périmètre, de corriger les hypothèses ou de modifier l’ordre du travail.
Pour une petite modification clairement définie, demandez-vous si une phase de planification distincte permettrait de dissiper une incertitude significative. Si le fichier concerné et le comportement requis sont déjà clairs, une conversation de planification prolongée peut présenter moins d’intérêt.
Il s’agit d’un choix de méthode de travail, pas d’un résultat de benchmark. La note de recherche n’établit aucun seuil mesuré à partir duquel la planification devient plus rapide.
Rester précis sur les économies de tokens
La planification ajoute une phase de travail avant l’implémentation. Son bénéfice potentiel vient du travail évité qui aurait autrement dû être répété ou abandonné.
Cette distinction compte lors de l’évaluation de l’utilisation des tokens. Fournir un chemin de fichier connu est une méthode documentée pour économiser les tokens consacrés aux recherches. L’examen du plan peut également aider à réduire les malentendus et les cycles de révision, mais les éléments disponibles ne quantifient pas les économies nettes du mode Plan.
Aucun benchmark officiel établi avant la date limite retenue ne vient étayer un pourcentage fixe de réduction du temps ou des tokens. Les éléments fournis n’établissent pas non plus de tarification ou de quota d’utilisation distincts pour le mode Plan.
Utilisez la planification pour améliorer la qualité de la prochaine étape d’implémentation et évaluez les économies en fonction des recherches et des révisions évitées. Pour une discussion plus large de cet objectif, consultez comment réduire l’utilisation des tokens de Claude.
Le mode Plan, opusplan, et l’effacement du contexte
Le mode d’autorisation et le choix du modèle sont deux décisions distinctes. Activer le mode Plan sélectionne le comportement de planification ; une configuration de planification Opus détermine le modèle qui prend en charge ce travail.
Ce que opusplan signifie
La version 1.0.77 a introduit Mode Plan Opus dans /model, en utilisant Opus pour la planification et Sonnet pour le reste. Le journal des modifications à la date limite du 14 août 2026 documente également l’alias opusplan .
Ne considérez pas opusplan comme un synonyme du plan mode d’autorisation. L’un concerne le choix du modèle pour la planification et les autres travaux ; l’autre concerne la planification en lecture seule et l’approbation.
Les versions exactes des modèles et les économies qui peuvent en résulter dépendent de la configuration. Les éléments fournis n’établissent pas de pourcentage fixe d’économie pour cette configuration. Le guide des modèles de Claude Code permet d’explorer le choix du modèle indépendamment des paramètres d’autorisation.
Faut-il effacer le contexte avant l’implémentation ?
L’effacement du contexte est facultatif. La version 2.1.81, publiée le 20 mars 2026, a masqué par défaut l’option « effacer le contexte » lors de l’approbation du plan.
Pour rétablir cette option, utilisez le paramètre :
{
"showClearContextOnPlanAccept": true
}
Le notes de version de la v2.1.81 documentent cette modification. Rétablir l’option la rend disponible lors de l’approbation du plan ; les éléments disponibles n’établissent pas que l’effacement du contexte économise toujours des tokens ou améliore l’implémentation.
Définir la planification comme mode par défaut
Si vous souhaitez régulièrement examiner une approche avant l’implémentation, vous pouvez configurer le mode Plan par défaut :
{
"permissions": {
"defaultMode": "plan"
}
}
A discussion dans le dépôt de juillet 28 2025 place cette configuration dans ~/.claude/settings.json.
Une précision s’impose concernant la source : l’exemple daté est un commentaire de la communauté dans le dépôt officiel d’Anthropic. La documentation officielle actuelle sur les modes d’autorisation corrobore cette configuration, mais la date de sa révision historique est incertaine.
Utilisez l’option de démarrage lorsque vous souhaitez planifier pour une session donnée. Envisagez le paramètre par défaut lorsque l’examen préalable d’un plan fait partie de votre méthode de travail habituelle. Dans les deux cas, vous pouvez examiner et ajuster l’approche proposée, puis changer de mode pour l’implémentation.
Points clés
- Le mode Plan permet une planification en lecture seule avec une étape d’approbation. Il peut examiner les fichiers et utiliser des outils en lecture seule pendant la préparation de l’approche.
- Activez-le avec Maj+Tab,
/plan, ouclaude --permission-mode plan; le nombre de pressions sur le raccourci dépend du mode de départ. - Fournissez les chemins de fichiers connus et les critères d’acceptation pour réduire les recherches et les cycles de révision.
- La planification est particulièrement utile pour examiner des modifications dans plusieurs fichiers, mais aucun pourcentage fixe de gain de temps ou d’économie de tokens n’est établi.
opusplanconcerne la sélection du modèle, tandis que l’effacement du contexte est un paramètre facultatif lors de l’approbation du plan.
FAQ
Comment activer et quitter le mode Plan avec Maj+Tab ?
Appuyez sur Maj+Tab pour parcourir les modes d’autorisation jusqu’à sélectionner le mode Plan. Pour le quitter, passez au mode souhaité pour la mise en œuvre ; le nombre de pressions dépend du mode actuel de la session.
Le mode Plan peut-il lire des fichiers ou exécuter des commandes shell ?
Le mode Plan peut lire des fichiers et utiliser des outils en lecture seule pendant la préparation d’un plan. Il est inexact de dire qu’il bloque toutes les commandes, mais son comportement documenté consiste à planifier en lecture seule et à attendre une approbation avant la mise en œuvre.
Comment démarrer chaque session en mode Plan ?
Définissez permissions.defaultMode à "plan" dans ~/.claude/settings.json, comme indiqué dans la discussion datée du dépôt. Pour une seule session, démarrez Claude Code avec claude --permission-mode plan.
Le mode Plan permet-il d’économiser des tokens ?
Fournir les chemins de fichiers connus permet d’économiser les tokens consacrés aux recherches, et définir des critères d’acceptation peut réduire les cycles de révision. La planification elle-même ajoute du travail : les économies nettes dépendent donc de ce qu’elle permet d’éviter ; les éléments fournis n’établissent aucun pourcentage fixe ni aucune mesure de référence officielle des économies nettes.
Une seule clé API pour Claude Opus 5.5, Sonnet 5, Haiku 4.5 et Fable 5.1, ainsi que GPT-6 modèles. Paiement à l’usage, sans abonnement.
Obtenir votre clé API →