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.