Claude Code · 10 min · 2026-11-03 · Par Équipe MaitriseLIA
Comment annuler une modification de Claude Code ? /rewind, checkpoints et Git, le mode d’emploi
Claude Code a cassé un fichier qui marchait ? Échap deux fois ou /rewind ramène le code, la conversation, ou les deux, à l’un de vos messages précédents. Mais le retour arrière ignore les commandes Bash, la plupart des sous-agents et les fichiers liés. Ce que dit la documentation officielle, notre grille de décision et ce que contient vraiment l’historique de notre machine.
*Publié le 3 novembre 2026 · Mis à jour le 3 novembre 2026*
Pour annuler une modification faite par Claude Code, tapez /rewind ou appuyez deux fois sur Échap quand la zone de saisie est vide : un menu liste vos messages de la session, vous choisissez le point de retour, puis vous restaurez le code, la conversation, ou les deux. Ce mécanisme s’appelle le checkpointing : avant chaque message qui lance un tour de travail, Claude Code photographie l’état des fichiers qu’il modifie. La documentation officielle, consultée le 3 novembre 2026, précise qu’il garde les instantanés des 100 derniers checkpoints d’une session, pendant environ 30 jours.
Le besoin est réel : dans l’enquête Stack Overflow 2025, 66 % des développeurs citent comme première frustration les réponses d’IA « presque justes, mais pas tout à fait ». Savoir revenir en arrière en dix secondes change la façon de travailler avec un agent.
L’essentiel en une minute
- Le geste : /rewind, ou Échap deux fois sur une saisie vide.
- Les choix : restaurer code et conversation, conversation seule, ou code seul. Deux options de résumé compressent la conversation sans toucher aux fichiers.
- La durée : 100 checkpoints par session, effacés environ 30 jours après (réglage cleanupPeriodDays).
- Les angles morts : fichiers changés uniquement par des commandes Bash, la plupart des sous-agents, liens symboliques, modifications faites hors de la session.
- La règle : le retour arrière est une « annulation locale ». Git reste votre historique permanent.
Comment ouvrir le menu de retour arrière de Claude Code ?
Deux chemins mènent au même menu :
- Tapez /rewind dans la zone de saisie et validez.
- Appuyez deux fois sur Échap quand la zone de saisie est vide.
Le piège du second chemin : si vous avez commencé à écrire, le double Échap efface votre texte au lieu d’ouvrir le menu. Rien n’est perdu, le texte effacé est rangé dans l’historique de saisie : la flèche Haut le fait revenir une fois sorti du menu.
Le menu affiche la liste des messages que vous avez envoyés pendant la session. Chaque message correspond à un checkpoint, c’est-à-dire à l’état du code juste avant que Claude ne traite ce message. Choisir un message revient donc à dire : « remets tout comme avant que je demande ça ».
Claude Code « suit automatiquement les modifications de fichiers de Claude » pour permettre d’annuler et de revenir à un état antérieur, résume la documentation officielle du checkpointing (2026).
Les checkpoints sont enregistrés avec la conversation : après avoir repris une session avec claude --continue ou claude --resume, /rewind fonctionne toujours.
Restaurer le code, la conversation ou les deux : quelle option choisir ?
Une fois le message sélectionné, le menu propose six actions. Voici à quoi sert chacune, dans les cas concrets où on les utilise.
| Option du menu | Ce qu’elle fait | Quand la choisir |
|---|---|---|
| Restore code and conversation | Remet les fichiers et la conversation au point choisi | Claude est parti dans une mauvaise direction : on efface tout et on reformule |
| Restore conversation | Revient au message, garde le code actuel | Le code est bon, mais la discussion s’est encombrée de fausses pistes |
| Restore code | Annule les fichiers, garde la conversation | Le code est cassé, mais Claude doit se souvenir de ce qui a échoué pour ne pas recommencer |
| Summarize from here | Compresse la conversation à partir de ce point en un résumé | Une longue séance de débogage remplit le contexte, les consignes du début doivent rester intactes |
| Summarize up to here | Compresse ce qui précède ce point, garde la suite | Le début de séance n’est plus utile mais la fin l’est |
| Never mind | Retour à la liste sans rien changer | Vous avez ouvert le menu par erreur |
Trois détails qui évitent des surprises :
- Les deux options qui restaurent le code n’apparaissent que si le checkpoint a des modifications de fichiers à annuler. Sinon, le menu ne propose que la conversation, les résumés et Never mind.
- Après une restauration de conversation ou un Summarize from here, votre message d’origine revient dans la zone de saisie : vous pouvez le corriger et le renvoyer tel quel.
- Pour orienter un résumé, sélectionnez l’option Summarize avec les flèches et tapez vos consignes dans la ligne « add context (optional) » avant Entrée. Taper directement le numéro de l’option lance le résumé sans consigne.
Notre conseil pratique : Restore code seul est souvent le meilleur choix. Claude garde la mémoire de l’essai raté, et vous pouvez lui écrire « on repart du code d’avant, mais sans l’approche que tu viens de tenter ». Pour la gestion du contexte en général, voyez notre guide gérer le contexte de Claude Code avec /compact et /clear.
Qu’est-ce que /rewind ne peut pas annuler ?
C’est la partie que les tutoriels survolent, et celle qui coûte cher. La documentation liste cinq angles morts.
1. Les fichiers modifiés uniquement par des commandes Bash. Le suivi porte sur les outils d’édition de Claude. Si un fichier n’a été changé que par une commande shell (un sed, un script, un mv, un formateur lancé en ligne de commande), il n’est pas suivi et reste tel quel. Nuance utile : une fois que Claude a édité un fichier avec ses outils dans la conversation, les modifications Bash faites ensuite sur ce même fichier sont bien annulées.
2. La plupart des modifications de sous-agents. Un sous-agent édite des fichiers, mais ces modifications ne sont généralement pas capturées dans vos checkpoints. Seule exception : un skill avec context: fork exécuté au premier plan, qui travaille pendant votre propre tour. Pour tous les autres, y compris un skill forké en arrière-plan (le comportement par défaut), le retour arrière ne restaure que les fichiers que Claude avait déjà touchés lui-même. Le reste se rattrape avec Git. Notre guide des sous-agents de Claude Code détaille quand les lancer.
3. Les modifications externes. Ce que vous changez à la main dans votre éditeur, ou ce qu’une autre session Claude Code modifie en parallèle, n’est normalement pas capturé, sauf si cela touche les mêmes fichiers que la session courante.
4. Les messages envoyés pendant que Claude travaille. Un message tapé en cours de tour peut apparaître marqué No code restore : il n’a pas de checkpoint propre. Pour annuler, sélectionnez le message qui a lancé le tour, ce qui annule tout le tour.
5. Les liens symboliques et les liens physiques. Ils ne sont jamais restaurés. Claude Code les saute et affiche « Restored the code, but skipped N files ». Cas typiques : les fichiers de configuration qu’un gestionnaire de dotfiles relie à votre projet, et les fichiers que pnpm installe par lien physique.
Exemple : vous demandez à Claude de renommer un dossier avec mv, puis de corriger trois fichiers à l’intérieur. Un Restore code remettra le contenu des fichiers qu’il a édités, mais le renommage fait par Bash restera. Avant d’annuler, regardez où sont vraiment les fichiers.
Combien de temps Claude Code garde-t-il les checkpoints ?
Deux limites s’appliquent, toutes deux documentées :
| Limite | Valeur | Ce qui se passe au-delà |
|---|---|---|
| Nombre de checkpoints par session | 100 derniers | Les instantanés plus anciens sont supprimés, sauf le premier de chaque fichier (base des comparaisons de l’extension VS Code) |
| Durée de conservation | Environ 30 jours après le dernier instantané de la session | Le balayage efface les instantanés ; /rewind liste encore les checkpoints mais peut échouer |
| Réglage | cleanupPeriodDays, 30 par défaut, minimum 1 | Une valeur plus haute garde transcriptions et instantanés plus longtemps |
Quand les instantanés ont disparu, le retour arrière échoue avec le message « No files were restored ». La documentation précise qu’avant la version 2.1.260, Claude Code sautait ces fichiers sans rien dire et le retour arrière avait l’air de réussir. Si vous travaillez encore sur une version ancienne, ne faites pas confiance à une restauration de code sur une vieille session sans vérifier le résultat.
Attention au réglage cleanupPeriodDays : il ne pilote pas seulement les instantanés, mais aussi les transcriptions de session. Le monter à 90 garde tout plus longtemps sur votre disque, y compris des conversations qui peuvent contenir des données sensibles. Notre guide sécuriser Claude Code aide à arbitrer.
Ce que contient vraiment l’historique : notre mesure du 3 novembre
Les instantanés sont rangés dans le dossier file-history de votre répertoire .claude, un sous-dossier par session. Nous avons regardé celui de la machine qui fait tourner nos automatisations, le 3 novembre 2026, avec Claude Code 2.1.287.
| Mesure | Valeur relevée |
|---|---|
| Sessions avec des instantanés | 55 |
| Fichiers distincts suivis | 866 |
| Instantanés au total | 1 698 |
| Place occupée | 23 Mo |
| Session la plus lourde | 4 Mo |
| Plus grand nombre de versions d’un même fichier | 24 |
| Instantané le plus ancien | 4 octobre 2026 |
Trois enseignements :
- Le balayage de 30 jours fonctionne comme annoncé : rien n’est plus vieux que le 4 octobre, soit 30 jours avant notre relevé. Une session de septembre n’est donc plus restaurable côté code, même si elle apparaît encore.
- Le coût disque est négligeable : 23 Mo pour un mois d’usage intensif. Ce n’est pas une raison pour désactiver quoi que ce soit.
- Chaque fichier garde son historique de versions : les instantanés sont nommés par fichier avec un numéro de version (v1, v2…). Un fichier retravaillé 24 fois dans une session a 24 états possibles de retour.
Ces chiffres valent pour notre usage : ils serviront d’ordre de grandeur, pas de norme.
Faut-il utiliser /rewind, /branch ou Git ?
Les trois outils ne font pas la même chose. Voici la grille que nous appliquons.
| Situation | Outil | Pourquoi |
|---|---|---|
| Le dernier essai de Claude a cassé le code | /rewind puis Restore code | Le plus rapide, Claude garde la mémoire de l’échec |
| Vous voulez tester une autre approche sans perdre la première | /branch (ou claude --continue --fork-session) | Crée une copie de la conversation, l’original reste intact et reprenable |
| Un fichier a été modifié par une commande Bash ou un sous-agent | Git (git restore, git checkout) | Hors du périmètre des checkpoints |
| Annuler un seul fichier parmi plusieurs | Git | Les restaurations du menu portent sur le checkpoint entier |
| Revenir à un état de plus de 30 jours | Git | Les instantanés ont été effacés |
| Partager ou garder une version stable | Git (commit, branche) | La documentation le dit : les checkpoints ne remplacent pas le contrôle de version |
Un point mérite d’être retenu sur /branch : la commande copie la conversation et vous bascule dedans. L’original reste dans la liste des sessions, accessible avec /resume. Quand on bifurque, Claude Code copie aussi les instantanés de la session d’origine, donc /rewind reste utilisable dans la branche. Si une copie échoue (disque plein par exemple), le retour vers ce checkpoint pourra échouer.
Bonus utile : si vous avez lancé /clear plus tôt dans le même processus, le menu de retour arrière affiche en tête une entrée « /resume (previous session) » qui ramène la conversation d’avant le /clear, tant que vous n’avez pas quitté Claude Code.
La routine qui évite de dépendre du retour arrière
Le meilleur usage de /rewind est celui dont on n’a pas besoin. Notre routine, en quatre gestes :
- Committer avant chaque demande importante. Un commit propre coûte cinq secondes et couvre tout ce que /rewind ne voit pas.
- Demander à Claude d’éditer plutôt que de lancer des scripts quand c’est possible : ses outils d’édition sont suivis, pas les commandes shell.
- Relire avant d’annuler. Un git status montre ce qui a vraiment changé, y compris par Bash. Notre protocole pour vérifier le code généré par Claude Code détaille cette étape.
- Bifurquer plutôt que de revenir quand deux approches méritent d’être comparées : /branch garde les deux chemins.
Pour comparer comment plusieurs modèles abordent la même consigne avant de la confier à Claude Code, un comparateur comme IA Cockpit lance le même prompt sur plusieurs IA côte à côte.
En résumé
| Question | Réponse |
|---|---|
| Comment annuler ? | /rewind, ou Échap deux fois sur une saisie vide |
| Que peut-on restaurer ? | Le code, la conversation, ou les deux |
| Combien de checkpoints ? | Les 100 derniers d’une session |
| Combien de temps ? | Environ 30 jours (cleanupPeriodDays) |
| Qu’est-ce qui échappe ? | Bash seul, la plupart des sous-agents, liens, modifications externes |
| Et Git ? | Indispensable : c’est l’historique permanent |
FAQ
Comment annuler la dernière modification de Claude Code ?
Tapez /rewind ou appuyez deux fois sur Échap quand la zone de saisie est vide. Sélectionnez le dernier message que vous avez envoyé, puis choisissez Restore code pour remettre les fichiers dans l’état d’avant ce message, ou Restore code and conversation pour effacer aussi l’échange correspondant.
Pourquoi le double Échap n’ouvre-t-il pas le menu de retour arrière ?
Parce que la zone de saisie contient du texte. Dans ce cas, le double Échap efface ce texte au lieu d’ouvrir le menu. Le texte n’est pas perdu : il est rangé dans l’historique de saisie et la flèche Haut le fait revenir. Appuyez de nouveau deux fois sur Échap une fois la zone vide.
Peut-on annuler une modification de Claude Code après avoir fermé la session ?
Oui, tant que les instantanés existent. Les checkpoints sont enregistrés avec la conversation : reprenez la session avec claude --resume ou claude --continue puis lancez /rewind. Au-delà d’environ 30 jours (réglage cleanupPeriodDays), les instantanés sont effacés et la restauration du code échoue avec « No files were restored ».
Le retour arrière annule-t-il les commandes lancées par Claude dans le terminal ?
Non pour les fichiers que seules des commandes Bash ont modifiés : ils ne sont pas suivis. Oui si Claude avait déjà édité le fichier avec ses propres outils dans la conversation : les changements Bash ultérieurs sur ce fichier sont alors annulés. Les effets hors fichiers, comme un envoi réseau ou une base de données modifiée, ne s’annulent jamais.
Les checkpoints remplacent-ils Git ?
Non. La documentation officielle les présente comme une récupération rapide à l’échelle d’une session. Ils ne couvrent ni les sous-agents en arrière-plan, ni les liens symboliques, ni les modifications externes, et disparaissent après environ 30 jours. Gardez Git pour l’historique permanent, les branches et le travail en équipe.
Vous voulez travailler avec Claude Code sans avoir peur de casser votre projet ? Commencer la formation →
Sources
- Claude Code, documentation Checkpointing
- Claude Code, documentation des sessions (/branch, --continue, --fork-session)
- Claude Code, référence des erreurs (No files were restored)
- Claude Code, référence des réglages (cleanupPeriodDays)
- Claude Code, le dossier .claude (file-history)
- Stack Overflow Developer Survey 2025, section IA
À propos de l'auteur
Équipe MaitriseLIA
Experts en formation Claude Code, Anthropic API et outils d'IA professionnels. Nos contenus sont rédigés par des spécialistes qui utilisent Claude Code et les MCPs au quotidien pour automatiser leurs business.