Inhalt
"Ich habe Claude Code laufen lassen, und die Änderung ging in eine Richtung, die ich nicht wollte." Genau für diesen Moment lassen Checkpointing und /rewind Sie mit ein paar Tastendrücken zu dem Zustand zurückkehren, bevor etwas schiefging. Claude Code erstellt vor jeder Bearbeitung automatisch einen Snapshot des Zustands, und mit /rewind oder zweimal Esc kehren Sie zu einem früheren Zustand zurück.
Dieser Artikel behandelt – auf Basis der offiziellen Dokumentation – was Checkpointing ist, wie man es nutzt, was wiederhergestellt wird und was nicht (am wichtigsten), worin es sich von Git unterscheidet, wie man damit Fehler behebt und seine Verfügbarkeit. Die Kernpunkte vorweg. ① Es verfolgt Dateibearbeitungen automatisch, und jeder Prompt wird zu einem Wiederherstellungspunkt. ② Öffnen Sie das Menü mit /rewind oder zweimal Esc und wählen Sie, ob Sie Code, Konversation oder beides wiederherstellen. ③ Aber nur "Claudes Dateibearbeitungen" werden wiederhergestellt—Änderungen durch bash-Befehle oder außerhalb von Claude nicht. Deshalb ist es kein Ersatz für Git.
Änderungen zurück auf "bevor es schiefging"
— jeder Prompt ist ein Wiederherstellungspunkt; zurück mit zweimal Esc
1. Was Checkpointing und /rewind sind
Die offizielle Definition: "Claude Code verfolgt Claudes Dateibearbeitungen automatisch, während Sie arbeiten, sodass Sie Änderungen schnell rückgängig machen und zu früheren Zuständen zurückspulen können, falls etwas aus dem Ruder läuft." Ein Snapshot wird automatisch vor jeder Bearbeitung erstellt, und darüber hinaus erzeugt jeder Prompt, den Sie senden, einen neuen Checkpoint (einen Punkt, zu dem Sie zurückkehren können). Checkpoints bleiben über Sitzungen hinweg erhalten, sodass Sie auch in fortgesetzten Konversationen darauf zugreifen können.
Mit anderen Worten bedeutet diese Funktion: "Selbst wenn Sie etwas an die KI übergeben und es schiefgeht, kommen Sie mit ein paar Tastendrücken zu einem sicheren Punkt zurück." Im interaktiven Claude Code (der CLI) ist /rewind automatisch und standardmäßig aktiviert.
2. So wird es genutzt (/rewind und Esc Esc)
Es gibt zwei Wege, das Rewind-Menü zu öffnen: tippen Sie /rewind, oder drücken Sie zweimal Esc, wenn das Eingabefeld leer ist.
⚠️ Hinweis zu Esc Esc: wenn das Eingabefeld Text enthält, löscht zweimaliges Drücken von Esc die Eingabe, statt das Menü zu öffnen. Der gelöschte Text wird in Ihrem Eingabeverlauf gespeichert, also drücken Sie die Aufwärtspfeiltaste, um ihn wieder abzurufen. Um sicherzugehen, dass das Menü öffnet, leeren Sie das Eingabefeld zuerst.
Das Menü listet jeden Prompt auf, den Sie während der Sitzung gesendet haben. Wählen Sie den gewünschten Punkt und dann eine Aktion.
| Aktion | Was sie bewirkt |
|---|---|
| Code und Konversation wiederherstellen | Beides auf diesen Punkt zurücksetzen |
| Konversation wiederherstellen | Zu dieser Nachricht zurückspulen, aber aktuellen Code behalten |
| Code wiederherstellen | Nur Dateiänderungen zurücksetzen, die Konversation behalten |
| Ab/bis hier zusammenfassen | Kontext komprimieren (kein Rewind; Dateien unverändert) |
| Doch nicht | Ohne Änderungen verlassen |
Nach "Konversation wiederherstellen" (und ähnlich) wird der ursprüngliche Prompt der ausgewählten Nachricht wieder ins Eingabefeld geladen, sodass Sie ihn erneut senden oder bearbeiten können. "Code wiederherstellen" bei gleichzeitigem Behalten der Konversation lässt Sie umformulieren – im Wissen darum, was schiefging – das ist der Ablauf, den Sie in der Praxis am häufigsten nutzen werden.
3. Was wiederhergestellt wird und was nicht (am wichtigsten)
Das ist der am häufigsten missverstandene Teil der Funktion. Checkpointing verfolgt nur "Änderungen, die durch Claudes Dateibearbeitungstools (Write / Edit / NotebookEdit) vorgenommen wurden." Jeder andere Nebeneffekt wird durch Rewind nicht rückgängig gemacht.
⚠️ Nicht wiederhergestellt (laut offizieller Dokumentation)
- Dateiänderungen durch bash-Befehle:
rm file.txt,mv old.txt new.txt,cp source destusw. können nicht per Rewind rückgängig gemacht werden - Änderungen außerhalb der Sitzung / aus anderen Sitzungen: manuelle Bearbeitungen und Änderungen paralleler Sitzungen werden nicht erfasst, sofern sie nicht dieselben Dateien betreffen
- Erstellen, Verschieben oder Löschen von Verzeichnissen / Remote- oder Netzwerkdateien
Datenbankzustand, Migrationen, Paketinstallationen, Netzwerkaufrufe – jeder "Nebeneffekt, der keine Dateibearbeitung ist", wird ebenfalls nicht rückgängig gemacht (die Dokumentation führt dies nicht aus, aber da nur Dateiänderungen über die Bearbeitungstools verfolgt werden, folgt das logisch). Kurz gesagt: merken Sie sich, dass nur "der Inhalt von Dateien, die Claude mit seinen Bearbeitungstools umgeschrieben hat" wiederhergestellt werden kann. Und da Claude Dateien auch über Bash ändern kann, ist die sichere Praxis, sich nicht zu sehr auf Rewind zu verlassen und an Meilensteinen in Git zu committen.
4. Worin es sich von Git unterscheidet
Die Dokumentation rahmt es als "Checkpoints sind lokales 'Rückgängig', und Git ist 'dauerhafte Historie'" und sagt klar, dass "Checkpoints eine ordentliche Versionskontrolle ergänzen, aber nicht ersetzen."
- Automatisch, sofort, ohne Einrichtung
- Ideal zum Experimentieren innerhalb der Sitzung
- Deckt Dateiänderungen durch Bearbeitungstools ab
- Wird nach 30 Tagen bereinigt (konfigurierbar)
- Commits, Branches, Langzeitspeicherung
- Erfasst auch bash-Änderungen
- Im Team teil- und überprüfbar
- Verschwindet nicht (bis Sie es löschen)
Die Arbeitsteilung ist einfach: Checkpoints für schnelles Rückgängigmachen innerhalb der Sitzung, Git-Commits für eine dauerhafte Historie. Committen Sie an den Meilensteinen einer größeren Aufgabe, und Sie können sicher zurückkehren – auch über das hinaus, was Rewind nicht abdeckt (etwa bash-Änderungen).
5. Fehler beheben
/rewind ist auch ein Wiederherstellungswerkzeug, wenn die Konversation abbricht und nicht fortgesetzt werden kann. Die offizielle Fehlerreferenz von Claude Code lässt beim 400-Fehler rund um die Nebenläufigkeit der Tool-Nutzung und Thinking-Blöcke das Produkt selbst sagen: "API Error: 400 ... Run /rewind to recover the conversation." Drücken Sie zweimal Esc, um zu einem Checkpoint vor dem beschädigten Zug zurückzuspringen und von dort fortzufahren. Das ist auch die Hauptwiederherstellung für den court / invoke Tag-Leak (tool_use-Nebenläufigkeit)-Fehler.
⚠️ Versionshinweis: wenn Sie Opus 4.7 / 4.8 nutzen, führen Sie zuerst claude update aus. Laut Dokumentation können Versionen vor v2.1.156 diesen Fehler bei normaler Tool-Nutzung auslösen, und /rewind behebt ihn nicht. Das Aktualisieren kommt zuerst.
Wenn Rewind die Ursache nicht erreichen kann (z. B. Beschädigung durch Kontextkomprimierung), können Sie mit /clear auch ganz neu beginnen. Zum Umgang mit Fehlern im Allgemeinen siehe die Claude-Code-Fehlerübersicht.
6. Verfügbarkeit und Aufbewahrung
Im interaktiven Claude Code (der CLI) ist es automatisch und standardmäßig aktiviert – ohne besondere Einrichtung. Im Agent SDK hingegen ist es ein expliziter Opt-in (z. B. enableFileCheckpointing); halten Sie die beiden auseinander.
Zur Aufbewahrung: Checkpoints werden zusammen mit den Sitzungen nach 30 Tagen bereinigt (konfigurierbar). Die Dokumentation führt den Speicherort auf der Festplatte, einen An/Aus-Schalter oder den konkreten Konfigurationsschlüssel für die Aufbewahrungsdauer nicht aus, daher behauptet dieser Artikel das nicht (prüfen Sie die offizielle Dokumentation für den aktuellen Stand). Die Funktion kam mit Claude Code v2.0.0 (September 2025) und wurde damals als "die am häufigsten gewünschte Funktion" gemeldet (Veröffentlichungsdatum und Hintergrund stammen aus Sekundärquellen).
Zusammenfassung
Checkpointing und /rewind sind ein Sicherheitsnetz, das Claudes Dateibearbeitungen automatisch verfolgt und Sie mit ein paar Tastendrücken zu "bevor es schiefging" zurückrollen lässt. Jeder Prompt wird zu einem Wiederherstellungspunkt, und Sie öffnen das Menü mit /rewind oder zweimal Esc, um Code, Konversation oder beides zurückzusetzen. In der Praxis ist der zentrale Ablauf "Code wiederherstellen bei behaltener Konversation" und dann umformulieren.
Der wichtigste Vorbehalt: "nur Claudes Dateibearbeitungen werden wiederhergestellt" – Änderungen durch bash-Befehle, externe Änderungen, Verzeichnisoperationen, Datenbanken und Ähnliches nicht. Es ist also kein Ersatz für Git; committen Sie grundsätzlich an Meilensteinen. Und /rewind stellt auch eine abgebrochene Konversation wieder her, etwa beim 400-Fehler (bei alten Versionen zuerst claude update). Verwandt: der court/invoke-Fehler, Claude-Code-Fehler, Hooks.
FAQ
F. Wofür ist Checkpointing da?
A. Es ist ein Sicherheitsnetz, um Änderungen schnell auf "bevor es schiefging" zurückzurollen. Claude Code erstellt vor jeder Bearbeitung automatisch einen Snapshot, und jeder Prompt, den Sie senden, wird zu einem Wiederherstellungspunkt. Selbst wenn Sie etwas an die KI übergeben und es schiefgeht, kehren Sie mit /rewind oder zweimal Esc zu einem früheren Zustand zurück. In der interaktiven CLI ist es standardmäßig aktiviert.
F. Wie nutze ich es?
A. Tippen Sie /rewind, oder drücken Sie zweimal Esc, wenn das Eingabefeld leer ist, um das Menü zu öffnen. Wählen Sie aus der Liste der von Ihnen gesendeten Prompts den Punkt, zu dem Sie zurückkehren möchten, und wählen Sie "Code und Konversation wiederherstellen", "Konversation wiederherstellen" oder "Code wiederherstellen". Am häufigsten ist "Code wiederherstellen (Konversation behalten)" und dann umformulieren Ihrer Anweisung – im Wissen darum, was schiefging. Beachten Sie: enthält das Eingabefeld Text, löscht zweimaliges Esc stattdessen die Eingabe.
F. Werden auch per bash erstellte oder gelöschte Dateien wiederhergestellt?
A. Nein. Nur Dateiänderungen durch Claudes Bearbeitungstools (Write / Edit / NotebookEdit) werden wiederhergestellt. Änderungen durch bash-Befehle (rm, mv, cp usw.), Änderungen außerhalb der Sitzung oder aus anderen Sitzungen, das Erstellen/Verschieben/Löschen von Verzeichnissen sowie Remote-Dateien werden durch Rewind nicht rückgängig gemacht. Dasselbe gilt für "Nebeneffekte, die keine Dateibearbeitungen sind", etwa den Datenbankzustand. Genau deshalb sollten Sie an Meilensteinen in Git committen.
F. Ersetzt es Git?
A. Nein. Die Dokumentation rahmt es als "Checkpoints = lokales Rückgängig, Git = dauerhafte Historie" und sagt, dass es die Versionskontrolle ergänzt, aber nicht ersetzt. Checkpoints eignen sich am besten für schnelles Rückgängigmachen innerhalb der Sitzung und werden nach 30 Tagen bereinigt (konfigurierbar). Nutzen Sie Git weiterhin für Commits, Branches, Langzeitspeicherung und das Teilen im Team.
F. Kann ich es nutzen, wenn ein Fehler die Konversation blockiert?
A. Ja. Beim 400-Fehler rund um die Nebenläufigkeit der Tool-Nutzung oder Thinking-Blöcke sagt das Produkt selbst "Run /rewind to recover the conversation." Drücken Sie zweimal Esc, um zu dem Zustand vor dem beschädigten Zug zurückzuspringen und fortzufahren. Aber Versionen vor v2.1.156 beheben es per /rewind möglicherweise nicht, führen Sie also bei Opus 4.7 / 4.8 zuerst claude update aus. Siehe auch den Artikel zum court/invoke-Fehler.
