Skip to main content
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 que vous envoyez et qui démarre un tour.

​
Suivi automatique

Claude Code suit toutes les modifications apportées par ses outils d’édition de fichiers :
  • Chaque invite que vous envoyez et qui démarre un tour 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.
Si le champ de saisie d’invite contient du texte, double Esc l’efface à la place d’ouvrir le menu. Le texte effacé est enregistré dans votre historique de saisie, appuyez donc sur Haut pour le rappeler après avoir terminé dans le menu de rembobinage.
Le menu de rembobinage répertorie les prompts que vous avez envoyés 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.

​
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.
Résumer vous garde dans la même session et compresse le contexte, comme un /compact ciblé. Pour vous brancher et essayer une approche différente tout en préservant la session originale intacte, utilisez plutôt /branch ou claude --continue --fork-session.

​
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 :
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 messages envoyés en cours de tour ne sont pas checkpointés

Dans le menu de rembobinage, un message que vous avez saisi pendant que Claude travaillait encore peut être marqué No code restore. Claude a lu ce message avant la fin de son tour. Les checkpoints sont créés pour les prompts qui démarrent un tour, ce message n’a donc pas de checkpoint propre. Les modifications que Claude a apportées après l’avoir lu sont rattachées au prompt qui a démarré le tour. Vous n’avez rien à faire concernant le message lui-même. Pour annuler les modifications de fichiers de cette partie de la session, sélectionnez le prompt qui a démarré le tour et choisissez Restore code ou Restore code and conversation. Cela annule les modifications de fichiers de Claude sur l’ensemble du tour, y compris celles effectuées avant l’arrivée de votre message. Sélectionner le message marqué propose toujours Restore conversation, qui rembobine la conversation jusqu’à ce message et laisse vos fichiers tels quels.

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