Cours Vibe coding avec Claude Code · Module 1: Claude Code et Cursor
Le filet de sécurité : Échap, /rewind et Git comme journal de bord
Dans cette leçon11
Ohé ! Ton site a son accueil et sa section d'équipage avec des cartes de parchemin. C'est déjà une cargaison qu'il serait dommage de perdre. Dans la dernière leçon de ce lieu, tu vas tendre sous le pont un filet de sécurité grâce auquel presque toute erreur de l'équipage peut être annulée.
Problème : une demande et plus rien ne marche
Le site fonctionnait. Tu as donné une nouvelle demande, Claude a modifié plusieurs endroits, et maintenant les cartes se chevauchent et le titre a disparu. Te souviens-tu de l'aspect de la version qui marchait ? Sais-tu quelles lignes ont changé ? Sans filet, il te reste à reconstituer de mémoire, péniblement. Avec un filet, tu reviens au port en quelques secondes.
Trois cordages
Le filet est fait de trois cordages. Chacun retient autre chose, donc tu as besoin des trois :
| Cordage | Ce qu'il fait | Ce qu'il ne fait pas |
|---|---|---|
| Échap | interrompt Claude en plein travail et garde ce qu'il a déjà fait | n'annule pas les changements que Claude a déjà enregistrés |
/rewind | ramène les fichiers, la conversation ou les deux à l'instant avant la demande choisie | n'annule pas les fichiers modifiés uniquement par une commande du terminal, ni rien en dehors des fichiers |
| Git | enregistre un historique durable du projet, où tu peux revenir même après une semaine | n'enregistre rien tout seul : le commit, c'est toi qui le fais, ou Claude à ta demande |
Tu connais Échap depuis la leçon 0_2 : c'est le frein. Quand tu vois que Claude fait fausse route, appuie dessus tout de suite, puis écris ce qu'il doit faire autrement.
Les checkpoints et /rewind de près
Avant chacune de tes demandes, Claude Code mémorise l'état des fichiers qu'il modifie avec ses outils d'édition. Cet état mémorisé s'appelle un checkpoint, c'est-à-dire un point de contrôle. Tu ouvres le menu d'annulation avec la commande /rewind (le nom plus court /undo marche aussi) ou en appuyant deux fois sur Échap quand le champ de saisie est vide. Dans la liste, tu choisis la demande, puis l'action : restaurer le code et la conversation, seulement la conversation, ou seulement le code. Les options de restauration du code n'apparaissent que si des fichiers suivis ont changé après la demande choisie.
Les checkpoints ont cependant des limites que tu dois connaître avant de t'y fier :
- les commandes du terminal : un fichier modifié uniquement par une commande, par exemple
rmoumv, n'est pas suivi et reste tel qu'il est ; - les effets hors des fichiers : des données envoyées à une base ou à un autre service, le déploiement d'un site sur un serveur ou des commits envoyés par
git pushne reviendront pas, car le checkpoint ne mémorise que les fichiers ; - les sous-agents : un sous-agent est un assistant que Claude peut envoyer sur une tâche à part, en général en arrière-plan ; tu les découvriras dans les lieux suivants. Les changements qu'un sous-agent fait dans des fichiers que ta conversation n'avait pas touchés restent après
/rewind; - tes modifications manuelles : ce que tu changes toi-même dans les fichiers en dehors de Claude Code n'entre en général pas dans les checkpoints.
La documentation le dit sans détour : les checkpoints servent à annuler vite au sein d'une session et ne remplacent pas un système de gestion de versions comme Git.
Git : le journal de bord
Dans la leçon 0_3, tu as découvert en bref quatre commandes de Git. Maintenant, tu vas vraiment t'en servir. Deux mots pour commencer : le dépôt est un dossier dont Git tient l'historique, et un commit est un état enregistré des fichiers, avec une description, auquel tu peux toujours revenir. Tu n'as pas à taper les commandes toi-même : Claude Code conduit Git par la conversation, et tu lis ce qu'il lance.
Vérifie d'abord que tu as Git : tape dans la session ! git --version. Si tu vois un numéro de version, tout est prêt. Si tu vois command not found, demande à Claude comment installer Git sur ton système, et lis chaque commande avant d'accepter. Sous Windows, ce sera Git for Windows, dont il était question dans la leçon 0_2.
Demande pour Claude Code :
Initialise un dépôt Git dans ce dossier et fais un premier commit avec
une description de ce qu'il y a sur la page. Avant de lancer une
commande, dis en une phrase ce qu'elle va faire.Ce qu'a fait Claude
En mode Manual, Claude demandera ton accord pour chaque commande qui change quelque chose. Tu liras à peu près ces trois-là :
git init
git add pirate.html
git commit -m "Page pirate.html : accueil et section Notre équipage"git init crée dans le dossier un dossier caché .git, où Git garde tout l'historique ; il ne modifie pas tes fichiers. git add marque des fichiers pour l'enregistrement : Claude peut désigner un seul fichier ou utiliser git add . vu dans la leçon 0_3. git commit -m enregistre l'état avec une description entre guillemets. Rien ne part sur internet : sans git push, l'historique reste sur ton ordinateur.
Git ajoute à chaque commit le nom et l'adresse e-mail de l'auteur. Si tu ne les as jamais réglés, Claude peut te les demander ou proposer ces deux commandes :
git config --global user.name "Anne Dupont"
git config --global user.email anne@example.comL'option --global enregistre ces données une fois pour tout l'ordinateur, donc dans les projets suivants Git n'en a plus besoin. Écris tes propres données, pas l'exemple.
Ce que l'on voit dans Cursor
Ouvre dans Cursor la vue Source Control, par exemple par la palette de commandes (Cmd+Maj+P sur Mac, Ctrl+Maj+P sous Windows et Linux) : tape Source Control et choisis la vue de ce nom. Juste après le commit, la liste des changements est vide, car tout ce qui est dans le dossier a été enregistré.
Maintenant, demande à Claude un petit changement, par exemple une quatrième carte pour le maître d'équipage. Quand Claude l'a enregistré, pirate.html apparaît dans la liste de Source Control. Clique dessus, et Cursor affiche la comparaison entre la version du dernier commit et la version actuelle, en général avec les lignes supprimées en rouge et les lignes ajoutées en vert. Cette comparaison, appelée diff, tu la lis avant chaque commit suivant. Quand le diff te convient, écris à Claude : « Fais un commit avec la description de ce changement ». Tu peux aussi le vérifier par la conversation : demande « qu'est-ce qui a changé depuis le dernier commit ? » ou « montre les derniers commits ».
La boucle de travail avec point de contrôle
Désormais, chaque changement sur le navire passe par la même boucle :
1. commit : enregistre l'état qui fonctionne
2. demande pour Claude Code
3. contrôle : le diff dans Source Control et la page dans le navigateur
4. bien ? commit avec description. mal ? /rewind et une meilleure demandeLa boucle commence par un commit, car c'est lui le point de retour. Si, à l'étape 4, le problème est hors de portée de /rewind, par exemple dans un fichier modifié par une commande, demande à Claude de restaurer ce fichier depuis le dernier commit, et lis la commande avant d'accepter.
Teste le filet en pratique. Donne exprès une mauvaise demande, par exemple « remplace toute la page par un seul grand mot TRÉSOR ». Quand Claude a fini, tape /rewind, choisis cette demande et Restore code. Dans Source Control, la liste des changements est de nouveau vide : le fichier est revenu à l'état du commit.
Quand tu lis chaque ligne
Le vibe coding les yeux ouverts, c'est toujours lire les changements. Il y a pourtant des endroits où tu lis chaque ligne avant d'utiliser le code, et si tu ne comprends pas quelque chose, tu interroges Claude jusqu'à comprendre :
- les secrets : mots de passe, clés API et tout ce qui donne accès à des comptes ;
- les paiements : tout code qui touche à l'argent ;
- les données d'autres personnes : prénoms, adresses e-mail, messages, photos ;
- les commandes que tu ne comprends pas :
rm -rf,sudo,curlavec une adresse inconnue relié àbashet les autres de la leçon 0_3.
Ici, l'erreur ne se termine pas par une page moche, mais par une fuite ou une perte qu'aucun cordage n'annule.
Les secrets hors du dépôt
Les projets qui se connectent à d'autres services gardent leurs secrets, comme les clés API, dans un fichier .env. Ce fichier ne doit jamais entrer dans le dépôt, car l'historique de Git voyage avec le code partout où tu l'envoies. Le fichier .gitignore en protège : c'est la liste des fichiers que Git doit ignorer. Crée-le tout de suite, avant qu'un .env existe :
Demande pour Claude Code :
Crée un fichier .gitignore avec la ligne .env, pour que Git n'enregistre
jamais le fichier de secrets. Fais un commit avec la description de ce
changement.Le .gitignore prêt n'a pour l'instant qu'une seule ligne, c'est-à-dire le nom du fichier à ignorer :
.envDésormais, Git ignorera tout fichier nommé .env dans ce dossier et ses sous-dossiers. Si tu vois aussi .claude/settings.local.json dans Source Control, ce sont tes réglages personnels de Claude Code, par exemple le style de réponse de la leçon 0_5 : demande à Claude d'ajouter ce fichier au .gitignore.
Attention : .gitignore n'agit pas sur les fichiers que Git suit déjà. Si .env est entré plus tôt dans un commit, la simple ligne ne suffit pas et il faut retirer le fichier du dépôt avec une commande qui le laisse sur le disque :
git rm --cached .envAprès cette commande et un nouveau commit, Git cesse de suivre .env, mais les anciens commits le contiennent toujours. Une clé qui est une fois entrée dans l'historique, considère-la donc comme grillée et génères-en une nouvelle. Dans les lieux suivants, tu ajouteras encore une règle qui interdira tout simplement à Claude de lire .env.
La revue du capitaine
- Un commit avant un gros changement : avant de donner une grosse demande, la liste de Source Control doit être vide, et le dernier bon état enregistré.
- Les secrets : le
.gitignoreavec la ligne.envest dans le dépôt, et.envn'apparaît pas dans Source Control. - La description du commit : l'erreur typique d'un agent est une description du genre « update files », dont tu ne tireras rien dans une semaine. Demande une description précise : ce qui a changé et pourquoi.
- La preuve : après le commit, demande à Claude la liste des derniers commits et vérifie que le tien est en haut.
Étape suivante
Tu as tout ce qu'il faut : Claude Code comme équipage, Cursor comme longue-vue, des demandes en quatre briques, le mode plan et le filet de sécurité. À la fin de ce lieu, tu montreras à ton mentor ton navire prêt à prendre la mer. Dans le lieu suivant, tu créeras avec Claude Code ton premier projet Next.js, et tu répéteras la même boucle pour chaque fonctionnalité.
Retiens : le journal de bord s'écrit avant la tempête, pas après.
Code de cette leçon : boucle-de-travail.md
# Journal de bord : la boucle de travail
1. Commit : enregistre un état qui fonctionne.
2. Demande pour Claude Code : but, endroit, contraintes, vérification.
3. Contrôle : le diff dans Source Control et la page dans le navigateur.
4. Bien ? Commit avec une description précise. Mal ? /rewind et une meilleure demande.
## Ce que /rewind n'annule pas
- les fichiers modifiés uniquement par une commande du terminal,
- les effets hors des fichiers : base de données, déploiement, git push,
- les changements des sous-agents dans des fichiers que Claude n'avait pas édités avant.
## Je lis chaque ligne quand le code touche à
- des secrets : mots de passe, clés API, fichier .env,
- des paiements,
- des données d'autres personnes,
- des commandes que je ne comprends pas.
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. Qu'est-ce que Git ?
2. Qu'est-ce que /rewind ne restaurera pas ?
3. Où vois-tu dans Cursor les fichiers modifiés depuis le dernier commit ?
4. Que fait la commande git status ?
5. Que fait la commande git push ?
6. Quand lis-tu chaque ligne du code de Claude avant de l'utiliser ?
7. Pourquoi écris-tu .env dans le fichier .gitignore avant que le premier fichier .env existe ?
Tâches pratiques dans le jeu
- Clique dans l'ordre
Clique sur les éléments dans l'ordre pour construire la commande qui valide les changements avec une description :
- Clique dans l'ordre
Clique sur les éléments dans l'ordre pour construire la commande qui ajoute tous les fichiers à Git :
- Tri vertical
Ordonne les commandes Git qui sauvegardent et envoient les changements (les unes sous les autres) :
- Tri vertical
Range les étapes de la boucle de travail avec point de contrôle :
- Tri horizontal
Le fichier .env est déjà entré dans un commit. Assemble la commande qui le retire du dépôt mais le laisse sur le disque (sur une seule ligne) :
Exercices après cette leçon
- QuestionQuiz : qu'est-ce que Git
- QuestionQuiz : ce que /rewind n'annule pas
- Clique dans l'ordreClic dans l'ordre : sauvegarder les changements dans Git
- QuestionQuiz : les fichiers modifiés dans Cursor
- Clique dans l'ordreClic dans l'ordre : ajouter des fichiers à Git
- QuestionQuiz : la commande git status
- Remets dans l'ordreTri : Git - sauvegarder les changements
- Remets dans l'ordreTri : la boucle avec point de contrôle
- QuestionQuiz : la commande git push
- QuestionQuiz : quand lire chaque ligne
- QuestionQuiz : le fichier .env et .gitignore
- Remets dans l'ordreAssemblage : retirer .env du dépôt
- Projet à envoyerMontre ton navire prêt à prendre la mer
- VidéoRésumé du module