Annuler les changements de Claude Code : rewind et git

Pour annuler les changements de Claude Code, utilisez /rewind pour les modifications de la session en cours, git pour tout ce que vous avez commité ou pouvez restaurer depuis le dépôt, et les checkpoints d’AgentVera quand vous voulez ramener tout le dossier de travail au début d’un tour d’agent précis. Chacun couvre un manque différent. Savoir lequel choisir évite de perdre du travail en annulant celui de l’agent.

Ce guide compare les trois, montre les étapes exactes de chacun et liste ce que chacun rate. Cette dernière partie est généralement ce qui piège.

La réponse courte

Option 1 : /rewind dans Claude Code

Claude Code enregistre des checkpoints quand il modifie des fichiers. Pour revenir en arrière, appuyez deux fois sur Échap ou lancez /rewind. Vous choisissez un message de la session, puis ce qu’il faut restaurer :

• Code seulement : les fichiers reviennent à leur état à ce message, la conversation reste.
• Conversation seulement : la conversation revient en arrière, les fichiers restent tels quels.
• Les deux : un retour net à ce point.

C’est l’annulation la plus rapide tant que vous êtes dans la session, et le bon premier réflexe quand l’agent vient de faire une mauvaise modification.

Ce qu’elle rate : les checkpoints de Claude Code suivent les modifications faites par ses propres outils de fichiers. Les changements faits par des commandes shell, comme rm, mv, un générateur de code ou un script de migration, ne sont pas suivis. Ceux d’autres sessions ou d’autres outils dans le même dossier non plus. /rewind est un confort, pas un remplacement du contrôle de version.

Option 2 : git

Git est l’annulation qui marche pour tous les outils, tant que le travail à garder ou à jeter est visible par git.

# See what changed
git status
git diff

# Throw away changes to one tracked file
git restore src/api/user.ts

# Park everything, including new files, and keep it in case you need it
git stash -u

# Drop all uncommitted changes to tracked files
git reset --hard

# Delete untracked files and folders (check first with -n)
git clean -n -d
git clean -f -d

# Reverse a commit the agent already made
git revert <commit>

Deux habitudes font de git une bien meilleure annulation pour le travail des agents :

1. Commitez avant de lancer un agent sur une tâche. Alors git diff montre exactement ce que l’agent a fait, et git stash -u ou git reset --hard vous ramène en arrière.
2. Donnez à chaque agent son propre worktree. Annuler un agent ne touche alors jamais le travail d’un autre. Voir les worktrees git pour agents parallèles.

Ce qu’il rate : tout ce qui est entre deux commits. Si vous avez fait vos propres modifications dans les mêmes fichiers pendant que l’agent travaillait, git reset --hard supprime aussi les vôtres. git clean supprime définitivement les fichiers non suivis : lancez-le toujours d’abord avec -n.

Option 3 : les checkpoints d’AgentVera

AgentVera ajoute une annulation par tour qui se place entre les deux. Elle fonctionne avec toute CLI d’agent qui tourne dans un dossier local, pas seulement Claude Code.

Comment fonctionnent les instantanés

Au début de chaque tour, AgentVera prend un instantané du dossier de travail de l’agent (son worktree, ou le dossier du projet). L’instantané couvre les fichiers suivis et non suivis et respecte .gitignore. Il est stocké sous forme de commit dans une réf cachée, refs/agentvera/checkpoints/…. Vos branches, l’index, le stash et HEAD ne changent pas, et rien n’apparaît dans git log ni git status.

Les 60 derniers tours sont gardés par agent. Supprimer l’agent supprime ses instantanés. Le projet doit être un dépôt Git. Le premier instantané est pris quand vous envoyez un message à l’agent (ou tapez à Claude dans le terminal).

Annuler un tour

1. Dans l’en-tête du panneau de l’agent, cliquez sur Turns (« Turns and rollback »). Dans un panneau étroit, c’est sous Options.
2. La liste montre les tours du plus récent au plus ancien, chacun avec son numéro, son prompt et l’heure. Un tour tapé directement dans le terminal apparaît comme « Turn typed in the terminal ».
3. Dépliez un tour pour voir les fichiers qu’il a changés, marqués ajoutés, modifiés ou supprimés, avec le nombre de lignes.
4. Cliquez sur Roll back this turn et confirmez Roll back turn.

Le dossier de travail revient au début de ce tour. Les fichiers ajoutés après sont supprimés, et les fichiers modifiés ou supprimés sont restaurés. AgentVera indique ensuite combien de fichiers il a restaurés. Si l’agent travaille encore, la fenêtre recommande de l’arrêter d’abord, pour qu’il ne continue pas à modifier pendant que le dossier change sous lui.

Annuler le retour en arrière

Avant de revenir en arrière, AgentVera enregistre l’état actuel à part. Il apparaît en haut de la liste sous State before the rollback. Cliquez sur Return to this state pour retrouver exactement ce que vous aviez. Essayer un retour en arrière est donc sans risque. S’il s’avère que le changement de l’agent était bon, vous pouvez y revenir.

Depuis votre téléphone

Si vous contrôlez les agents depuis Telegram, les boutons de l’agent incluent ↩️ Undo last turn. Il affiche la liste des fichiers et demande une confirmation. Ensuite, vous pouvez encore l’annuler depuis la liste des checkpoints sur le bureau. Voir le contrôle par Telegram.

Ce qu’il rate

• Les autres agents du même dossier. Un retour en arrière restaure le dossier : les changements ultérieurs d’autres agents qui travaillent dans ce dossier sont donc annulés aussi. La confirmation le précise. Les worktrees l’évitent.
• Les fichiers ignorés. Les fichiers couverts par .gitignore, comme node_modules ou un .env local, ne font pas partie de l’instantané.
• Ce qui est hors du dossier. Une base de données migrée par l’agent, un paquet qu’il a publié ou un push qu’il a fait ne sont pas des fichiers du dossier : aucun instantané de dossier ne peut les annuler.
• Les agents SSH et les terminaux simples. Aucun checkpoint n’est pris pour les agents sur un serveur distant, car leurs dossiers ne sont pas sur cet ordinateur.

Lequel utiliser et quand

• L’agent vient de faire une mauvaise modification et vous êtes encore dans la session : /rewind.
• L’agent a lancé un script qui a supprimé ou généré des fichiers : les checkpoints d’AgentVera ou git, pas /rewind.
• Plusieurs tours sont partis dans la mauvaise direction : revenez au début du premier mauvais tour dans Turns. Vous pouvez revenir à l’état actuel si vous changez d’avis.
• Le travail est commité : git revert.
• Vous voulez repartir de zéro pour toute la tâche : git stash -u ou git reset --hard, si vous avez commité avant de commencer.

Moins d’annulations dès le départ

L’annulation est le filet de sécurité, pas le plan. Quelques habitudes réduisent le besoin d’y recourir :

• Des prompts petits et ciblés. Un tour qui change trois fichiers est facile à relire et à annuler.
• Planifier d’abord pour le travail risqué. Demandez à l’agent de décrire le changement avant de le faire.
• Relire chaque tour. La revue de code d’AgentVera peut relire le code d’un agent à la fin de chaque tour. La revue de code par IA détaille quoi surveiller.
• Garder les commandes destructrices derrière une approbation. La sécurité des agents de code IA couvre les permissions, l’isolation Docker et les approbations.

Pour conclure

Il n’existe pas d’annulation unique pour un agent de code IA. /rewind est rapide pour les modifications de la session en cours. Git couvre tout ce qu’il voit, au mieux quand vous commitez avant chaque tâche. Les checkpoints d’AgentVera comblent l’écart entre les deux avec un instantané de tout le dossier de travail à chaque tour, un retour en arrière que l’on peut lui-même annuler, et le même bouton sur votre téléphone. La page checkpoints et replay couvre aussi le replay de session, qui rejoue pas à pas une session Claude ou Codex pour voir où elle a dérapé.