Claude Code Plan Mode : Analyser Avant de Coder

Mis à jour le 3 mars 2026

Tu connais ce moment où tu demandes à Claude Code de modifier quelque chose et il touche à 10 fichiers en même temps ? Le Plan Mode existe pour éviter ça. C'est le mode lecture seule de Claude Code, il analyse, il planifie, il te montre ce qu'il va faire. Et toi, tu valides avant qu'il ne touche à quoi que ce soit.

Le Plan Mode est une fonctionnalité native de Claude Code. Elle te permet de passer en mode "réflexion" où l'IA explore ton projet, comprend son architecture, identifie les fichiers concernés par ta demande, et te propose un plan structuré. Tout ça sans écrire la moindre ligne de code, sans modifier le moindre fichier, sans exécuter la moindre commande. C'est de l'analyse pure.

Que tu sois en train de Vibe Coder sur un nouveau projet ou que tu explores une base de code existante, le Plan Mode est ton filet de sécurité. Ce guide couvre tout : activation, cas d'usage, workflow recommandé, et comparaison avec le mode normal.

C'est quoi le Plan Mode ?

Le Plan Mode est le mode lecture seule de Claude Code. Il analyse ton projet, explore les fichiers, comprend l'architecture, sans rien modifier. Tu obtiens un plan d'action que tu valides avant toute modification.

En mode normal, Claude Code a accès à tous ses outils : il peut lire des fichiers, les modifier, en créer de nouveaux, exécuter des commandes dans ton terminal. C'est pratique et productif, mais ça veut aussi dire qu'une instruction mal formulée peut déclencher une cascade de modifications non souhaitées.

Le Plan Mode verrouille les outils d'écriture. Quand il est activé, Claude Code peut utiliser :

• Read : lire le contenu de n'importe quel fichier de ton projet
• Grep : chercher des patterns dans ton code (une fonction, une variable, un import)
• Glob : trouver des fichiers par nom ou par extension

Mais il ne peut pas utiliser :

• Write : créer ou réécrire des fichiers
• Edit : modifier des fichiers existants
• Bash : exécuter des commandes système (npm install, git commit, etc.)

Le résultat : Claude Code réfléchit, analyse, propose. Mais il n'agit pas. C'est toi qui décides quand passer à l'action, et si le plan proposé te convient. Pour les vibecoders qui débutent avec Claude Code, c'est une sécurité considérable. Tu ne risques plus de te retrouver avec 15 fichiers modifiés sans comprendre pourquoi.

Comment activer le Plan Mode ?

Trois façons d'activer le Plan Mode, selon ta situation.

En cours de session : Shift+Tab x2

C'est la méthode la plus courante. Tu es en pleine session Claude Code, tu veux passer en mode analyse avant de lancer une modification importante. Appuie sur Shift+Tab deux fois. L'indicateur de mode change dans l'interface, tu vois que tu es passé en Plan Mode. Pour revenir en mode normal, même raccourci : Shift+Tab deux fois.

C'est un toggle, un interrupteur. Tu bascules entre les deux modes autant de fois que tu veux dans une même session. L'historique de conversation est conservé. Si Claude Code a analysé 10 fichiers en Plan Mode, il garde cette connaissance quand tu repasses en mode normal pour implémenter.

Au lancement : --permission-mode plan

Tu peux démarrer Claude Code directement en Plan Mode avec un flag de ligne de commande :

claude --permission-mode plan

Utile quand tu sais d'avance que tu veux d'abord analyser avant de modifier. Par exemple, quand tu ouvres un projet pour la première fois et que tu veux comprendre sa structure avant de toucher à quoi que ce soit.

En mode headless : analyse automatisée

Le mode headless (sans interface interactive) combiné avec le Plan Mode est puissant pour de l'analyse automatisée :

claude --permission-mode plan -p "analyse le système d'authentification et liste les failles potentielles"

Claude Code va explorer le projet, analyser le code d'auth, et te retourner un rapport, sans rien modifier. C'est parfait pour de l'audit de code, de la revue d'architecture, ou de l'exploration de projet. La commande -p passe l'instruction directement sans ouvrir la session interactive.

Ouvrir le plan dans l'éditeur : Ctrl+G

Une fois que Claude Code a généré un plan en Plan Mode, tu peux appuyer sur Ctrl+G pour ouvrir ce plan dans ton éditeur de texte. Tu peux alors le modifier directement, ajouter des étapes, en supprimer, reformuler des points. C'est un moyen de collaborer avec l'IA sur la stratégie avant l'exécution.

Quand utiliser le Plan Mode ?

Le Plan Mode n'est pas fait pour tout. Il ralentit le workflow, volontairement. Voici les situations où ce ralentissement vaut le coup.

Modifications multi-fichiers

Tu veux ajouter un système de notifications qui touche le backend, le frontend, et la base de données. Plutôt que de laisser Claude Code foncer et modifier 12 fichiers d'un coup, active le Plan Mode. Demande-lui de lister tous les fichiers concernés, l'ordre des modifications, et les dépendances entre les changements. Tu valides le plan, tu passes en mode normal, et l'implémentation suit une logique claire.

Exploration d'un projet inconnu

Tu récupères un projet existant, le code d'un client, un repo open source, un projet d'un collaborateur. Avant de toucher à quoi que ce soit, tu veux comprendre comment c'est structuré. Le Plan Mode est parfait pour ça. "Analyse la structure du projet, identifie les fichiers principaux, décris l'architecture." Claude Code va scanner, lire, et te faire un résumé clair. Zéro risque de casser quelque chose.

Décisions d'architecture

Tu hésites entre deux approches pour implémenter une fonctionnalité. En Plan Mode, tu peux demander à Claude Code d'analyser les deux options, de lister les avantages et inconvénients de chacune, et de recommander celle qui s'intègre le mieux dans le code existant. C'est un deuxième avis gratuit, basé sur une analyse concrète de ton projet.

Investigation de bugs complexes

Un bug affecte plusieurs fichiers et tu ne sais pas d'où il vient. En Plan Mode, Claude Code peut tracer le flux de données, identifier les endroits où le bug pourrait se produire, et proposer des hypothèses de root cause, le tout sans risquer d'introduire un nouveau bug en modifiant du code à l'aveugle. Pour les sessions de debug avec Claude Code, c'est la première étape recommandée.

Validation d'approche avant exécution

Tu veux t'assurer que Claude Code a bien compris ce que tu attends avant de le laisser agir. Le Plan Mode te donne une preview de son raisonnement. Si le plan ne correspond pas à ce que tu voulais, tu corriges l'instruction. Mieux vaut corriger un plan en 30 secondes que réparer 10 fichiers mal modifiés.

Pour approfondir, consulte aussi : travailler en sessions parallèles avec les Worktrees.

Comment fonctionne le workflow Exploration, Plan, Implémentation ?

Le Plan Mode prend tout son sens quand il s'inscrit dans un workflow structuré. C'est le workflow en trois temps que les utilisateurs avancés de Claude Code utilisent systématiquement pour les tâches complexes.

Étape 1 : Exploration en Plan Mode

Active le Plan Mode (Shift+Tab x2). Décris ce que tu veux faire et demande à Claude Code d'analyser le terrain :

"Je veux ajouter un système d'authentification par email. Analyse le projet et dis-moi ce qui existe déjà, quels fichiers seront concernés, et quelle approche tu recommandes."

Claude Code va lire les fichiers existants, identifier les patterns en place, comprendre la stack technique, et te présenter son analyse. À ce stade, aucun fichier n'est touché. Tu as une vision claire de la situation.

Étape 2 : Revue et affinage du plan

Claude Code te propose un plan. Tu le lis. Tu poses des questions. Tu demandes des précisions. "Pourquoi tu veux créer un fichier séparé pour le middleware auth ?", "Est-ce que ça va casser le formulaire de contact existant ?", "Quelle bibliothèque tu comptes utiliser pour le hash des mots de passe ?"

C'est un dialogue. Tu affines le plan jusqu'à ce qu'il te convienne. Si tu veux modifier le plan directement, Ctrl+G l'ouvre dans ton éditeur. Cette étape de revue est ce qui fait la différence entre un projet qui avance proprement et un projet qui accumule de la dette technique.

Étape 3 : Implémentation en mode normal

Le plan est validé. Tu repasses en mode normal (Shift+Tab x2). Claude Code a gardé en mémoire toute son analyse et le plan convenu. Tu lui dis "Exécute le plan" et il implémente, fichier par fichier, dans l'ordre prévu. Tu valides chaque modification au fur et à mesure.

Ce workflow en trois temps est la façon la plus sûre de gérer les changements complexes. Il est recommandé dès que ta modification touche plus de 3 fichiers, implique de la logique métier, ou modifié de l'architecture existante. Les sub-agents de Claude Code utilisent d'ailleurs un agent "Plan" dédié qui fonctionne exactement sur ce principe. Pour les projets plus ambitieux, tu peux combiner le Plan Mode avec les worktrees pour travailler en sessions parallèles, planifier dans ta session principale et déléguer l'exécution dans un worktree isolé.

Quelle est la différence entre Plan Mode et mode normal ?

Les deux modes sont complémentaires. Le Plan Mode n'est pas "meilleur" que le mode normal, il a un usage différent.

Utilise le Plan Mode quand : la tâche est complexe, tu ne connais pas bien le projet, les modifications touchent plusieurs fichiers, ou tu veux une validation avant l'action. En résumé, quand les enjeux sont élevés et que tu ne veux pas de surprise.

Utilise le mode normal quand : la tâche est simple et claire, tu sais exactement ce que tu veux, la modification concerne un ou deux fichiers, ou tu fais des corrections rapides. En résumé, quand le risque est faible et que tu veux avancer vite.

L'erreur la plus courante : rester tout le temps en mode normal et ne jamais utiliser le Plan Mode. Les vibecoders qui débutent avec Claude Code ont tendance à foncer tête baissée. Le résultat : des modifications qu'il faut annuler, des fichiers qu'il faut restaurer, du temps perdu. Le Plan Mode te coûte 2 minutes d'analyse mais peut t'en faire gagner 30 en évitant des modifications non souhaitées.

L'autre erreur : utiliser le Plan Mode pour tout. Si tu veux juste ajouter un paragraphe dans un fichier HTML, pas besoin d'un plan d'action en 10 étapes. Le bon outil pour la bonne situation. C'est le même principe que le workflow d'exploration qu'on détaille dans le guide complet Claude Code.

Meydeey, Architecte IA & Automatisation

+110 entrepreneurs formés au Vibe Coding et à l'automatisation IA. Fondateur du Labo IA, +30K abonnés YouTube.

YouTube LinkedIn Communauté