SpyBara
Go Premium

checkpointing.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 29 additions and 19 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 18 23:58 Fri 25 23:58

Checkpointing

Suivez, rembobinez et résumez les modifications et la conversation de Claude pour gérer l'état de la session.

Claude Code suit automatiquement les modifications de fichiers effectuées par Claude au fur et à mesure que vous travaillez, ce qui vous permet d'annuler rapidement les modifications et de revenir à des états antérieurs si quelque chose s'écarte de la trajectoire.

Comment fonctionne le checkpointing

Au fur et à mesure que vous travaillez avec Claude, le checkpointing capture automatiquement l'état de votre code avant chaque invite utilisateur.

Suivi automatique

Claude Code suit toutes les modifications apportées par ses outils d'édition de fichiers :

  • Chaque invite utilisateur crée un nouveau checkpoint
  • Claude Code conserve des snapshots de fichiers pour les 100 checkpoints les plus récents dans une session. L'abandon d'un checkpoint plus ancien supprime les fichiers snapshot que nul autre checkpoint ne référence, sauf le premier snapshot de chaque fichier, que l'extension VS Code utilise comme référence pour les diffs de session.
  • Claude Code enregistre les checkpoints avec la conversation, donc vous pouvez toujours exécuter /rewind après avoir repris une session
  • Claude Code supprime les snapshots de fichiers d'une session lors du nettoyage de rétention, par défaut environ 30 jours après le dernier enregistrement de la session. Le rembobinage vers un checkpoint dont les snapshots ont disparu peut échouer avec No files were restored. Pour conserver les snapshots plus longtemps, définissez cleanupPeriodDays.

Rembobiner et résumer

Exécutez /rewind, ou appuyez sur Esc deux fois lorsque le champ de saisie d'invite est vide, pour ouvrir le menu de rembobinage.

Le menu de rembobinage répertorie chaque invite que vous avez envoyée pendant la session. Sélectionnez le point sur lequel vous souhaitez agir, puis choisissez une action :

  • Restaurer le code et la conversation : revenir au code et à la conversation à ce moment
  • Restaurer la conversation : rembobiner jusqu'à ce message tout en conservant le code actuel
  • Restaurer le code : annuler les modifications de fichiers tout en conservant la conversation
  • Résumer à partir d'ici : compresser la conversation à partir de ce moment en avant dans un résumé, libérant de l'espace de context window
  • Résumer jusqu'à ici : compresser la conversation avant ce moment dans un résumé, en conservant les messages ultérieurs intacts
  • Annuler : revenir à la liste des messages sans apporter de modifications

Les deux options de restauration de code n'apparaissent que lorsque le checkpoint sélectionné a des modifications de fichiers suivies à annuler. Si aucune modification de fichier n'a été capturée après ce point, le menu propose uniquement Restaurer la conversation, les options de résumé et Annuler.

Après la restauration de la conversation ou le choix de Résumer à partir d'ici, l'invite originale du message sélectionné est restaurée dans le champ de saisie afin que vous puissiez la renvoyer ou la modifier.

Le choix de Résumer jusqu'à ici vous laisse à la fin de la conversation avec le champ de saisie vide. Avec l'une ou l'autre option de résumé, un marqueur Summarized conversation apparaît dans la conversation où les messages compressés se trouvaient.

Rembobiner au-delà d'une conversation effacée

Si vous avez exécuté /clear plus tôt dans le même processus Claude Code, le menu de rembobinage affiche une entrée supplémentaire en haut de la liste intitulée /resume <session-id> (previous session). Sélectionnez-la pour reprendre la conversation qui était active avant l'exécution de /clear. L'entrée est disponible jusqu'à ce que vous quittiez Claude Code ou repreniez une session différente, et nécessite Claude Code v2.1.191 ou version ultérieure. Sur les versions antérieures, exécutez /resume et choisissez la session précédente dans la liste à la place.

Guider un résumé

Le résumé ne modifie pas les fichiers sur le disque, et les messages originaux restent dans la transcription de session, donc Claude peut toujours référencer les détails. Pour guider sur quoi le résumé se concentre, mettez en surbrillance une option Résumer avec les touches fléchées et tapez des instructions où la ligne indique add context (optional), puis appuyez sur Entrée. La sélection de l'option avec sa touche numérique résume immédiatement sans instructions.

Cas d'usage courants

Les checkpoints sont particulièrement utiles quand :

  • Explorer les alternatives : essayez différentes approches d'implémentation sans perdre votre point de départ
  • Récupérer des erreurs : annulez rapidement les modifications qui ont introduit des bugs ou cassé des fonctionnalités
  • Itérer sur les fonctionnalités : expérimentez des variations en sachant que vous pouvez revenir à des états fonctionnels
  • Libérer de l'espace de contexte : résumez une session de débogage verbeuse à partir du point médian en avant, en conservant vos instructions initiales intactes

Limitations

Les modifications de commandes Bash ne sont pas suivies

Le checkpointing ne suit pas les fichiers modifiés par les commandes bash. Par exemple, si Claude Code exécute :

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

Ces modifications de fichiers ne peuvent pas être annulées via le rembobinage. Seules les modifications de fichiers directs effectuées via les outils d'édition de fichiers de Claude sont suivies.

Les modifications des subagents ne sont pas restaurées

Un subagent effectue des modifications avec les outils d'édition de fichiers de Claude, mais Claude Code ne capture généralement pas ces modifications dans les checkpoints de votre session. Le fait que le rembobinage les restaure dépend de la façon dont le subagent s'exécute :

  • Skill forké en avant-plan : un skill avec context: fork qui s'exécute en avant-plan modifie votre arborescence de travail pendant votre propre tour, donc le rembobinage restaure ses modifications comme d'habitude. Définissez background: false pour exécuter un fork en avant-plan ; quelques situations, listées sur la page des skills, l'exécutent là-bas indépendamment du paramètre.
  • Tout autre subagent : le rembobinage ne restaure pas les modifications. Utilisez git pour les annuler. Cela inclut un skill forké qui s'exécute en arrière-plan, le paramètre par défaut, et une exécution /code-review --fix en arrière-plan.

Les modifications externes ne sont pas suivies

Le checkpointing suit uniquement les fichiers qui ont été modifiés au cours de la session actuelle. Les modifications manuelles que vous apportez aux fichiers en dehors de Claude Code et les modifications d'autres sessions concurrentes ne sont normalement pas capturées, sauf si elles modifient par hasard les mêmes fichiers que la session actuelle.

Les chemins symlinked et hard-linked ne sont pas restaurés

Le checkpointing ne rembobine pas les fichiers symlinked ou hard-linked. Lorsque vous sélectionnez Restore code ou Restore code and conversation dans le menu /rewind, Claude Code ignore tout chemin suivi qui est un symlink ou un hard link et affiche un avertissement Restored the code, but skipped N files. Les fichiers ignorés conservent leur contenu actuel. Pour annuler les modifications de la session sur l'un d'eux, demandez à Claude d'inverser la modification ou modifiez le fichier vous-même. Les fichiers de configuration qu'un gestionnaire de dotfiles symlinke dans votre projet et les fichiers que pnpm hard-linke en place entrent tous deux dans cette catégorie.

Pour voir quels chemins une restauration ignore, activez la journalisation de débogage avec /debug avant de restaurer : le journal de débogage à ~/.claude/debug/<session-id>.txt nomme chaque chemin ignoré. Pour chaque raison d'ignorance et les étapes de récupération, consultez l'entrée skipped-files dans la référence des erreurs.

Pas un remplacement du contrôle de version

Les checkpoints sont conçus pour une récupération rapide au niveau de la session. Pour un historique de version permanent et la collaboration, continuez à utiliser le contrôle de version, tel que Git, pour les commits, les branches et l'historique à long terme.

Voir aussi