SpyBara
Go Premium

checkpointing.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 29 additions and 19 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 25 23:58

Checkpointing

Verfolgen, zurückspulen und fassen Sie Claudes Bearbeitungen und Konversation zusammen, um den Sitzungsstatus zu verwalten.

Claude Code verfolgt automatisch Claudes Dateibearbeitungen während Sie arbeiten, sodass Sie Änderungen schnell rückgängig machen und zu vorherigen Zuständen zurückspulen können, falls etwas schiefgeht.

Wie Checkpointing funktioniert

Während Sie mit Claude arbeiten, erfasst Checkpointing automatisch den Zustand Ihres Codes vor jeder Benutzereingabe.

Automatische Verfolgung

Claude Code verfolgt alle Änderungen, die von seinen Datei-Bearbeitungswerkzeugen vorgenommen werden:

  • Jede Benutzereingabe erstellt einen neuen Checkpoint
  • Claude Code behält Datei-Snapshots für die 100 neuesten Checkpoints in einer Sitzung. Das Verwerfen eines älteren Checkpoints löscht die Snapshot-Dateien, auf die kein verbleibender Checkpoint verweist, mit Ausnahme des ersten Snapshots jeder Datei, den die VS Code-Erweiterung als Grundlage für ihre Sitzungs-Diffs verwendet.
  • Claude Code speichert Checkpoints mit der Konversation, sodass Sie nach dem Fortsetzen einer Sitzung immer noch /rewind ausführen können
  • Claude Code löscht die Datei-Snapshots einer Sitzung in der Aufbewahrungsbereinigung, standardmäßig etwa 30 Tage nach dem letzten Speichern der Sitzung. Das Zurückspulen zu einem Checkpoint, dessen Snapshots weg sind, kann mit No files were restored fehlschlagen. Um Snapshots länger zu behalten, setzen Sie cleanupPeriodDays.

Zurückspulen und zusammenfassen

Führen Sie /rewind aus, oder drücken Sie Esc zweimal, wenn das Eingabefeld leer ist, um das Zurückspul-Menü zu öffnen.

Das Zurückspul-Menü listet jede Eingabe auf, die Sie während der Sitzung gesendet haben. Wählen Sie den Punkt aus, auf den Sie einwirken möchten, und wählen Sie dann eine Aktion:

  • Code und Konversation wiederherstellen: Setzt sowohl Code als auch Konversation auf diesen Punkt zurück
  • Konversation wiederherstellen: Zurückspulen zu dieser Nachricht, während der aktuelle Code beibehalten wird
  • Code wiederherstellen: Dateiänderungen rückgängig machen, während die Konversation beibehalten wird
  • Von hier aus zusammenfassen: Komprimieren Sie die Konversation von diesem Punkt an in eine Zusammenfassung und geben Sie Kontextfensterplatz frei
  • Bis hier zusammenfassen: Komprimieren Sie die Konversation vor diesem Punkt in eine Zusammenfassung und behalten Sie spätere Nachrichten intakt
  • Nie Sinn: Kehren Sie zur Nachrichtenliste zurück, ohne Änderungen vorzunehmen

Die beiden Code-Wiederherstellungsoptionen werden nur angezeigt, wenn der ausgewählte Checkpoint nachverfolgbare Dateiänderungen zum Rückgängigmachen hat. Wenn nach diesem Punkt keine Dateibearbeitungen erfasst wurden, bietet das Menü nur Konversation wiederherstellen, die Zusammenfassungsoptionen und Nie Sinn an.

Nach dem Wiederherstellen der Konversation oder dem Auswählen von „Von hier aus zusammenfassen" wird die ursprüngliche Eingabe aus der ausgewählten Nachricht in das Eingabefeld wiederhergestellt, sodass Sie sie erneut senden oder bearbeiten können.

Das Auswählen von „Bis hier zusammenfassen" hinterlässt Sie am Ende der Konversation mit leerem Eingabefeld. Bei beiden Zusammenfassungsoptionen wird ein Marker Zusammengefasste Konversation in der Konversation angezeigt, wo die komprimierten Nachrichten waren.

Zurückspulen über eine gelöschte Konversation hinaus

Wenn Sie /clear früher im selben Claude Code-Prozess ausgeführt haben, zeigt das Zurückspul-Menü einen zusätzlichen Eintrag oben in der Liste mit der Bezeichnung /resume <session-id> (vorherige Sitzung) an. Wählen Sie ihn aus, um die Konversation fortzusetzen, die vor dem Ausführen von /clear aktiv war. Der Eintrag ist verfügbar, bis Sie Claude Code beenden oder eine andere Sitzung fortsetzen, und erfordert Claude Code v2.1.191 oder später. In früheren Versionen führen Sie /resume aus und wählen die vorherige Sitzung aus der Liste aus.

Zusammenfassung lenken

Das Zusammenfassen ändert keine Dateien auf der Festplatte, und die ursprünglichen Nachrichten bleiben im Sitzungstranskript, sodass Claude die Details immer noch referenzieren kann. Um zu lenken, worauf sich die Zusammenfassung konzentriert, markieren Sie eine Zusammenfassen-Option mit den Pfeiltasten und geben Sie Anweisungen ein, wo die Zeile add context (optional) liest, und drücken Sie dann Enter. Das Auswählen der Option mit ihrer Zahlentaste fasst sofort ohne Anweisungen zusammen.

Häufige Anwendungsfälle

Checkpoints sind besonders nützlich, wenn:

  • Alternativen erkunden: Versuchen Sie verschiedene Implementierungsansätze, ohne Ihren Ausgangspunkt zu verlieren
  • Fehler beheben: Machen Sie schnell Änderungen rückgängig, die Fehler eingeführt oder Funktionalität unterbrochen haben
  • Funktionen iterieren: Experimentieren Sie mit Variationen, da Sie zu funktionierenden Zuständen zurückkehren können
  • Kontextplatz freigeben: Fassen Sie eine ausführliche Debugging-Sitzung von der Mitte an zusammen, während Sie Ihre ursprünglichen Anweisungen intakt halten

Einschränkungen

Bash-Befehlsänderungen werden nicht verfolgt

Checkpointing verfolgt keine Dateien, die durch Bash-Befehle geändert werden. Wenn Claude Code beispielsweise ausführt:

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

Diese Dateiänderungen können nicht durch Zurückspulen rückgängig gemacht werden. Nur direkte Dateibearbeitungen, die durch Claudes Datei-Bearbeitungswerkzeuge vorgenommen werden, werden verfolgt.

Subagent-Bearbeitungen werden nicht wiederhergestellt

Ein Subagent führt Bearbeitungen mit Claudes Datei-Bearbeitungswerkzeugen durch, aber Claude Code erfasst diese Bearbeitungen normalerweise nicht in den Checkpoints Ihrer Sitzung. Ob das Zurückspulen sie wiederherstellt, hängt davon ab, wie der Subagent ausgeführt wird:

  • Foreground-Forked-Skill: ein Skill mit context: fork, der im Vordergrund ausgeführt wird, bearbeitet Ihren Arbeitsbaum während Ihres eigenen Zuges, sodass das Zurückspulen seine Bearbeitungen wie gewohnt wiederherstellt. Setzen Sie background: false, um einen Fork im Vordergrund auszuführen; einige Situationen, aufgelistet auf der Skills-Seite, führen ihn dort unabhängig von der Einstellung aus.
  • Jeder andere Subagent: Das Zurückspulen stellt die Bearbeitungen nicht wieder her. Verwenden Sie Git, um sie rückgängig zu machen. Dies umfasst einen Forked-Skill, der im Hintergrund ausgeführt wird (Standard), und einen Hintergrund-/code-review --fix-Lauf.

Externe Änderungen werden nicht verfolgt

Checkpointing verfolgt nur Dateien, die in der aktuellen Sitzung bearbeitet wurden. Manuelle Änderungen, die Sie an Dateien außerhalb von Claude Code vornehmen, und Bearbeitungen aus anderen gleichzeitigen Sitzungen werden normalerweise nicht erfasst, es sei denn, sie ändern zufällig dieselben Dateien wie die aktuelle Sitzung.

Symverlinkte und hart verlinkte Pfade werden nicht wiederhergestellt

Checkpointing stellt symverlinkte oder hart verlinkte Dateien nicht wieder her. Wenn Sie Code wiederherstellen oder Code und Unterhaltung wiederherstellen aus dem /rewind-Menü auswählen, überspringt Claude Code jeden verfolgten Pfad, der ein Symlink oder Hard Link ist, und zeigt eine Warnung Restored the code, but skipped N files an. Die übersprungenen Dateien behalten ihren aktuellen Inhalt. Um die Änderungen der Sitzung an einer von ihnen rückgängig zu machen, bitten Sie Claude, die Bearbeitung rückgängig zu machen, oder bearbeiten Sie die Datei selbst. Konfigurationsdateien, die ein Dotfile-Manager in Ihr Projekt symlinkt, und Dateien, die pnpm hart verlinkt, fallen beide in diese Kategorie.

Um zu sehen, welche Pfade eine Wiederherstellung überspringt, aktivieren Sie Debug-Protokollierung mit /debug, bevor Sie wiederherstellen: das Debug-Protokoll unter ~/.claude/debug/<session-id>.txt nennt jeden übersprungenen Pfad. Für jeden Grund zum Überspringen und die Wiederherstellungsschritte siehe den Eintrag „skipped-files" in der Fehlerreferenz.

Kein Ersatz für Versionskontrolle

Checkpoints sind für schnelle, sitzungsebene Wiederherstellung konzipiert. Für permanente Versionshistorie und Zusammenarbeit verwenden Sie weiterhin Versionskontrolle wie Git für Commits, Branches und langfristige Historie.

Siehe auch