Checkpoints Claude Code : comment rembobiner code et conversation
Chaque prompt Claude Code est un checkpoint restaurable. Apprenez /rewind et le double Esc, les trois options de restauration, ce que les checkpoints capturent (et ce qu'ils ne peuvent pas), les limites de rétention et comment ils complètent git — vérifié contre la documentation officielle.
L'essentiel
- Les checkpoints sont automatiques : chaque prompt qui démarre un tour photographie d'abord votre code — rien à configurer, il suffit de savoir comment rembobiner.
- Lancez /rewind (ou pressez Esc deux fois avec un prompt vide) pour obtenir un menu de points de restauration qui propose, à chaque fois : restaurer code et conversation, la conversation seule, ou le code seul.
- Le rembobinage est une récupération au niveau de la session, pas du versioning : les effets de bord Bash (rm, mv, cp), la plupart des éditions de sous-agents et vos propres éditions manuelles ne sont pas capturés. Continuez à committer dans git.
- Claude Code garde les 100 checkpoints les plus récents d'une session pendant environ 30 jours (à ajuster avec cleanupPeriodDays), et les checkpoints survivent à /resume — vous rembobinez la session d'hier aujourd'hui.
12 Claude Code Features Every Engineer Should Know: Subagents, CLAUDE.md, Checkpoints, MCP, and more
Chaîne : ByteByteAI7:30
Claude Code Checkpoints Are Here (First Look)
Chaîne : Build at Scale8:16
Checkpointing — official documentation
Documentation officielle : code.claude.com/docs
Chaque option de restauration, chaque limite et chaque chiffre de rétention de cette page est vérifié contre la documentation officielle du checkpointing ; les vidéos ci-dessus sont les sources visuelles et factuelles.
Les captures d'écran sont attribuées à leurs créateurs, avec des liens profonds vers les horodatages exacts. Aucune image de visage filmé n'est utilisée.
Rembobiner avec les checkpoints Claude Code, étape par étape
Partie 1 — Ce qui est capturé
- 1
Savoir ce qu'est un checkpoint
Un checkpoint est un instantané automatique de l'état de votre code, pris avant chaque prompt qui démarre un nouveau tour. Il existe pour qu'un refactoring raté, une édition trop zélée ou une mauvaise direction soient à une commande de l'annulation — pas de stash, pas de commit, pas de cérémonie.
La promesse des checkpoints : photographier avant chaque édition, rembobiner code et conversation dès qu'une expérience part de travers.Voir à 2:15 - 2
Chaque prompt démarreur de tour en crée un
Vous ne créez pas les checkpoints à la main — chaque prompt qui met Claude au travail photographie les fichiers qu'il va toucher. Une longue session bâtit une chaîne de points de restauration, un par prompt, comme des sauvegardes automatiques de partie pour votre dépôt.
La boucle d'édition : Claude édite, un instantané atterrit dans la chaîne de checkpoints, et le prompt suivant démarre un cycle neuf.Voir à 2:33 - 3
Ouvrir le menu de rembobinage avec /rewind
Tapez /rewind au prompt pour lister les checkpoints de la session en cours. La voie clavier est encore plus rapide : pressez Esc deux fois avec la zone de saisie vide. (S'il y a du texte, le double Esc l'efface seulement — pressez Flèche haut pour rappeler ce qui était tapé.)
/rewind tapé au prompt de Claude Code — la liste des checkpoints s'ouvre dans la session même.Voir à 2:40 - 4
Choisir votre point de restauration
Le menu liste chaque checkpoint avec le prompt qui l'a créé — « restaurer le code et/ou la conversation au point précédent… ». Naviguez jusqu'au moment où tout a dérapé, pressez Entrée et choisissez quoi restaurer.
Le menu de restauration : choisissez le prompt d'avant l'erreur — les entrées surlignées en rouge sont des questions antérieures de cette session.Voir à 2:45
Partie 2 — Le menu de rembobinage
- 5
Restaurer code et conversation ensemble
Le rembobinage complet : les fichiers reviennent à leur état photographié et la conversation se bifurque en retour vers ce point. À utiliser quand c'est toute la direction qui était mauvaise — le code et la mémoire que Claude garde de la tâche se réinitialisent tous les deux.
- 6
Restaurer le code seul — garder la conversation
Restaurer le code seul annule les fichiers pendant que la conversation reste où elle est. Parfait pour « l'approche est bonne, le résultat est mauvais » : Claude se souvient de tout ce qui a été discuté, mais les éditions cassées disparaissent.
- 7
Restaurer la conversation seule — bifurquer le chat
La troisième option rembobine la conversation à un point antérieur et laisse vos fichiers intacts — le même comportement de bifurcation que le double Esc avant les checkpoints. À utiliser quand le code va bien mais que la discussion s'est enfournée dans un rabbit hole.
- 8
Résumer à partir d'ici plutôt que rembobiner
Le menu propose aussi « Summarize from here » et « Summarize up to here » — un /compact ciblé qui condense un tronçon de conversation en résumé tout en gardant vos instructions initiales. Pour de vraies bifurcations, utilisez /branch ou claude --continue --fork-session.
Partie 3 — Les limites et le réflexe git
- 9
Savoir ce que le rembobinage ne peut pas annuler
Les checkpoints suivent les éditions de fichiers que Claude fait, pas tout : les changements passés par Bash (rm, mv, cp), la plupart des éditions de sous-agents, vos propres éditions manuelles et les changements d'autres sessions ne sont pas capturés. Les liens symboliques sont ignorés — la restauration prévient « Restored the code, but skipped N files ».
- 10
Checkpoints vs git : se répartir le travail
Les checkpoints servent à la récupération rapide au niveau de la session : annuler ce prompt, retenter cette idée. Git est pour l'histoire permanente : committer les états qui marchent, brancher, pousser. Le rythme recommandé : rembobiner librement pendant l'exploration, committer délibérément quand un changement mérite d'être gardé.
- 11
Surveiller la fenêtre de rétention
Claude Code garde les 100 checkpoints les plus récents par session et balaie les instantanés anciens après environ 30 jours — le même réglage cleanupPeriodDays qui gouverne l'historique des transcriptions. Allongez-le dans settings.json si vous voulez que /rewind et /resume remontent plus loin.
Checkpoints vs git vs /branch vs double-Esc vs /compact
Claude Code vous offre cinq façons de revenir en arrière — elles résolvent des problèmes différents :
- 1Checkpoints (/rewind) — instantané, automatique, au niveau de la session : annuler le code, la conversation ou les deux jusqu'à n'importe quelle frontière de prompt. Aucune configuration, pas permanent, pas partagé.
- 2Git — la vraie histoire : les commits explicites que vous faites quand le travail mérite d'être gardé. Les checkpoints ne le remplacent jamais ; ils s'assoient avant lui dans la chaîne de sécurité.
- 3/branch et --fork-session — démarrer une ligne de temps parallèle depuis la conversation actuelle sans toucher aux fichiers. Quand vous voulez explorer une alternative et garder les deux lignes.
- 4Double-Esc — le chemin clavier vers le même menu de rembobinage quand le prompt est vide ; avec du texte dans la zone, il efface juste la saisie (l'historique la garde, pressez Flèche haut pour la rappeler).
- 5/compact et « Summarize from here » — rétrécir la conversation au lieu de s'y déplacer : récupérer du contexte en gardant les décisions, au prix du détail.
Un modèle mental simple : rembobiner pour les erreurs, git pour le progrès, la bifurcation pour les alternatives, le résumé pour la place.
Le rembobinage n'a pas fait ce que vous attendiez ? Premier secours
Quatre surprises classiques des checkpoints et quoi y faire :
- 1« No files were restored ». Les instantanés ont été balayés — au-delà du plafond de 100 checkpoints ou de la rétention d'environ 30 jours. Allongez cleanupPeriodDays dans settings.json pour garder une queue plus longue.
- 2« Restored the code, but skipped N files ». Les liens symboliques et les hard links sont ignorés par conception. Lancez /debug et consultez ~/.claude/debug/<session-id>.txt pour les chemins exactement ignorés, puis annulez-les à la main.
- 3Les fichiers changés via Bash restent inchangés. rm, mv et cp tournent dans le shell, hors du système d'instantanés — annulez-les avec git checkout ou restaurez depuis des sauvegardes.
- 4Le prompt cherché n'est pas dans la liste. Les messages mis en file en plein tour ne créent pas de checkpoints — rembobinez jusqu'au prompt démarreur de tour le plus proche, et les éditions de sous-agents peuvent exiger un git revert.
- 5Il n'existe aucune commande /rewind. Les checkpoints sont arrivés avec Claude Code 2.0 — lancez claude update (ou claude doctor) pour vérifier votre version, et notez que les sessions vraiment anciennes, antérieures à la fonction, n'ont aucun instantané vers lequel rembobiner.
Règle d'or : si le changement compte, commitez-le. Les checkpoints sont l'airbag, git la ceinture — portez les deux.