Claude Code Checkpoints 2026 nutzen: Code und Konversation sicher zurückspulen

Mit Claude Code Checkpoints können Sie die Arbeit eines Agenten in Sekunden rückgängig machen. Claude Code erstellt vor jedem Prompt, der einen Turn startet, automatisch einen Snapshot Ihrer Dateien, und /rewind (oder zweimaliges Drücken von Esc bei leerem Prompt) führt Sie zu jedem früheren Punkt zurück, um den Code, die Konversation oder beides wiederherzustellen. Die Funktion wurde mit Claude Code 2.0 am 29. September 2025 ausgeliefert und ist heute der schnellste Weg, sich zu erholen, wenn ein Agent auf den falschen Pfad gerät.

Eines sollten Sie wissen, bevor Sie sich darauf verlassen: Checkpoints erfassen Claudes eigene Dateiänderungen, nicht alles, was in Ihrem Repository passiert. Das macht sie zu einem Sicherheitsnetz auf Sitzungsebene, das Git ergänzt, aber nicht ersetzt. Wir nutzen Claude Code, um diese Website zu bauen und zu betreiben, und Checkpoints haben verändert, wie aggressiv wir refaktorieren lassen – gerade weil die Rückkehr zu einem bekannten, funktionierenden Zustand nicht mehr bedeutet, sich durch git reflog zu wühlen.

Was sind Claude Code Checkpoints?

Ein Checkpoint ist ein automatischer Snapshot Ihrer Arbeitsdateien, der erstellt wird, bevor ein Turn beginnt. Laut der offiziellen Checkpointing-Dokumentation erzeugt jeder Prompt, den Sie senden und der einen Turn startet, einen – ganz ohne manuelles Zutun. Claude Code bewahrt Datei-Snapshots für die 100 jüngsten Checkpoints einer Sitzung auf und speichert sie zusammen mit der Konversation, sodass /rewind auch dann noch funktioniert, nachdem Sie die Sitzung geschlossen und wieder fortgesetzt haben.

Snapshots werden nicht für immer aufbewahrt. Claude Code löscht die Datei-Snapshots einer Sitzung im Rahmen seines Aufräumlaufs, standardmäßig etwa 30 Tage nachdem die Sitzung zuletzt einen gespeichert hat, sodass das Zurückspulen zu einem sehr alten Checkpoint mit einem No files were restored-Fehler scheitern kann. Wenn sie länger leben sollen, erhöhen Sie die Einstellung cleanupPeriodDays. Für die tägliche Arbeit sind die Standardwerte großzügig; das 30-Tage-Fenster ist vor allem dann relevant, wenn Sie Wochen später zu einem aufgegebenen Experiment zurückkehren.

Wie spult man mit /rewind zurück?

Führen Sie /rewind aus oder drücken Sie zweimal Esc, während die Prompt-Eingabe leer ist, um das Rewind-Menü zu öffnen. (Enthält die Eingabe Text, löscht ein doppeltes Esc stattdessen diesen; der gelöschte Text wandert in Ihren Eingabeverlauf, sodass Up ihn zurückholt.) Das Menü listet die Prompts auf, die Sie während der Sitzung gesendet haben. Wählen Sie den Punkt, an dem Sie ansetzen möchten, und dann eine Aktion:

• Restore code and conversation: Beides auf diesen Punkt zurücksetzen.
• Restore conversation: Den Chat zurückspulen und dabei Ihren aktuellen Code behalten.
• Restore code: Dateiänderungen zurücksetzen und dabei die Konversation behalten.
• Summarize from here / Summarize up to here: Einen Teil der Konversation komprimieren, um Kontext freizugeben (mehr dazu weiter unten).
• Never mind: Ohne Änderungen abbrechen.

Die beiden Code-Wiederherstellungsoptionen erscheinen nur, wenn dieser Checkpoint tatsächlich Dateiänderungen erfasst hat. Nach einer Wiederherstellung der Konversation fällt der ursprüngliche Prompt zurück in die Eingabe, sodass Sie ihn bearbeiten und erneut senden können. Eine praktische Angewohnheit: Wenn eine Änderung schiefgeht, spulen Sie zu dem Prompt zurück, der den schlechten Turn gestartet hat, statt zu einer Nachricht mitten im Turn – so machen Sie die gesamte Änderung sauber rückgängig.

Was Checkpoints erfassen (und was heimlich nicht)

Dies ist der Teil, den die meisten Tutorials überspringen, und genau hier verbrennen sich Leute die Finger. Checkpointing überwacht Dateien, die Claude mit seinen Datei-Bearbeitungswerkzeugen in der aktuellen Sitzung geändert hat. Alles außerhalb dieser Spur ist nur teilweise oder gar nicht abgedeckt. Die folgende Tabelle schlüsselt es auf, entnommen aus dem Abschnitt zu den Einschränkungen in der Dokumentation.

Änderung	Von /rewind zurückgesetzt?	Hinweise
Claudes Datei-Tool-Bearbeitungen	Ja	Der Kernfall; dafür existieren Checkpoints.
Bash-Änderungen an einer Datei, die Claude bereits bearbeitet hat	Ja	Sobald Claude eine Datei berührt hat, werden auch spätere Shell-Änderungen daran rückgängig gemacht.
Eine Datei, die ausschließlich von Bash geändert wurde	Nein	Wird nie erfasst; nutzen Sie Git, um sie zurückzusetzen.
Subagent-Bearbeitungen (Hintergrund-Skill, /code-review --fix)	Meist nein	Nur die Bearbeitungen eines im Vordergrund geforkten Skills werden wiederhergestellt; Bearbeitungen anderer Subagents bleiben bestehen.
Manuelle Änderungen, die Sie in Ihrem Editor vornehmen	Nein	Externe Änderungen werden nicht erfasst, es sei denn, sie betreffen dieselben Dateien.
Bearbeitungen aus einer anderen parallelen Sitzung	Nein	Gleicher Grund; behandeln Sie Git als die Quelle der Wahrheit.
Symbolisch oder hart verlinkte Pfade	Nein	Werden beim Wiederherstellen mit einer skipped N files-Warnung übersprungen.

Die Quintessenz: /rewind ist hervorragend, um eine Reihe von Claudes Bearbeitungen rückgängig zu machen, und nutzlos, um rückgängig zu machen, was ein Shell-Befehl oder ein Hintergrund-Subagent an nicht erfassten Dateien getan hat. Committen Sie vor großen Operationen, und Sie decken beides ab.

Kontext freigeben mit den Summarize-Optionen

Das Rewind-Menü dient zugleich als Werkzeug zur Kontextverwaltung, was man leicht übersieht. Summarize from here komprimiert die Konversation von einem gewählten Punkt an vorwärts zu einer Zusammenfassung; Summarize up to here komprimiert alles vor diesem Punkt, während spätere Nachrichten unangetastet bleiben. Beide hinterlassen eine Summarized conversation-Markierung im Transkript und funktionieren wie ein gezieltes /compact: Sie geben Platz im Kontextfenster frei, ohne Dateien auf der Festplatte anzurühren.

Das ist bei langen Debugging-Sitzungen wirklich nützlich. Sie können Ihre ursprünglichen Anweisungen und den finalen funktionierenden Zustand behalten und dabei einen ausschweifenden Mittelabschnitt voller Versuch und Irrtum zusammenklappen. Sie können außerdem eine Summarize-Option markieren und in der Zeile add context (optional) eine Anweisung eintippen, um zu steuern, was die Zusammenfassung behält. Wenn Sie stattdessen abzweigen und einen anderen Ansatz ausprobieren möchten, ohne den ursprünglichen Thread anzutasten, verwenden Sie /branch oder claude --continue --fork-session, anstatt zusammenzufassen. Wenn Sie eine große Änderung planen, hält die Kombination damit und dem Plan-Modus die Sitzung von Anfang an schlank.

Checkpoints vs. Git: Worauf sollten Sie sich verlassen?

Sie lösen unterschiedliche Probleme, daher lautet die ehrliche Antwort: auf beides. Checkpoints geben Ihnen sofortiges Rückgängigmachen auf Sitzungsebene – ohne Staging, ohne Commit-Nachrichten und ohne Git-Kenntnisse –, ideal für die schnelle Schleife „ausprobieren, verwerfen, zurücksetzen" innerhalb einer einzigen Sitzung. Git gibt Ihnen dauerhafte Historie, Branches, Zusammenarbeit und einen Verlauf, der den 30-Tage-Aufräumlauf überlebt und jede Datei im Repository erreicht, unabhängig davon, was sie verändert hat.

Ein Workflow, der sich bewährt: Committen Sie eine saubere Basislinie, bevor Sie Claude eine große Aufgabe übergeben, nutzen Sie /rewind großzügig, um innerhalb der Sitzung zu iterieren, und committen Sie erneut, sobald Sie zufrieden sind. So erledigt der Checkpoint die Minute-für-Minute-Wiederherstellung, und Git erledigt alles, was Checkpoints bewusst nicht abdecken: Bash-Nebenwirkungen, Subagent-Bearbeitungen und alles, was Sie von Hand angefasst haben. Wenn Sie mehrere Agenten gleichzeitig laufen lassen, deckt unser Leitfaden zu Git-Worktrees für parallele KI-Coding-Agenten die Isolierung ab, die Checkpoints allein Ihnen nicht geben können.

Häufig gestellte Fragen

Ersetzen Claude Code Checkpoints Git?

Nein. Checkpoints sind für die schnelle Wiederherstellung von Claudes eigenen Bearbeitungen auf Sitzungsebene gebaut und arbeiten unabhängig von Git. Sie geben Ihnen keine dauerhafte Historie, keine Branches und keine Zusammenarbeit, und ihre Snapshots werden nach etwa 30 Tagen aufgeräumt. Nutzen Sie Git weiterhin für Commits und die langfristige Versionskontrolle.

Macht /rewind Änderungen rückgängig, die durch Bash-Befehle vorgenommen wurden?

Teilweise. Wenn Claude eine Datei bereits mit seinen Datei-Bearbeitungswerkzeugen bearbeitet hatte, werden spätere Bash-Änderungen an derselben Datei beim Zurückspulen rückgängig gemacht. Eine Datei, die ausschließlich ein Bash-Befehl jemals geändert hat, wird überhaupt nicht erfasst, sodass Sie Git brauchen, um sie zurückzusetzen.

Wie viele Checkpoints werden aufbewahrt, und wie lange?

Claude Code bewahrt Datei-Snapshots für die 100 jüngsten Checkpoints einer Sitzung auf. Die Snapshots werden im Aufräumlauf etwa 30 Tage nachdem die Sitzung zuletzt einen gespeichert hat gelöscht, es sei denn, Sie verlängern cleanupPeriodDays in den Einstellungen.

Kann ich nach dem Fortsetzen einer Sitzung oder nach dem Ausführen von /clear zurückspulen?

Ja. Checkpoints werden mit der Konversation gespeichert, sodass /rewind funktioniert, nachdem Sie eine Sitzung fortgesetzt haben. Wenn Sie zuvor im selben Prozess /clear ausgeführt haben, zeigt das Menü oben einen Eintrag /resume <session-id> (previous session), sodass Sie zur Konversation vor dem Löschen zurückkehren können.

Stellt das Zurückspulen Bearbeitungen wieder her, die ein Subagent vorgenommen hat?

Meist nicht. Nur die Bearbeitungen eines im Vordergrund geforkten Skills werden in den Checkpoints Ihrer Sitzung erfasst. Bearbeitungen von Hintergrund-Subagents, geforkten Skills oder einem /code-review --fix-Lauf bleiben bestehen, setzen Sie diese also mit Git zurück.

Sources

• Checkpointing — Claude Code Docs: wie Checkpoints erstellt werden, das /rewind-Menü und die Wiederherstellungsoptionen, die Aufbewahrung (100 Snapshots, ~30 Tage, cleanupPeriodDays) und die vollständige Liste der Einschränkungen.
• Enabling Claude Code to work more autonomously — Anthropic: die Ankündigung von Claude Code 2.0, mit der Checkpoints am 29. September 2025 eingeführt wurden.
• Settings reference — Claude Code Docs: die Einstellung cleanupPeriodDays, die steuert, wie lange Snapshots aufbewahrt werden.