Chapitre 2 · Chapitre 2 · Le mode Plan : ce qu'il fait vraiment
2.1 Le principe : explorer et proposer, sans modifier
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLe mode Plan est un des modes de permission de Claude Code (les réglages qui décident ce que Claude peut faire seul et ce pour quoi il doit te demander). D'après la documentation officielle, il demande à Claude de rechercher et proposer des changements sans les effectuer. Concrètement, en mode Plan, Claude :
- lit les fichiers de ton projet ;
- peut lancer des commandes pour explorer (lister des fichiers, chercher un mot dans le code…) ;
- rédige un plan ;
- ne modifie pas ton code source tant que tu n'as pas approuvé ce plan.
C'est la différence essentielle avec une demande classique : la première réponse n'est pas un ensemble de fichiers créés, mais une proposition que tu peux lire, discuter et corriger.
Les modes de permission, en bref
Pour situer le mode Plan, voici les principaux modes décrits dans la documentation :
- default (affiché « Manual ») : Claude te demande avant la plupart des actions ;
- acceptEdits : il modifie les fichiers sans te demander ;
- plan : il explore et propose, sans modifier ;
- auto : un classifieur (un système de vérification automatique) contrôle chaque action ;
- bypassPermissions : aucune demande, à réserver aux environnements isolés.
Tu n'as pas besoin de tous les retenir. Pour cette formation, deux suffisent : le mode Plan pour réfléchir, et un mode où tu valides chaque modification pour exécuter.
Qui fait la recherche pendant le plan ?
Pour préparer son plan, Claude peut confier la recherche dans tes fichiers à un sous-agent intégré qui s'appelle Plan. Un sous-agent est un assistant spécialisé, avec sa propre fenêtre de contexte (sa propre mémoire de travail) : il fouille le projet, puis seul son résumé revient dans ta conversation. Tu n'as rien à configurer pour en profiter. Retiens simplement que, sur un gros dossier, la phase d'exploration peut prendre un peu de temps : c'est normal, c'est là que Claude découvre comment ton projet est organisé.
Et les commandes lancées pendant la planification ?
La documentation précise que le traitement des commandes pendant la planification dépend de ta session :
- si le mode auto est disponible et que le réglage
useAutoModeDuringPlanest actif (il l'est par défaut), le classifieur examine les commandes à ta place : celles qu'il accepte s'exécutent, celles qu'il refuse sont bloquées ; - sinon, une commande qui ne fait pas partie de la liste des commandes en lecture seule te demande ton accord.
Dans tous les cas, l'objectif du mode Plan reste l'exploration : il n'est pas fait pour construire. Si Claude te demande l'autorisation de lancer une commande que tu ne comprends pas, demande-lui d'abord ce qu'elle fait.
Une nuance mérite d'être connue : dans une session de terminal interactive où le mode « bypass permissions » est disponible, la documentation indique que les blocages du mode Plan ne sont pas appliqués. Claude reçoit toujours la consigne de planifier sans modifier, mais une modification tentée s'exécuterait sans te demander. Si tu débutes, tu n'utilises pas ce mode, et la question ne se pose pas.
Pourquoi c'est utile même pour un petit projet
Le mode Plan n'est pas réservé aux gros projets techniques. Dès qu'une demande touche plusieurs fichiers ou implique des choix que tu n'as pas encore faits, il t'évite de découvrir ces choix après coup. Pour une petite correction dans un seul fichier, en revanche, il est inutile : une demande directe suffit.
Un test simple pour décider :
Est-ce que j'ai besoin du mode Plan ?
- ☐ La demande touche plus d'un fichier
- ☐ Elle implique un choix que je n'ai pas encore fait
- ☐ Elle concerne des données personnelles, de l'argent ou des accès
- ☐ Je ne sais pas exactement comment le projet est organisé
Une case cochée ou plus : je planifie d'abord.
Si ça coince
- Claude ne fait que lire et ne crée rien. C'est le comportement attendu en mode Plan. Il construira après ton approbation (leçon 2.3).
- L'exploration est longue. Sur un dossier rempli de fichiers, c'est normal. Tu peux préciser dans ta demande les fichiers à regarder en priorité.
- Une demande d'autorisation apparaît pendant le plan. Selon ta configuration, certaines commandes te demandent ton accord. Lis la commande, demande une explication si besoin, et refuse si elle modifie quelque chose.
- Des fichiers ont été modifiés pendant le plan. Vérifie que tu n'es pas dans une session où le mode bypass permissions est disponible, puisque les blocages n'y sont pas appliqués.
À retenir
- Le mode Plan explore et propose ; il ne modifie pas ton code source avant ton accord.
- Ta première réponse est un plan à discuter, pas un projet déjà construit.
- Le sous-agent intégré Plan fait la recherche pendant le mode Plan et renvoie un résumé.
- Il est utile dès qu'une demande implique plusieurs fichiers ou des décisions non prises.