Chapter 3 · Chapitre 3 · Échap deux fois : revenir en arrière
3.1 Les checkpoints : la sauvegarde automatique de Claude Code
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeClaude Code intègre un système de checkpoints (points de sauvegarde). D'après la documentation, il capture automatiquement l'état de ton code avant chaque prompt que tu envoies et qui démarre un tour de travail. Tu n'as rien à activer : ça fonctionne tout seul.
Concrètement, chaque fois que tu envoies une demande, Claude Code note l'état des fichiers que ses outils de modification touchent. Si quelque chose tourne mal, tu peux revenir à l'un de ces points.
Une image pour comprendre
Pense aux sauvegardes automatiques d'un jeu vidéo : à chaque nouvelle étape, le jeu enregistre où tu en es. Si tu échoues, tu repars de la dernière sauvegarde, pas du début. Les checkpoints, c'est pareil : chaque demande que tu envoies est une nouvelle étape, et tu peux revenir à l'état d'avant n'importe laquelle d'entre elles.
Ce qui est suivi
Les checkpoints suivent les modifications faites par les outils d'édition de fichiers de Claude. Ils sont enregistrés avec la conversation : tu peux donc encore revenir en arrière après avoir repris une session plus tard. La documentation précise aussi que Claude Code garde les instantanés des 100 checkpoints les plus récents d'une session, et qu'il les supprime après une période de nettoyage (environ 30 jours par défaut, réglable avec le paramètre cleanupPeriodDays).
Exemple sur le fil rouge
Sur le site de l'Atelier Lumen, tu envoies trois demandes d'affilée :
Demande 1 : Change le titre h1 de index.html en "Atelier Lumen".
Demande 2 : Ajoute un paragraphe de présentation sous le titre.
Demande 3 : Change la couleur de fond dans style.css en bleu nuit.
Avant chacune d'elles, un checkpoint est créé. Si la demande 3 rend le texte illisible, tu peux revenir à l'état d'avant la demande 3 : le titre et le paragraphe restent, seule la couleur est annulée. Et si finalement le paragraphe ne te plaît pas non plus, tu peux revenir à l'état d'avant la demande 2.
Pourquoi c'est précieux pour un débutant
Avec les checkpoints, une erreur de Claude n'est plus une catastrophe. Une modification qui casse ton site peut être annulée en quelques secondes. Ça change complètement la façon dont tu travailles : tu peux essayer, tester, et revenir si le résultat ne te plaît pas.
C'est aussi un excellent moyen d'apprendre. Tu veux voir ce que donne une mise en page différente ? Demande-la. Si elle ne te plaît pas, tu reviens en arrière. Tester devient gratuit.
Une demande à la fois
Les checkpoints sont créés à chaque prompt. Plus tes demandes sont petites et ciblées, plus tes points de retour sont précis. Une demande géante qui change dix choses d'un coup ne te laisse qu'un seul point de retour : tout ou rien. Dix petites demandes t'en donnent dix.
La limite à garder en tête dès maintenant
Les checkpoints ne remplacent pas un vrai système de versions comme Git. Ils sont pensés pour une récupération rapide pendant la session, pas pour l'historique permanent de ton projet. On détaille les limites dans la leçon 3.4.
Si ça coince
- Tu ne trouves pas un ancien checkpoint : il a peut-être dépassé la limite des 100 plus récents, ou la période de nettoyage. Pour un historique durable, utilise Git.
- Un fichier n'a pas été suivi : s'il a été modifié uniquement par une commande Bash, ou en dehors de Claude Code, il n'est pas couvert (leçon 3.4).
- Tu crois devoir activer les checkpoints : non, ils sont automatiques. Il n'y a rien à configurer.
À retenir
- Un checkpoint est créé automatiquement avant chaque prompt qui démarre un tour.
- Il suit les modifications faites par les outils d'édition de Claude.
- Des petites demandes donnent des points de retour plus précis.
- C'est une annulation rapide, pas une sauvegarde permanente.