Workbranch › Guides

Comment utiliser le mode plan dans Claude Code

Laisser Claude Code modifier les fichiers tout de suite, c'est rapide, jusqu'au jour où il part dans la mauvaise direction sur dix fichiers. Le mode plan l'oblige à analyser d'abord et à vous montrer un plan, et dans la plupart des configurations il ne peut pas modifier vos fichiers avant votre accord. Voici comment l'activer, relire le plan et décider quand cela vaut la peine.

Mis à jour le 30 octobre 2026

Les raccourcis et noms d'options ci-dessous ont été vérifiés dans la documentation Claude Code d'Anthropic en octobre 2026. Le libellé des options peut changer d'une version à l'autre.

Ce que fait le mode plan

Le mode plan est l'un des modes de permission de Claude Code. Dans ce mode, Claude peut lire vos fichiers et lancer des commandes shell pour comprendre le code, puis il rédige un plan pour la modification. Les modifications de votre code sont bloquées jusqu'à ce que vous approuviez ce plan. Vous validez l'approche une seule fois, au départ, au lieu de juger chaque modification l'une après l'autre.

Activer le mode plan

Il existe quatre façons de faire, selon la fréquence à laquelle vous voulez l'utiliser.

• En cours de session : appuyez sur Shift+Tab pour faire défiler les modes jusqu'à ce que la barre d'état indique ⏸ plan mode on. Appuyer de nouveau quitte le mode plan sans rien approuver.
• Avec une tâche : commencez le prompt par /plan, par exemple /plan add rate limiting to the login endpoint.
• Au lancement : exécutez claude --permission-mode plan.
• Par défaut pour le projet : dans le fichier .claude/settings.json du projet, définissez "defaultMode": "plan" dans "permissions". Dans l'extension VS Code, définissez plutôt claudeCode.initialPermissionMode sur plan dans vos paramètres utilisateur, car VS Code ne lit pas le réglage du projet pour le mode de départ.

Relire et approuver le plan

1. Avec le mode plan actif, décrivez la tâche et ce à quoi ressemble un bon résultat. Mentionnez les fichiers ou contraintes que vous connaissez déjà.
2. Laissez Claude explorer. Il lit le code et peut lancer des commandes ; selon votre configuration, certaines commandes demandent votre approbation.
3. Lisez le plan qu'il présente. Vérifiez quels fichiers il veut modifier, l'ordre des étapes et comment il testera le résultat.
4. Pour modifier le plan vous-même, appuyez sur Ctrl+G. Le plan s'ouvre dans votre éditeur de texte par défaut ; enregistrez-le et Claude travaille à partir de votre version.
5. Choisissez une option :
   • Yes, and use auto mode (affiché Yes, auto-accept edits quand le mode auto n'est pas disponible) : approuver et laisser Claude faire les modifications sans demander à chaque fois.
   • Yes, manually approve edits : approuver, mais valider chaque modification.
   • No, keep planning : rester en mode plan et dire à Claude quoi changer.

L'approbation quitte le mode plan, passe au mode choisi et Claude se met au travail. Elle donne aussi un titre généré à la session si vous ne l'avez pas nommée. Si le réglage showClearContextOnPlanAccept est activé, une première option supplémentaire approuve le plan et efface la conversation de planification.

Quand utiliser le mode plan

• Modifications sur plusieurs fichiers, comme un refactoring ou une nouvelle fonctionnalité, quand une mauvaise approche coûte cher à défaire.
• Code que vous ne connaissez pas encore. Anthropic recommande le mode plan pour explorer une base de code avant de la modifier.
• Travail où vous voulez avoir votre mot à dire sur l'approche : ajustez le plan avec Ctrl+G avant qu'un seul fichier soit touché.
• Généralement inutile pour les petites corrections évidentes, comme une faute de frappe, où relire un plan prend plus de temps que la modification.

Mettre vos commandes de test et vos conventions dans un fichier CLAUDE.md donne au plan de meilleures bases.

Bon à savoir

• Claude Code est inclus dans les offres Pro et Max, dans le même abonnement que les applications Claude ; les membres Team et Enterprise ont un article d'aide distinct.
• Le traitement des commandes shell pendant la planification dépend de la session : si le mode auto est disponible, un classificateur les examine par défaut ; sinon, les commandes hors de l'ensemble intégré en lecture seule demandent d'abord votre accord.
• Les fichiers de plan sont enregistrés dans ~/.claude/plans/, sauf si plansDirectory pointe ailleurs.
• Une exception au blocage des modifications : dans une session de terminal interactive où le mode bypass permissions est disponible, Claude reçoit toujours la consigne de seulement planifier, mais Claude Code ne l'impose pas ; une modification tentée pendant la planification peut donc s'exécuter sans demande. Dans les exécutions -p, l'Agent SDK et le panneau de chat de VS Code, le blocage s'applique toujours.

Si cela ne fonctionne pas

• Shift+Tab n'atteint pas le mode plan. Continuez d'appuyer : le raccourci fait défiler tous les modes. Cherchez ⏸ plan mode on dans la barre d'état.
• Claude a commencé à modifier après le plan. C'est normal dès que vous choisissez une option Yes. Choisissez No, keep planning si vous n'êtes pas prêt.
• Le mode par défaut du projet n'est pas appliqué dans VS Code. Utilisez le paramètre utilisateur claudeCode.initialPermissionMode.
• Ctrl+G ouvre un programme inattendu. Le plan s'ouvre dans l'éditeur de texte défini par défaut : changez ce réglage si vous en voulez un autre.

Gardez les points ouverts du plan

Un plan soulève souvent des décisions et des suites à donner qui dépassent la session. Avec le plugin Workbranch pour Claude Code, lancez /workbranch:save et Claude classe les tâches, décisions et questions ouvertes de la session dans un projet Workbranch. Workbranch propose un essai gratuit de 3 jours sur app.workbranch.ai.

Sources

• Permission modes (documentation Claude Code, consultée le 30 octobre 2026)
• Common workflows (documentation Claude Code, consultée le 30 octobre 2026)
• Commands (documentation Claude Code, consultée le 30 octobre 2026)
• Use Claude Code with your Pro or Max plan (centre d'aide Claude, consulté le 30 octobre 2026)

Questions fréquentes