Les Checkpoints
À l'issue de cette leçon, le stagiaire pose et restaure des checkpoints, et structure ses sessions Claude autour de ces points de reprise.
Le concept
Un checkpoint est un instantané de l'état d'un projet à un moment donné. Quand vous en posez un, Claude Code retient le contenu des fichiers et de la conversation. Si la suite tourne mal, vous pouvez restaurer cet instantané et reprendre comme si rien n'avait été fait depuis.
C'est l'équivalent fonctionnel d'un git stash mais piloté par Claude. La différence : un checkpoint capture aussi l'état conversationnel (le contexte que Claude a en tête), pas seulement les fichiers. Restaurer un checkpoint, c'est rebobiner Claude lui-même.
Quand les utiliser
Avant un risque. Refacto étendu, edit sur un fichier critique, commande shell dont vous n'êtes pas certain : checkpoint, puis action.
À chaque jalon. Quand une étape importante est validée et fonctionnelle, posez un checkpoint. C'est votre fond de roue arrière en cas de dégradation ultérieure.
Avant de tester une approche alternative. Vous voulez voir si une autre solution est meilleure ? Checkpoint, exploration, comparaison, restauration si moins bien.
Comment les nommer
Un checkpoint sans nom utilisable est un checkpoint qu'on ne retrouve pas. Adoptez un nommage court et descriptif : avant-refacto-auth, mvp-fonctionnel, tests-passent. Évitez les noms vagues du type v1, save, essai.
Pour un projet long, pensez la liste de checkpoints comme un fil narratif : si quelqu'un lit la liste demain, comprend-il l'enchaînement ? Si oui, c'est bon.
Cycle complet d'un checkpoint
L'objectif est de poser, modifier, puis restaurer. La procédure est identique sur Mac et Windows.
-
Dans une session Claude Code active, taper la commande slash :
/checkpoint avant-test. Claude confirme la création. -
Demander une modification non triviale : « Réécris la fonction X en utilisant une approche fonctionnelle. » Claude exécute.
-
Vérifier le résultat. Si vous l'aimez, le checkpoint reste comme filet de sécurité. Si vous ne l'aimez pas, étape suivante.
-
Restaurer :
/checkpoint restore avant-test. Les fichiers et la conversation reviennent à l'état d'origine. Vous pouvez reformuler la demande différemment. -
Pour lister les checkpoints existants :
/checkpoint list. Pour en supprimer un devenu inutile :/checkpoint delete <nom>.
Stratégie de checkpoints pour un projet réel
Sur un projet en cours, identifiez trois moments où poser un checkpoint serait utile cette semaine. Définissez leur nom à l'avance. Tenez-vous-y au moment venu.
- code.claude.com documentation Claude Code
- docs.claude.com documentation produit, chemin précis à vérifier au moment de la consultation
Vous savez poser et restaurer un checkpoint ?