Les Checkpoints
Le filet de sécurité de Claude Code.
Snapshots automatiques de l'état du projet à chaque étape.
Un instantané automatique
Snapshot des fichiers
Avant chaque action modifiante, Claude Code prend un snapshot de l'état des fichiers du projet. Vous pouvez revenir à n'importe quel snapshot en une commande.
Différent de Git
Git est manuel et lent. Les checkpoints sont automatiques et instantanés. Les deux sont complémentaires : Git pour les jalons publics, checkpoints pour les expérimentations.
Stockés localement
Dans un dossier .claude/checkpoints/ à la racine du projet. Pas dans Git, pas dans le cloud. Votre disque, votre contrôle.
Nettoyés automatiquement
Les vieux checkpoints sont purgés au-delà de 7 jours par défaut. Configurable dans CLAUDE.md ou via /config.
Trois commandes à mémoriser
Créer manuellement
Force un snapshot, avec un label optionnel. /checkpoint avant-refacto. À utiliser avant toute action risquée.
Lister
Affiche la liste de tous les checkpoints disponibles, avec horodatage et label. Pour repérer celui auquel revenir.
Restaurer
Restaure l'état du projet à un checkpoint donné. Les fichiers reviennent comme ils étaient à ce moment-là.
Checkpoint manuel
Avant un refacto risqué. /checkpoint avant-refacto.
Action qui casse
Claude modifie, mais le résultat n'est pas concluant.
Lister
/checkpoints affiche tous les snapshots disponibles.
Restaurer
/restore + ID. Les fichiers reviennent à l'état d'avant.
Quatre réflexes à acquérir
Checkpoint manuel sur action risquée
Refacto multi-fichiers, migration, suppression. Trois secondes pour /checkpoint, des heures économisées.
Lire le label des checkpoints auto
Claude crée des labels descriptifs. avant write src/auth → vous savez exactement où vous revenez.
Confirmer avant de continuer
Si une session a beaucoup itéré, faites un /checkpoint final avec un label explicite avant de fermer.
Git reste indispensable
Checkpoints = locaux et éphémères. Git = partagé et durable. Faites des commits réguliers en plus.
À tout de suite en leçon 14bis
Vous connaissez les trois commandes essentielles : /checkpoint, /checkpoints, /restore. Vous savez quand poser un point de retour explicite.
Exercice — appropriation
Lors de votre prochaine session Claude Code, créez au moins un checkpoint manuel avant une action risquée. Forcez-vous à le restaurer une fois pour bien comprendre la mécanique.
Quiz · Les Checkpoints
8 questions · une seule bonne réponse par question · vous pouvez recommencer autant de fois que nécessaire.
Qu'est-ce qu'un checkpoint dans Claude Code ?
Un checkpoint est un instantané automatique. Avant chaque action modifiante, Claude Code prend un snapshot de l'état des fichiers. Vous pouvez revenir à n'importe quel snapshot en une commande.
Les checkpoints remplacent Git et le rendent inutile.
Faux. Checkpoints = locaux et éphémères (purgés après 7 jours). Git = partagé et durable. Les deux sont complémentaires : Git pour les jalons publics, checkpoints pour les expérimentations.
Quelles sont les 3 commandes essentielles des checkpoints ?
Trois commandes : /checkpoint (créer manuellement, avec label), /checkpoints (lister), /restore
Où sont stockés les checkpoints ?
Stockage local dans .claude/checkpoints/ à la racine du projet. Pas dans Git, pas dans le cloud. Votre disque, votre contrôle.
Les checkpoints sont conservés indéfiniment.
Faux. Les vieux checkpoints sont purgés automatiquement au-delà de 7 jours par défaut. Configurable dans CLAUDE.md ou via /config.
Quand créer un checkpoint manuel avec /checkpoint ?
Avant action risquée : refacto multi-fichiers, migration, suppression. Trois secondes pour /checkpoint avec un label clair (ex : « avant-refacto-auth »), des heures économisées si ça tourne mal.
Que fait la commande /restore ckp_a3f9c2 ?
/restore
Les checkpoints automatiques créés par Claude ont des labels descriptifs (ex : « avant write src/auth »).
Vrai. Claude crée des labels descriptifs lui-même. Vous savez précisément où vous revenez. Lisez le label avant de restaurer pour ne pas vous tromper.