Cours Vibe coding avec Claude Code · Module 1: Claude Code et Cursor
Comment travaille Claude Code : la boucle de l'agent, les modes de permission et le mode plan
Dans cette leçon9
Ohé ! Ton équipage écrit déjà des fichiers et lance des commandes, et tu sais lire ses ordres dans le terminal. Avant de confier une tâche plus grosse, tu dois savoir ce que Claude voit, ce qu'il ignore et ce qu'il a le droit de faire sans demander. Tu découvriras aussi le mode où Claude commence par dessiner la carte, et ne saisit les rames qu'ensuite.
Problème : Claude a fait quelque chose d'inattendu
Tu demandes une « section sur l'équipage », et peu après le dossier contient un nouveau fichier de styles, le titre a changé de couleur, et la page affiche trois images qui n'existaient pas. Claude n'a pas agi par malice : il a comblé à sa façon les trous de ta demande, et il l'a fait sans demander, parce que le mode de la session le lui permettait. Pour piloter un agent au lieu de le regarder faire, tu dois comprendre deux choses : ce que Claude voit quand il travaille, et quelles permissions il a.
Ce que Claude voit
Dans la leçon 0_1, tu as découvert la boucle de l'agent : Claude rassemble du contexte, agit et vérifie le résultat, et tu peux l'interrompre à tout moment. Le contexte, c'est tout ce que Claude a sous les yeux dans une conversation donnée. Il se compose de plusieurs sources :
- les fichiers du projet : Claude les lit lui-même quand il juge qu'ils sont utiles, donc tu n'as pas besoin de les coller dans la conversation ;
- les résultats des commandes qu'il a lancées, par exemple la liste des fichiers donnée par
ls; - l'état de Git, quand le projet l'utilise : les changements depuis le dernier enregistrement et l'historique (tu les découvriras dans la leçon 0_6) ;
- tes demandes et toute la conversation jusque-là.
Grâce à cela, Claude s'oriente vite dans le projet : l'organisation des fichiers et les styles déjà présents, il les trouve plus vite que tu ne les décrirais.
Ce que Claude ignore
Bien plus important : ce qui n'est pas dans le projet. Claude ne connaît pas :
- ton but : pour qui est le site, pourquoi il existe et quelle ampleur tu imagines ;
- les décisions prises hors du dossier : si tu as convenu avec un ami que le site sera aux couleurs de la Perle Noire, Claude ne l'apprendra que de toi ;
- l'écran du navigateur : il voit le code de la page, mais pas son aspect une fois ouverte, tant que tu ne le décris pas ou que tu ne montres pas une capture d'écran.
La documentation de Claude Code cite cela comme une cause fréquente de session ratée : quand Claude a construit autre chose que ce que tu avais en tête, il lui manquait en général une information impossible à lire dans le dépôt, c'est-à-dire le dossier du projet et son historique. La leçon pour le capitaine : dans ta demande, écris surtout ce que Claude ne trouvera pas dans les fichiers.
Hallucinations : un ton assuré n'est pas une preuve
Un modèle de langage peut affirmer avec assurance quelque chose de faux. On appelle une telle invention une hallucination. Claude peut annoncer qu'il a ajouté une image bateau.png alors que ce fichier n'existe pas dans le dossier, ou écrire l'adresse d'une image qui n'existe pas. Le remède, c'est de demander une preuve : une commande et son résultat, ou un extrait de fichier. Quand le rapport ne correspond pas à ce que tu vois dans Cursor, écris par exemple :
Montre le résultat de la commande ls et l'extrait de pirate.html où se trouve cette image.Si ls n'affiche pas bateau.png, tu as la preuve noir sur blanc que l'image n'existe pas, et tu demandes une correction. La simple demande de preuve ne change rien dans les fichiers : Claude ne fait que lire et montrer, donc il ne demandera pas ton accord, même en mode Manual.
Les modes de permission
Le mode de permission décide de ce que Claude peut faire sans demander. Dans la leçon 0_2, tu as fait passer la session du mode auto au mode Manual. Voici l'aide-mémoire des quatre modes que tu utiliseras ; le libellé de la deuxième colonne s'affiche dans la barre d'état sous le champ de saisie :
| Mode | Libellé dans la barre | Ce que Claude fait sans demander | Quand l'utiliser |
|---|---|---|---|
| auto | auto mode on | tout, et un autre modèle en arrière-plan évalue les actions et bloque les risquées | longues tâches, quand tu sais déjà lire les changements |
| Manual | manual mode on | seulement lire ; il demande pour modifier des fichiers et pour les commandes qui changent quelque chose | premiers lieux et travail sensible |
| acceptEdits | accept edits on | modifie les fichiers et lance dans le dossier du projet des commandes de fichiers simples, comme mkdir, touch, mv, cp et rm ; il demande pour les autres commandes | quand tu préfères lire les changements dans Cursor après coup |
| plan | plan mode on | lit et explore le projet, mais ne modifie aucun fichier tant que tu n'as pas accepté le plan | avant tout changement important |
La touche Maj+Tab fait passer d'un mode au suivant. La session du terminal démarre en mode auto, donc les appuis successifs donnent ce cycle :
auto → Manual → acceptEdits → plan → autoLe cycle se referme : après le mode plan, tu reviens à auto. Tu peux aussi choisir le mode dès le démarrage de la session, en ajoutant l'option --permission-mode, c'est-à-dire un réglage supplémentaire de la commande claude :
claude --permission-mode planCette commande lance la session directement en mode plan. À la place de plan, tu peux écrire manual ou acceptEdits. L'option ne vaut que pour cette session : les suivantes redémarreront en mode auto.
Il existe encore un mode bypassPermissions, qui valide presque tout sans rien demander : la documentation le réserve aux conteneurs et aux machines virtuelles isolés, que l'on peut jeter, donc tu ne l'actives pas sur ton propre ordinateur.
Le conseil du capitaine : reste en Manual tant que la lecture des changements n'est pas devenue un réflexe, et passe au plan avant un changement important. Méfie-toi du piège que la documentation signale elle-même : après la dixième demande d'accord, on se met facilement à choisir Yes sans lire. Si tu le remarques, fais une pause, ou passe en acceptEdits et lis les changements dans Cursor.
Le mode plan
En mode plan, Claude explore et propose, mais ne change rien. Il lit les fichiers, il peut lancer des commandes pour regarder autour de lui, et il écrit un plan. Il n'édite aucun fichier tant que tu n'as pas accepté le plan. C'est le conseil devant la carte, avant que le navire quitte le port.
Tu entres en mode plan de trois façons : en appuyant sur Maj+Tab jusqu'à ce que la barre affiche plan mode on ; en commençant une demande isolée par /plan ; ou en lançant la session avec l'option --permission-mode plan. Tu en sors avec un nouveau Maj+Tab, qui, selon le cycle, t'amène au mode auto ; si tu préfères Manual, appuie encore une fois sur Maj+Tab.
Passe la session en mode plan et donne l'ordre :
Demande pour Claude Code :
Planifie l'ajout à pirate.html d'une section « Notre équipage » avec trois
cartes de personnages : le capitaine, la timonière et le cuisinier de
bord. Chaque carte a un prénom, un rôle et une phrase de description.
Ne modifie encore aucun fichier. Écris quels fichiers tu changeras, ce
que tu ajouteras et comment nous vérifierons que la section fonctionne.La demande dit ce qui doit naître, où, et à quoi l'on reconnaîtra que c'est fini. La phrase « ne modifie encore aucun fichier » est ici une précaution supplémentaire, puisque le mode plan bloque de toute façon les modifications.
Ce que Claude a préparé
Peu après, Claude affichera un plan. Le tien peut avoir d'autres mots, mais il devrait y ressembler. Le plan emploie quelques noms nouveaux du HTML et du CSS : h2 et h3 sont des titres de deuxième et de troisième niveau, <section> regroupe une partie de la page, et <article> est un morceau de contenu autonome, ici une carte. Une classe est un nom donné à des éléments, grâce auquel une seule règle CSS les met tous en forme à la fois :
Plan : section « Notre équipage » dans pirate.html
1. Dans <body>, sous le paragraphe d'accueil, j'ajoute une <section> avec
un titre h2 « Notre équipage ».
2. Dans la section, trois éléments <article> de classe crew-card : un h3
avec le prénom, un paragraphe avec le rôle et un paragraphe avec la
description.
3. Dans <style>, j'ajoute une règle .crew-card : une bordure et un espace
entre les cartes.
4. Je ne crée aucun nouveau fichier et n'ajoute aucune bibliothèque.
Vérification : ouvre pirate.html dans le navigateur ; sous l'accueil tu
verras trois cartes, et le titre « Ohé les Pirates ! » ne changera pas.Le plan cite un seul fichier, trois étapes de construction, ce que Claude ne fera pas, et la manière de vérifier le résultat. Pour l'instant, rien n'a changé : pirate.html dans Cursor a le même aspect qu'avant la demande.
Sous le plan, Claude demandera la suite. Tu as le choix entre :
- Yes, and use auto mode : tu approuves le plan, la session passe en mode auto, et Claude construit sans demander ;
- Yes, manually approve edits : tu approuves le plan, mais tu valides toi-même chaque modification de fichier ;
- No, keep planning : tu restes en mode plan et tu écris ce qu'il faut corriger dans le plan.
Tu peux aussi corriger le plan toi-même : Ctrl+G l'ouvre dans ton éditeur de texte par défaut, où tu ajoutes ou barres des points avant que Claude commence. Si tu ne sais pas quel éditeur s'ouvrira, choisis simplement No, keep planning et décris la correction avec des mots. Attention au piège : quand Claude attend ta décision, Maj+Tab approuve le plan. Pour quitter la planification sans l'accepter, appuie d'abord sur Échap, puis seulement sur Maj+Tab.
La revue du capitaine
Avant d'approuver le plan, vérifie quatre choses :
- Les fichiers : le plan ne modifie que
pirate.html. Tout nouveau fichier doit avoir une bonne raison. - Pas de lest : le plan n'ajoute ni bibliothèques ni frameworks. L'erreur typique d'un agent est un plan « en réserve », par exemple un framework ou un dossier de composants séparé pour une seule page HTML. Tu la repères aux mots « j'installe » et « npm install », ou à une longue liste de nouveaux fichiers.
- La vérification : le plan dit comment tu contrôleras le résultat.
- Les endroits intouchables : le plan ne touche pas à ce qui marche déjà, c'est-à-dire le titre « Ohé les Pirates ! » et sa couleur.
Si quelque chose ne va pas, choisis No, keep planning et écris par exemple : « Pas de nouveaux fichiers, les styles seulement dans la balise style ».
Étape suivante
Quand le plan a passé la revue, choisis Yes, manually approve edits. Claude se met à construire, et tu valides chaque modification comme dans la leçon 0_2. Ensuite, ouvre pirate.html dans Cursor et dans le navigateur : sous l'accueil, trois cartes doivent apparaître. Dans la leçon 0_5, tu apprendras à écrire des demandes pour que Claude tombe juste du premier coup.
Retiens : d'abord la carte, ensuite la traversée ; le mode plan est la carte que tu lis avant que l'équipage saisisse les rames.
Code de cette leçon : index.html
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<title>Ohé les Pirates !</title>
<style>
h1 {
color: red;
}
.crew-card {
border: 2px solid #333;
padding: 12px;
margin: 12px 0;
}
</style>
</head>
<body>
<!-- Voici à quoi peut ressembler pirate.html après l'approbation du plan de la leçon 0_4. -->
<!-- Ton fichier écrit par Claude Code peut avoir d'autres noms et descriptions. -->
<h1>Ohé les Pirates !</h1>
<p>Bienvenue à bord ! Notre aventure commence ici.</p>
<section>
<h2>Notre équipage</h2>
<article class="crew-card">
<h3>Barbe-Rousse</h3>
<p>Capitaine</p>
<p>Il trace le cap et lit chaque carte avant de lever l'ancre.</p>
</article>
<article class="crew-card">
<h3>Léa Boussole</h3>
<p>Timonière</p>
<p>Elle tient la barre d'une main sûre, même quand les vagues montent jusqu'au mât.</p>
</article>
<article class="crew-card">
<h3>Bastien Marmite</h3>
<p>Cuisinier de bord</p>
<p>Il prépare une soupe de poisson qui remet sur pied tout l'équipage.</p>
</article>
</section>
</body>
</html>Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Que ne sait pas Claude Code tant que tu ne le lui as pas dit ?
2. Claude annonce qu'il a ajouté à la page une image bateau.png, mais tu ne vois pas ce fichier dans l'Explorateur. Que fais-tu ?
3. Que fait Claude Code sans demander en mode acceptEdits ?
4. Que fait Claude Code en mode plan ?
Tâches pratiques dans le jeu
- Tri horizontal
Assemble la commande qui lance la session Claude Code directement en mode plan (sur une seule ligne) :
- Tri vertical
Range dans le bon ordre les étapes du travail en mode plan :