Claude Code: Checkpoints

Checkpoints sind Claude CodesCode-Sicherheits-Rollback-Tool, das automatisch Claudes Dateiänderungen verfolgt, dir hilft, unerwünschte Änderungen schnell rückgängig zu machen, und Situationen verhindert, in denen fehlerhafter Code schwer wiederherzustellen ist.

Wie Checkpoints funktionieren

Checkpoints laufen automatisch im Hintergrund, wenn du Claude Code verwendest, ohne dass eine manuelle Konfiguration erforderlich ist:

  1. Automatische ErstellungNachdem jeder Benutzer-Prompt gesendet wurde, wird automatisch ein Checkpoint erstellt, um den aktuellen Codestatus aufzuzeichnen
  2. Dauerhafte SpeicherungCheckpoints bleiben über Sitzungen hinweg erhalten. Selbst nach dem Schließen einer Sitzung kannst du weiterhin auf historische Checkpoints zugreifen, wenn du später fortsetzt
  3. Automatische BereinigungCheckpoints, die älter als 30 Tage sind, werden automatisch gelöscht (Bereinigungszeit ist konfigurierbar)

Hinweis: Nur direkte Änderungen, die von Claudeüber Dateibearbeitungswerkzeuge vorgenommen werden, werden verfolgtÄnderungen, die auf andere Weise vorgenommen werden, werden nicht aufgezeichnet.


Wie man Checkpoints verwendet, um Änderungen rückgängig zu machen

1. Öffne das Rückgängig-Menü

Es gibt zwei Möglichkeiten, es auszulösen; wähle eine davon aus:

  • Tastenkürzel: Zweimal drückenEsc(Esc + Esc)
  • Slash-Befehl: Eingeben/rewind

2. Wähle den Revert-Typ

Nachdem du das Menü geöffnet hast, kannst du je nach Bedarf aus drei Revert-Modi wählen:

Revert-Typ Wirkung Anwendungsszenario
Nur Konversation Auf vorherigen Konversationsinhalt zurücksetzen, aktuelle Codeänderungen beibehalten Wenn du das Gefühl hast, dass die Konversation vom Thema abgekommen ist und du eine neue Frage stellen möchtest, aber die Codeänderungen in Ordnung sind
Nur Code Dateien in einen früheren Zustand zurücksetzen, aktuelle Konversation beibehalten Wenn der Code kaputt ist, du aber weiter auf Grundlage der aktuellen Konversation Anpassungen vornehmen möchtest
Code und Konversation Sowohl Code als auch Konversation auf einen früheren Zustand zurücksetzen Wenn Sie vollständig von vorn beginnen und zu einem zufriedenstellenden Punkt zurückkehren möchten

Häufige Anwendungsfälle

Checkpoints eignen sich besonders für die folgenden Entwicklungsszenarien:

  1. Mehrere Ansätze erkundenVerschiedene Ideen zur Code-Implementierung ausprobieren; wenn Sie nicht zufrieden sind, mit einem Klick zum Ausgangspunkt zurückkehren und einen anderen Ansatz versuchen
  2. Fehler schnell behebenWenn Claudes Änderungen Bugs verursachen oder die Funktionalität beeinträchtigen, schnell zum funktionierenden Zustand vor den Änderungen zurückkehren
  3. Iterative FunktionsentwicklungMehrere Variantenexperimente für eine Funktion durchführen und jederzeit zu einer stabilen Zwischenversion zurückkehren

Wichtige Einschränkungen

Checkpoints sind einvorübergehendes Sicherheitsnetz,keine universelle Lösung; Sie müssen sich ihrer Grenzen bewusst sein:

Änderungen durch Bash-Befehle werden nicht verfolgt
wierm mv cpDateioperationen, die über Bash-Tools ausgeführt werden, werden nicht von Checkpoints aufgezeichnet und können nicht rückgängig gemacht werden.

Verfolgt keine externen Änderungen
Nur Dateien, die von Claude innerhalb der aktuellen Sitzung bearbeitet wurden, werden verfolgt. Manuelle Änderungen, die Sie in externen Tools wie VS Code, dem Terminal vornehmen, oder Änderungen aus anderen Sitzungen werden nicht erfasst.

Kann Versionskontrolltools nicht ersetzen
Checkpoints werden nur fürtemporäres Rollback auf Sitzungsebeneverwendet und sind nicht für langfristiges Projektmanagement und Teamzusammenarbeit geeignet.

  • Langfristige Historie, Branch-Verwaltung → Versionskontrolltools wie Git verwenden
  • Checkpoints = lokales temporäres Rückgängigmachen, Git = dauerhafte Projekthistorie
Weitere Erweiterungen