Mode plan de Claude Code (2026) : l'activer, approuver les plans et quand l'utiliser

Le mode plan est un mode de permission de Claude Code dans lequel Claude étudie votre code et rédige un plan, mais ne modifie pas vos fichiers source tant que vous ne l'avez pas approuvé. Activez-le en appuyant sur Shift+Tab jusqu'à ce que la barre d'état affiche ⏸ plan mode on, en commençant un prompt par la commande plan, ou en lançant Claude Code avec le mode de permission réglé sur plan. Quand le plan est prêt, vous l'approuvez, continuez à planifier, ou appuyez sur Ctrl+G pour le modifier vous-même avant que Claude n'écrive la moindre ligne de code.

Vérifié dans la documentation Claude Code d'Anthropic le 17 octobre 2026. Claude Code est mis à jour souvent : les libellés et les valeurs par défaut peuvent changer d'une version à l'autre. Si votre écran affiche quelque chose de différent, mettez d'abord Claude Code à jour (voir comment mettre à jour Claude Code).

Ce que fait le mode plan

Chaque session Claude Code s'exécute dans un mode de permission qui détermine ce que Claude peut faire sans vous demander. Le mode plan est celui conçu pour réfléchir avant d'agir : Claude lit des fichiers, lance des commandes shell pour explorer et rédige un plan, mais il ne modifie pas votre code source. Les modifications restent bloquées jusqu'à ce que vous approuviez le plan. Le guide des bonnes pratiques d'Anthropic présente cela comme une séparation entre exploration et exécution, pour que Claude ne se lance pas directement dans du code qui résout le mauvais problème.

Le traitement des commandes d'exploration dépend de votre session. Anthropic documente trois cas, et le premier qui correspond s'applique :

• Mode auto disponible et useAutoModeDuringPlan activé (par défaut) : le classifieur du mode auto, un second modèle, examine chaque commande shell au lieu de vous la soumettre. Les commandes approuvées s'exécutent et celles rejetées sont bloquées. Les suppressions qui visent des chemins critiques vous sont toujours soumises.
• Mode auto indisponible, ou useAutoModeDuringPlan désactivé : toute commande hors de l'ensemble intégré de commandes en lecture seule de Claude Code demande votre approbation.
• Sessions de terminal interactives où le contournement des permissions est disponible (vous avez lancé avec l'une des options de contournement des permissions ou défini bypassPermissions comme mode par défaut) : les blocages du mode plan ne sont pas appliqués. Claude reçoit toujours la consigne de planifier sans modifier, mais une modification ou une commande qu'il tente s'exécute sans demande. Les règles ask explicites et les suppressions de chemins critiques déclenchent toujours une demande.

Le mode plan conserve ses blocages partout où Claude Code s'exécute sans terminal interactif : exécutions non interactives avec l'option print, sessions Agent SDK et conversations dans le panneau de chat de l'extension VS Code. Dans l'Agent SDK, les modifications de fichiers en mode plan ne sont jamais approuvées automatiquement, même si une règle allow correspond ou si un hook renvoie allow ; elles passent par votre callback canUseTool.

Avec Claude Code v2.1.283 ou plus récent, le mode auto est le mode de départ intégré des sessions de terminal interactives et VS Code : la plupart des utilisateurs atteignent donc le mode plan en quittant le mode auto par rotation.

Comment passer en mode plan

Option 1 : Shift+Tab pendant une session

Appuyez sur Shift+Tab pour faire défiler les modes de permission. Depuis le mode auto, le premier appui passe en Manuel, puis la rotation enchaîne Manuel, accepter les modifications, plan. Les modes optionnels comme le contournement des permissions et auto viennent après plan. Continuez jusqu'à ce que la barre d'état affiche ⏸ plan mode on. Depuis une nouvelle session qui démarre en mode auto, cela fait trois appuis.

Sous Windows, si Shift+Tab ne change pas de mode, utilisez Alt+M. Anthropic l'indique comme alternative lorsque le runtime Node ou Bun n'active pas le mode d'entrée VT.

Option 2 : la commande plan

Commencez un message par la commande plan pour passer en mode plan depuis l'invite. Avec une description à la suite, Claude passe en mode plan et commence immédiatement à planifier cette tâche :

/plan fix the auth bug

Seule, sans description, la commande se contente de basculer la session en mode plan et attend votre prochain message :

/plan

Option 3 : démarrer une session en mode plan

claude --permission-mode plan

La même option de mode de permission fonctionne pour les exécutions non interactives, où les blocages du mode plan s'appliquent toujours. Par exemple, pour obtenir un plan écrit d'une modification sans laisser Claude toucher au moindre fichier :

claude -p --permission-mode plan "Propose a plan to add rate limiting to the /login endpoint"

Option 4 : faire du mode plan le mode par défaut d'un projet

Pour démarrer chaque session de terminal d'un projet en mode plan, réglez defaultMode sur plan dans le fichier .claude/settings.json du projet :

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

L'extension VS Code ne lit pas les fichiers de paramètres d'un projet pour son mode de départ. Dans VS Code, réglez claudeCode.initialPermissionMode sur plan dans vos paramètres utilisateur, ou choisissez Plan dans l'indicateur de mode en bas de la zone de saisie pour une seule conversation.

{
  "claudeCode.initialPermissionMode": "plan"
}

Comment approuver, modifier ou quitter un plan

Quand le plan est prêt, Claude l'affiche et vous demande comment continuer :

• Appuyez sur Ctrl+G pour ouvrir le plan proposé dans votre éditeur de texte par défaut et le modifier directement avant que Claude ne poursuive.
• Approuver un plan fait sortir du mode plan et bascule la session dans le mode indiqué par l'option : Claude commence alors les modifications.
• Accepter un plan donne aussi à la session un titre généré à partir du plan, sauf si vous l'avez déjà nommée.
• Pour quitter le mode plan sans rien approuver, appuyez à nouveau sur Shift+Tab.
• Pour planifier à nouveau plus tard, revenez-y avec Shift+Tab ou commencez votre prochain prompt par la commande plan.

Vider le contexte de planification lors de l'approbation

Les longues sessions de planification peuvent remplir une grande partie de la fenêtre de contexte avec des lectures de fichiers. Le paramètre showClearContextOnPlanAccept (désactivé par défaut) ajoute une première option au menu d'approbation, Yes, clear context and …, qui approuve le plan, vide la conversation et commence l'implémentation à partir du seul plan. Le libellé indique aussi la quantité de contexte utilisée par la planification. Activez-le dans votre fichier de paramètres :

{
  "showClearContextOnPlanAccept": true
}

C'est utile quand le plan est suffisamment complet pour se suffire à lui-même. Si le plan repose sur des éléments que Claude a appris sans les écrire, conservez plutôt le contexte, ou modifiez le plan avec Ctrl+G pour ajouter les détails manquants avant de vider.

Exemple concret : planifier une fonctionnalité

Le flux de travail recommandé par Anthropic comporte quatre phases : explorer, planifier, implémenter, commiter. Voici ce que cela donne pour ajouter la connexion Google à une application existante.

1. Explorer. Passez en mode plan et demandez à Claude de lire le code concerné. Rien n'est modifié.
2. Planifier. Demandez un plan concret : quels fichiers changent, dans quel ordre, et comment vous testerez.
3. Relire. Lisez le plan. Appuyez sur Ctrl+G pour corriger directement ce qui doit l'être, ou choisissez No, keep planning et dites ce qu'il faut changer.
4. Implémenter. Approuvez avec l'option qui correspond au niveau de surveillance souhaité, puis demandez à Claude d'implémenter et de lancer les tests.
5. Commiter. Demandez à Claude de commiter avec un message descriptif et d'ouvrir une pull request.

Exemples de prompts pour les phases d'exploration et de planification, saisis avec le mode plan activé :

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

Après votre approbation, un prompt d'implémentation typique est :

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

Ce qui rend un plan digne d'être approuvé

• Il nomme les fichiers. Un bon plan liste les fichiers qu'il va créer ou modifier, pas seulement l'idée.
• Il précise l'ordre des modifications, par exemple la migration de base de données d'abord, puis le modèle, puis la route API, puis l'interface.
• Il indique comment le travail sera vérifié : quels tests ajouter ou lancer, et quelle commande compile ou analyse le projet.
• Il signale les questions ouvertes. Si Claude a dû deviner quelque chose, comme la bibliothèque OAuth que vous préférez, répondez avant d'approuver plutôt qu'après l'écriture du code.
• Il reste dans le périmètre. Si le plan touche des fichiers inattendus, demandez pourquoi avant d'approuver.

Quand utiliser le mode plan (et quand s'en passer)

• Bases de code inconnues : laissez Claude cartographier les fichiers et les flux de données avant qu'il ne touche à quoi que ce soit.
• Modifications sur plusieurs fichiers et refactorisations : vérifiez à l'avance l'ordre des modifications et les fichiers concernés.
• Zones sensibles comme l'authentification, les paiements, les migrations de base de données ou la configuration de déploiement, où vous voulez lire chaque étape avant son exécution.
• Quand vous n'êtes pas sûr de l'approche : demandez à Claude de comparer deux ou trois options dans le plan et d'en choisir une avant que le moindre code n'existe.
• Économiser l'usage : un plan relu repère une mauvaise approche avant que Claude ne dépense des tokens à modifier et remodifier des fichiers. C'est important avec les limites du plan Pro ou une facturation API au token.

Anthropic note que le mode plan ajoute une surcharge. Pour les petites tâches claires, comme corriger une faute de frappe, ajouter une ligne de log ou renommer une variable, demandez directement à Claude de le faire. Leur règle empirique : si vous pouvez décrire le diff en une phrase, passez-vous du plan.

Planifier avec Opus, construire avec Sonnet : le réglage de modèle opusplan

Claude Code dispose d'un alias de modèle spécial, opusplan, qui utilise Opus en mode plan et bascule automatiquement sur Sonnet une fois que vous approuvez et que l'exécution commence. L'idée est d'utiliser le modèle au raisonnement le plus poussé pour les décisions d'architecture, et le modèle plus rapide et moins cher pour écrire le code. Activez-le dans une session :

/model opusplan

Ou démarrez une session avec :

claude --model opusplan

La phase de planification utilise la même fenêtre de contexte que le réglage de modèle opus, et l'exécution la même que sonnet. Si la liste de modèles autorisés de votre organisation exclut le dernier Opus, Anthropic indique qu'opusplan planifie avec le plus récent Opus autorisé. Sur les abonnements Pro ou Max, gardez à l'esprit que l'usage d'Opus et de Sonnet peut être décompté de limites différentes ; consultez les prix de Claude Code et les prix de Claude pour le détail des plans.

Où les plans sont enregistrés

Claude Code écrit les fichiers de plan dans ~/.claude/plans par défaut. Pour conserver les plans dans votre dépôt, par exemple pour les faire relire dans une pull request, réglez plansDirectory sur un chemin relatif à la racine du projet :

{
  "plansDirectory": "./plans"
}

Claude Code revient à ~/.claude/plans si le chemin pointe hors de la racine du projet (comme ../plans) ou, sur macOS, Linux et WSL, s'il contient une barre oblique inverse. Écrivez les chemins avec des barres obliques, qui fonctionnent aussi sous Windows.

Le mode plan dans les autres applications Claude Code

• VS Code : cliquez sur l'indicateur de mode en bas de la zone de saisie et choisissez Plan. Ce choix ne s'applique qu'à cette conversation ; il n'est pas mémorisé comme mode de départ suivant.
• JetBrains : le plugin exécute Claude Code dans le terminal de l'IDE : Shift+Tab et l'option de mode de permission fonctionnent donc comme dans la CLI.
• Application Desktop : dans l'onglet Code, choisissez Plan dans le sélecteur de mode à côté du bouton d'envoi. Les autres modes sont mémorisés par dossier, mais Plan ne s'applique qu'à la session en cours.
• Claude Code sur le web et sur mobile : les sessions cloud proposent Accept edits, Plan et Auto dans le menu déroulant des modes. Dans l'application mobile, touchez le bouton + de la zone de saisie, puis Permission.
• Agent SDK : réglez le mode de permission sur plan. Claude explore et planifie ; les modifications passent par votre callback canUseTool, et Claude peut poser des questions de clarification avant de finaliser le plan.

L'ancienne commande ultraplan, qui envoyait une tâche de planification vers une session cloud, a été supprimée. La référence des commandes d'Anthropic renvoie désormais vers le mode plan.

Dépannage

Shift+Tab ne change pas de mode

• Sous Windows, essayez Alt+M. Certains runtimes Node ou Bun n'activent pas le mode d'entrée VT, si bien que le terminal ne transmet jamais Shift+Tab.
• Surveillez la barre d'état pendant que vous appuyez : vous dépassez peut-être le mode plan. Depuis le mode auto, il faut trois appuis pour l'atteindre.
• Si une demande de permission est ouverte, Shift+Tab agit sur celle-ci au lieu de faire défiler les modes. Répondez-y ou fermez-la d'abord.
• Les anciennes versions peuvent se comporter différemment. Mettez Claude Code à jour et réessayez.

Claude me demande sans cesse d'approuver des commandes d'exploration

Cela signifie que le classifieur du mode auto n'examine pas les commandes à votre place : soit le mode auto n'est pas disponible pour votre compte, votre modèle ou votre organisation, soit useAutoModeDuringPlan est réglé sur false. La référence des paramètres d'Anthropic précise qu'un dépôt ne peut pas désactiver ce paramètre pour vous ; il se trouve dans les paramètres utilisateur, locaux ou gérés. Vous pouvez approuver les commandes, ajouter des règles allow pour celles en lesquelles vous avez confiance, ou vérifier la disponibilité du mode auto sur la page des modes de permission d'Anthropic.

Claude a modifié des fichiers alors que j'étais en mode plan

Dans les sessions de terminal interactives où le contournement des permissions est disponible, les blocages du mode plan ne sont pas appliqués. Si vous avez démarré avec une option de contournement des permissions ou défini bypassPermissions comme mode par défaut, démarrez une nouvelle session sans cela lorsque vous voulez une phase de planification garantie en lecture seule. Les fichiers de plan du mode plan lui-même peuvent aussi être écrits : un nouveau fichier dans votre répertoire de plans est donc normal.

Le paramètre de mon projet ne démarre pas VS Code en mode plan

C'est normal : l'extension ne lit jamais le fichier .claude/settings.json d'un projet pour son mode de départ. Utilisez le paramètre VS Code claudeCode.initialPermissionMode présenté plus haut, ou choisissez Plan dans l'indicateur de mode.

Le plan est trop vague ou trop long

• Choisissez No, keep planning et demandez des précisions : « liste chaque fichier que tu vas modifier et les tests que tu vas ajouter ».
• Réduisez la tâche. Un plan par fonctionnalité fonctionne mieux qu'un plan pour toute une feuille de route.
• Orientez Claude vers le bon code avec des références de fichiers @ pour qu'il ne dépense pas de contexte à explorer des dossiers sans rapport.
• Pour les grandes bases de code, demandez à Claude d'utiliser un sous-agent pour la recherche, afin que seules les conclusions arrivent dans votre contexte principal.

J'ai approuvé par erreur

Appuyez sur Échap pour arrêter Claude en cours de tour ; il conserve le travail déjà effectué. Appuyez ensuite deux fois sur Échap avec une invite vide pour ouvrir le menu de retour en arrière (rewind) et restaurer le code et la conversation à un point antérieur, ou utilisez git pour annuler les modifications. Appuyez sur Shift+Tab pour revenir en mode plan avant de continuer.

Coûts et plans qui l'incluent

Le mode plan est une fonction intégrée de Claude Code, pas une option payante : il est disponible partout où vous pouvez utiliser Claude Code, avec les abonnements Pro, Max, Team et Enterprise, ou avec la facturation de l'API Claude. La planification consomme tout de même des tokens, puisque Claude lit des fichiers et raisonne dessus, mais un plan court coûte généralement moins cher que de jeter une mauvaise implémentation. Sur les plans Enterprise et les comptes facturés via l'API, Anthropic précise que les vérifications du classifieur du mode auto comptent aussi dans l'usage de tokens. Consultez les prix de Claude Code et les prix de l'API Claude pour les tarifs actuels, ou Claude est-il gratuit ? pour ce que vous pouvez faire sans payer.

Les étudiants et les mainteneurs open source peuvent bénéficier d'un accès réduit ou gratuit : voir la réduction étudiante Claude et Claude for Open Source. Si vous n'avez pas encore installé Claude Code, commencez par comment installer Claude Code, et si vous utilisez une clé API plutôt qu'un abonnement, consultez comment obtenir une clé API Anthropic.