Réponse courte : le mode plan est un mode d’autorisation de Claude Code dans lequel le modèle explore votre base de code et propose une approche sans toucher à vos fichiers. La documentation d’Anthropic le décrit précisément : en mode plan, Claude lit les fichiers et exécute des commandes shell en lecture seule pour explorer, mais ne modifie pas vos fichiers sources, et là où le mode auto est disponible, les commandes validées par le classifieur s’exécutent également. Il s’affiche sous le nom Plan dans la CLI et dans l’extension VS Code. Vous y accédez avec Shift+Tab, qui fait défiler les modes d’autorisation, ou en démarrant une session avec claude --permission-mode plan. Cela ne coûte rien de plus : c’est un mode, pas une fonction payante.
Ce que le mode comprend
Le mode plan cohabite avec les autres modes d’autorisation de Claude Code, et les différences méritent d’être connues car elles déterminent le niveau de surveillance nécessaire.
Anthropic documente les modes ainsi. default, étiqueté Manuel dans la CLI, les extensions VS Code et JetBrains et l’application de bureau, demande l’autorisation à la première utilisation de chaque outil. acceptEdits accepte automatiquement les modifications de fichiers et les commandes système courantes comme mkdir, touch, mv et cp pour les chemins situés dans le répertoire de travail ou dans additionalDirectories. plan explore sans modifier. auto approuve automatiquement les appels d’outils, avec des contrôles de sécurité en arrière-plan qui vérifient que les actions correspondent à votre demande. dontAsk refuse automatiquement les outils sauf approbation préalable. bypassPermissions saute les demandes d’autorisation, sauf pour les actions qu’aucun mode n’approuve seul.
Concrètement, le mode plan vous donne un accès complet en lecture et aucun accès en écriture. Claude peut ouvrir des fichiers, suivre les imports, exécuter des commandes shell en lecture seule pour comprendre le projet et se construire une image fidèle du fonctionnement avant de proposer un changement. Ce qu’il ne peut pas faire, c’est modifier vos sources.
Cette contrainte constitue tout l’intérêt. L’échec le plus coûteux en programmation avec agents n’est pas une mauvaise réponse, ce sont vingt modifications confiantes dans la mauvaise direction qu’il faut ensuite démêler.
Comment activer le mode plan
Trois voies, selon votre façon de travailler.
- Faire défiler avec Shift+Tab. Anthropic documente cette touche comme parcourant default, acceptEdits, plan et, lorsqu’ils sont disponibles, bypassPermissions puis auto. Depuis auto, la première pression ramène à default. Sous Windows, Alt+M fait la même chose lorsque l’environnement Node ou Bun n’active pas le mode d’entrée VT.
- Démarrer la session directement en mode plan. Passez le drapeau :
claude --permission-mode plan. La référence de la CLI note que cela permet de commencer dans un autre mode comme plan et de basculer vers bypassPermissions plus tard. - En faire une valeur par défaut pour les sessions déléguées. La même référence documente le passage de
--permission-modeaux côtés de--model,--effortou--agentpour définir des valeurs par défaut sur les sessions déléguées, utile quand vous lancez du travail en arrière-plan.
Vérifiez l’indicateur de mode avant de décrire une tâche. L’erreur la plus courante avec le mode plan consiste à croire qu’on y est alors qu’on n’y est pas.
Le schéma explorer, planifier, implémenter
Le schéma qui tire le meilleur de ce mode comporte trois étapes distinctes, et toute la discipline consiste à les garder séparées.
Explorer. En mode plan, demandez à Claude d’enquêter plutôt que de corriger. « Explique comment fonctionne l’authentification dans cette base de code, où les jetons sont renouvelés et ce qui se passe quand le renouvellement échoue. » Vous achetez un modèle mental fidèle, que vous pouvez confronter à ce que vous savez déjà, et c’est votre garde-fou sur la solidité de la suite.
Planifier. Toujours en mode plan, demandez une approche : quels fichiers changent, dans quel ordre, quels sont les risques, que faut-il tester. Demandez que ce plan soit écrit dans un fichier Markdown, pour qu’il survive à la session et puisse être relu par quelqu’un d’autre. Un bon plan nomme les fichiers, fixe la séquence et dit explicitement ce dont il n’est pas sûr.
Implémenter. Changez de mode et exécutez contre le plan validé. Comme le plan est écrit, vous pouvez vérifier chaque étape par rapport à lui au lieu de relire un gros diff sans point de repère.
La documentation des flux de travail courants couvre aussi la délégation de l’exploration à des sous-agents, ce qui s’articule naturellement ici : l’exploration est exactement le type de travail qui mérite un contexte séparé.
Ce que contient réellement un bon plan
La plupart des plans décevants le sont parce que la demande était sous-spécifiée. Un plan contre lequel il vaut la peine d’implémenter comporte cinq éléments, et les demander explicitement change beaucoup le résultat.
Il nomme des fichiers. « Mets à jour le middleware d’authentification » n’est pas un plan ; « modifie src/auth/middleware.ts et src/auth/refresh.ts, ajoute un test dans tests/auth/refresh.test.ts » en est un.
Il fixe une séquence avec une raison. Faire la migration avant le changement de code, ou l’inverse, est généralement une décision à conséquences, et un plan qui n’explique pas l’ordre est un plan qui n’y a pas réfléchi.
Il identifie ce qui peut casser. Quels appelants dépendent du comportement actuel, ce qu’il advient des requêtes en cours pendant un déploiement, si le changement est rétrocompatible.
Il dit ce dont il n’est pas sûr. C’est la section la plus précieuse et celle qu’il faut demander. Un modèle qui liste trois hypothèses qu’il n’a pas pu vérifier dans le code vous donne exactement la liste à contrôler vous-même.
Il définit la vérification. Comment vous saurez que le changement a fonctionné, formulé comme un test ou un comportement observable plutôt que « ça devrait marcher ».
Demandez ces cinq points et le plan devient un document que vous pouvez transmettre à un collègue, et non un paragraphe d’intentions.
Intérêt et comparaison des modes
| Mode | Écrit des fichiers | Idéal pour | Risque principal |
|---|---|---|---|
| default (Manuel) | Après demande à chaque fois | Travail soigneux sur du code inconnu | Lassitude des demandes et validation réflexe |
| plan | Non | Comprendre, concevoir, relire une approche | Oublier d’en sortir |
| acceptEdits | Oui, automatiquement | Changements mécaniques bien cadrés | Modifications non relues |
| auto | Oui, avec contrôles de sécurité | Travail répétitif de confiance | Excès de confiance sur des changements lourds |
| bypassPermissions | Oui, sans demande | Bacs à sable et environnements jetables | Tout |
La comparaison qui compte le plus est plan face à acceptEdits, car ce sont les deux entre lesquels on alterne réellement. Prenez plan quand vous ne savez pas encore quel est le bon changement. Prenez acceptEdits quand vous le savez et que le travail est mécanique.
Il y a aussi un argument de coût. Les longues sessions avec agents consomment du contexte, et c’est le contexte qui consomme votre quota d’utilisation. Une session qui modifie vingt minutes dans la mauvaise direction avant de faire marche arrière coûte bien plus qu’une session qui lit cinq minutes puis exécute proprement. La documentation d’Anthropic sur les coûts de Claude Code explique le fonctionnement de l’utilisation dans le terminal, et l’indicateur de contexte en direct est le chiffre à surveiller.
Forfaits, facturation et points à vérifier
Le mode plan n’est pas en soi un palier payant, et l’accès à Claude Code dépend de votre abonnement. La documentation de support d’Anthropic explique que les abonnés Pro et Max authentifient Claude Code avec les mêmes identifiants que pour Claude : un abonnement couvre donc les deux.
À confirmer sur le site officiel avant de vous y fier :
- Quels forfaits incluent Claude Code, et à quel niveau d’utilisation. La page de tarifs liste Free, Pro, Max 5x et Max 20x, Max étant décrit comme offrant 5 ou 20 fois plus d’utilisation que Pro.
- Votre cycle de facturation et si c’est le mensuel ou l’annuel qui s’applique.
- Si une variable d’environnement
ANTHROPIC_API_KEYest définie sur votre machine. Anthropic précise que dans ce cas Claude Code utilise cette clé pour s’authentifier au lieu de votre abonnement, ce qui signifie une facturation au jeton plutôt qu’une consommation de votre forfait. - Les éventuelles règles au niveau de l’organisation si vous êtes sur un forfait Team ou Enterprise, car les modes d’autorisation peuvent être restreints de façon centralisée.
Réserves sur les tarifs
Les prix, les noms des forfaits et les quotas d’utilisation évoluent, et rien sur cette page ne doit être pris pour un tarif en vigueur. Vérifiez les prix actuels sur le site officiel avant de vous engager.
Deux réserves supplémentaires méritent d’être dites clairement. D’abord, la disponibilité de chaque mode varie : la documentation d’Anthropic note que bypassPermissions et auto n’apparaissent dans le cycle que « lorsqu’ils sont disponibles », ce qui dépend de votre version et des réglages de votre organisation. Ensuite, certains libellés et alias dépendent de la version, le libellé Manuel étant documenté à partir d’une version précise de Claude Code. Si votre indicateur ne correspond pas à ce que vous lisez ici, mettez à jour avant de supposer que quelque chose est cassé.
Dépannage du mode plan
- Claude a quand même modifié des fichiers. Vous n’étiez pas en mode plan. Vérifiez l’indicateur, et rappelez-vous que Shift+Tab fait défiler au lieu de basculer : une pression de trop vous fait passer à côté.
- Le plan est vague. Les plans vagues suivent les demandes vagues. Exigez des fichiers nommés, une séquence ordonnée et une liste explicite des incertitudes.
- Il demande sans arrêt à exécuter des commandes. Le mode plan autorise les commandes shell en lecture seule. Une commande qu’il ne juge pas en lecture seule déclenchera toujours une demande, et c’est le mode qui fonctionne correctement.
- Le plan a disparu à la fin de la session. Demandez-le sous forme de fichier Markdown dans le dépôt. Un plan resté dans l’historique du terminal est un plan perdu.
- Shift+Tab ne fait rien sous Windows. Anthropic documente Alt+M comme alternative quand l’environnement Node ou Bun n’active pas le mode d’entrée VT.
Produit, cours, application et plateforme en pratique
Il existe trois façons de devenir bon à cet exercice, et elles conviennent à des profils différents. La documentation produit fait autorité et va à l’essentiel, ce qui fonctionne bien quand vous savez déjà ce que vous cherchez. L’expérimentation dans votre propre dépôt vous apprend vos modes d’échec spécifiques, mais lentement. Un cours structuré vous donne la séquence et le vocabulaire, ce qui reste la voie la plus rapide pour qui n’a pas encore d’habitudes installées.
Les équipes qui tirent le plus de ce mode traitent le plan comme le livrable de la première session, et non comme un préambule au vrai travail. Un plan écrit peut être relu par un collègue, contesté et corrigé avant qu’une seule ligne ne change, et c’est un endroit bien moins coûteux pour intercepter une mauvaise idée qu’une pull request.
Bien le faire relève davantage d’une compétence à diriger ces outils que d’une fonction en eux : savoir combien de contexte fournir, comment demander un plan vérifiable plutôt que plausible, et où l’assurance du modèle dépasse ce qu’il sait de votre système. L’apprendre dans une séquence structurée va plus vite que de le découvrir session après session, et cela se transfère à tous les outils à agents plutôt qu’à un seul produit. Si vous voulez une entrée structurée, explorez les leçons de Coursiv et vérifiez les détails de forfait en vigueur sur le site officiel.
Questions fréquentes
Claude peut-il modifier des fichiers en mode plan ?
Comment activer le mode plan ?
claude --permission-mode plan. Sous Windows, Alt+M fait défiler les modes dans les environnements qui n’activent pas le mode d’entrée VT.Le mode plan coûte-t-il plus cher ?
Le mode plan économise-t-il de l’utilisation ?
Votre prochaine étape
Lors de votre prochaine tâche non triviale, commencez en mode plan et demandez l’approche sous forme de fichier Markdown avant toute modification. Lisez-la vraiment, corrigez les deux points qu’elle a mal compris de votre système, et seulement ensuite changez de mode pour implémenter. La plupart de ceux qui essaient une fois ne travaillent plus autrement, car le plan transforme un gros diff impossible à relire en une suite d’étapes que vous aviez déjà validées.