Plan mode de Claude Code : planifier, puis coder

Le plan mode de Claude Code est le moyen le plus simple d’empêcher un agent de foncer dans la mauvaise direction. Au lieu de modifier des fichiers tout de suite, Claude explore votre code, pose les questions dont il a besoin et rédige un plan. Vous le lisez, vous le contestez, et ce n’est que lorsqu’il vous paraît juste que vous le laissez construire. Ce guide explique comment fonctionne le plan mode aujourd’hui, comment l’activer, quand il vaut le coup et comment le combiner avec les sous-agents et CLAUDE.md.

Tout ce qui suit a été vérifié en octobre 2026 dans la documentation sur les modes de permission et la page des workflows courants d’Anthropic.

Qu’est-ce que le plan mode de Claude Code ?

Le plan mode est l’un des modes de permission de Claude Code. Dans ce mode, Claude peut :

• lire des fichiers et chercher dans le code,
• lancer des commandes shell pour explorer, par exemple lister des fichiers ou lire l’historique git,
• vous poser des questions de clarification,
• rédiger un plan.

Ce qu’il ne fait pas, c’est modifier votre code source. Le plan est une proposition, pas un changement. Tant que le plan mode est actif, la barre d’état affiche ⏸ plan mode on.

L’idée est de séparer la réflexion de l’action. En mode par défaut, Claude commence souvent à modifier après un rapide tour d’horizon. Sur les petites tâches, c’est exactement ce qu’on veut. Sur un gros changement, cela veut dire qu’on découvre une hypothèse erronée après que dix fichiers ont déjà été touchés.

Comment passer en plan mode

Il y a trois façons d’y entrer, selon le temps que vous voulez y rester.

Shift+Tab : changer de mode dans la session en cours

Appuyez sur Shift+Tab pour faire défiler les modes de permission. L’ordre est le suivant :

1. Par défaut (Claude demande avant les modifications et les commandes)
2. Accept edits
3. Plan mode
4. Bypass permissions, seulement si vous avez démarré avec cette option activée
5. Auto mode, seulement s’il vous est disponible

Puis on revient au mode par défaut. Arrêtez-vous quand la barre d’état affiche le plan mode. Appuyez de nouveau sur Shift+Tab pour sortir du plan mode sans rien approuver.

/plan : planifier un seul prompt

Tapez /plan devant un prompt pour ne planifier que cette demande :

/plan migre le stockage des sessions de Redis vers Postgres

C’est pratique si vous travaillez surtout en mode par défaut et ne voulez un plan que pour la grosse tâche occasionnelle.

Démarrer une session en plan mode

claude --permission-mode plan

Si vous voulez que chaque session démarre en plan mode, définissez-le par défaut dans .claude/settings.json :

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Dans l’extension VS Code, réglez claudeCode.initialPermissionMode sur "plan".

Le plan mode face aux autres modes

Le plan mode est le seul où les modifications attendent un plan entier, et pas un seul changement. Pour l’autre extrémité de l’échelle, plus risquée, voir désactiver les permissions dans Claude Code.

Shift+Tab, les modes de permission et les autres raccourcis sont regroupés dans l’aide-mémoire des commandes Claude Code.

Ce qui se passe quand le plan est prêt

Quand Claude a fini de planifier, il affiche le plan et vous demande comment continuer. Les options sont :

• Yes, and use auto mode : approuver et laisser Claude travailler avec les contrôles de sécurité de l’auto mode. Si l’auto mode n’est pas disponible, cette option s’affiche comme « Yes, auto-accept edits ».
• Yes, manually approve edits : approuver, mais valider chaque modification au fur et à mesure.
• No, keep planning : envoyer un retour et obtenir un plan révisé.

Si vous activez le réglage showClearContextOnPlanAccept, une option supplémentaire apparaît en premier : elle approuve le plan et efface la conversation de planification, pour que la construction démarre avec un contexte propre qui ne contient que le plan.

Approuver fait sortir du plan mode. Quelques autres points utiles :

• Ctrl+G ouvre le plan dans votre éditeur pour le modifier directement avant de l’approuver.
• Les plans sont enregistrés sous forme de fichiers, dans ~/.claude/plans/ par défaut, ou dans un dossier défini avec plansDirectory.
• Accepter un plan donne à la session un titre généré, ce qui la rend plus facile à retrouver ensuite.

Les commandes shell pendant la planification

Explorer veut souvent dire lancer des commandes. Si l’auto mode vous est disponible et que useAutoModeDuringPlan est activé, ce qui est le cas par défaut, un classifieur examine ces commandes comme il le ferait en auto mode. Sinon, tout ce qui sort d’un ensemble de commandes en lecture seule demande d’abord votre accord. Dans les deux cas, le plan mode n’est pas un bac à sable pour des commandes arbitraires : c’est un mode où Claude ne modifie pas votre code.

Quand utiliser le plan mode

Le plan mode vaut le coup quand un mauvais premier pas coûte cher.

Une bonne règle : si vous esquisseriez le changement sur papier avant de le faire vous-même, demandez d’abord un plan à Claude.

Le plan mode aide aussi à découvrir un code. Demandez en plan mode « comment l’authentification circule-t-elle du formulaire de login jusqu’au stockage des sessions ? » et Claude explore et explique sans risquer de toucher à quoi que ce soit.

Un workflow planifier puis exécuter

La boucle recommandée par Anthropic compte quatre étapes : explorer, planifier, implémenter, committer. En pratique, cela donne ceci.

1. Explorer

Passez en plan mode et orientez Claude vers la zone concernée :

Lis src/billing et les tests sous tests/billing.
Explique comment les factures sont générées et où les taxes sont appliquées.
Ne propose pas encore de changements.

Corrigez maintenant tout ce qu’il comprend de travers. Les malentendus ne coûtent jamais aussi peu qu’à ce stade.

2. Planifier

Demandez le plan avec les contraintes qui comptent :

Planifie l'ajout de taux de taxe par pays.
Garde l'API publique inchangée, ajoute une migration et liste les tests que tu ajouterais.

Un bon plan nomme les fichiers qu’il va modifier, l’ordre, les risques et la façon de vérifier le résultat.

3. Contester

N’approuvez pas le premier jet par réflexe. Choisissez « No, keep planning » et dites ce qu’il faut changer : « Fais la migration dans une étape séparée », « Ne touche pas au rendu PDF ». Ou appuyez sur Ctrl+G et modifiez le plan vous-même.

4. Exécuter

Approuvez. Si vous faites confiance au plan, « Yes, and use auto mode » laisse Claude le dérouler sans s’arrêter à chaque modification. Si le changement est risqué, choisissez l’approbation manuelle.

5. Vérifier et committer

Demandez à Claude de lancer les tests listés dans le plan. Si quelque chose tourne mal, Échap arrête Claude, et /rewind (ou deux appuis sur Échap) vous ramène à un checkpoint antérieur. Une fois que tout passe, committez.

Pour un changement plus important, gardez le fichier du plan et lancez la construction dans une nouvelle session. Le plan devient le prompt, et la construction démarre avec un contexte rempli de décisions, pas d’exploration.

Un modèle plus puissant pour planifier

L’alias de modèle opusplan utilise Opus en plan mode, puis passe à Sonnet pour l’exécution. Vous avez le raisonnement d’Opus pour les décisions et le coût plus bas de Sonnet pour l’écriture. Activez-le avec /model opusplan. Sur abonnement, cela fait aussi durer vos limites d’usage.

Plan mode et sous-agents

Le plan mode fonctionne bien avec les sous-agents, et Claude Code s’en sert déjà pour cela.

• Le sous-agent Plan intégré : en plan mode, Claude peut confier la recherche à un sous-agent Plan. Il dispose d’outils en lecture seule, utilise le même modèle que la conversation principale et fouille dans son propre contexte, si bien que la conversation principale ne reçoit que les conclusions. Il démarre sans votre CLAUDE.md ni l’instantané du statut git, et ne s’exécute qu’une fois : on ne peut pas le reprendre.
• Le sous-agent Explore : un autre agent intégré en lecture seule, conçu pour chercher et lire rapidement dans le code.
• Les sous-agents restent en plan mode : quand la conversation principale est en plan mode, les sous-agents qu’elle lance y restent aussi. Pas de modification surprise venant d’un assistant.

Comme la recherche se fait dans des contextes séparés, la conversation principale reste plus légère. Le plan reste ciblé et il reste davantage de place dans la fenêtre de contexte pour la construction.

Vous pouvez aussi demander directement une recherche en parallèle : « En plan mode, utilise des sous-agents pour examiner séparément la couche API, la couche base de données et le frontend, puis donne-moi un seul plan. » Une réserve tirée de la documentation d’Anthropic sur les coûts : les équipes d’agents dont les coéquipiers tournent en plan mode consomment environ sept fois plus de tokens qu’une session standard ; réservez cela aux changements qui le justifient.

Plan mode et CLAUDE.md

Le plan mode ne vaut que ce que vaut le contexte de départ de Claude. C’est là qu’intervient CLAUDE.md. Quelques lignes suffisent à améliorer nettement les plans :

## Planification
- Les plans listent les fichiers à modifier, dans l'ordre, et les tests à ajouter.
- Les changements de base de données ont toujours leur propre étape de migration.
- Ne jamais modifier une signature d'API publique sans le signaler.
- Vérifier avec `pnpm test` et `pnpm lint`.

Gardez deux détails en tête :

• Le sous-agent Plan intégré ne voit pas CLAUDE.md. Mettez-y les règles du projet pour la conversation principale, et ajoutez ce qui est critique dans votre prompt quand vous demandez une recherche.
• Gardez CLAUDE.md court. Il est envoyé à chaque tour, donc un fichier long coûte des tokens dans tous les modes. Déplacez les procédures longues dans des skills.

Si votre équipe planifie toujours avant de construire, faites du plan mode le mode par défaut dans le .claude/settings.json partagé et décrivez dans CLAUDE.md à quoi ressemble un bon plan. Tout le monde obtient le même comportement sans avoir à y penser.

Erreurs courantes

• Approuver sans lire. Un plan non lu n’est qu’un mode par défaut plus lent.
• Planifier des tâches minuscules. Pour corriger une coquille, le plan mode ne fait qu’ajouter un aller-retour.
• Des plans trop vagues. « Refactorer le module d’authentification » n’est pas un plan. Demandez les fichiers, l’ordre et les étapes de vérification.
• Ne jamais effacer après la planification. L’exploration remplit le contexte. Pour les gros chantiers, approuvez avec l’option qui efface le contexte ou démarrez une nouvelle session à partir du fichier du plan.
• Prendre le plan mode pour un bac à sable. Il empêche les modifications du code source ; il ne transforme pas le terminal en terrain de jeu sans risque. Relisez les commandes comme partout ailleurs.

Planifier dans AgentVera

AgentVera est une application de bureau pour macOS, Windows et Linux qui fait tourner Claude Code et d’autres agents CLI côte à côte, par projet. Chaque panneau est le vrai terminal Claude Code : Shift+Tab, /plan et les options d’approbation du plan fonctionnent exactement comme d’habitude. AgentVera ajoute une structure autour :

• Ligne de tâches : une tâche passe par les étapes Analyse, Plan, Construction et Revue. Chaque étape écrit son résultat dans un fichier, comme 02-plan.md, et l’étape suivante repart de là : le plan suit la tâche au lieu de rester enfermé dans une seule conversation.
• Flows : enchaînez des étapes comme recherche, plan et construction, pour que la même boucle planifier puis exécuter se déroule chaque fois de la même façon.
• Approbation automatique : une fois le plan approuvé, les lectures et tests sans risque passent sans demande, tandis que des actions comme git push ou rm demandent toujours.
• Checkpoints et replay : les 60 derniers tours de chaque agent sont conservés, pour revenir en arrière si la construction s’écarte du plan.

Les checkpoints sont inclus dans l’offre gratuite. La ligne de tâches et l’approbation automatique sont sur Pro et Team. Si vous débutez avec plusieurs agents, commencez par comment utiliser Claude Code et téléchargez AgentVera.

En résumé

Le plan mode oblige Claude à explorer et à proposer avant de modifier. Activez-le avec Shift+Tab, /plan ou --permission-mode plan, lisez vraiment le plan, contestez-le avec « No, keep planning » ou Ctrl+G, et seulement ensuite approuvez. Utilisez-le pour les changements sur plusieurs fichiers, le code que vous ne connaissez pas et tout ce qui est risqué ; passez-vous-en pour les petites corrections. Associez-le à un CLAUDE.md court et précis, laissez les sous-agents en lecture seule faire les fouilles, et essayez opusplan pour planifier avec Opus et construire avec Sonnet.