Claude Code Checkpoints: Code und Konversation zurückspulen
Jeder Claude-Code-Prompt ist ein Checkpoint, den Sie wiederherstellen können. Lernen Sie /rewind und Doppel-Esc kennen, die drei Wiederherstellungsoptionen, was Checkpoints erfassen (und was nicht), Aufbewahrungsgrenzen und wie sie git ergänzen — anhand der offiziellen Doku verifiziert.
Kurz zusammengefasst
- Checkpoints sind automatisch: jeder Prompt, der einen Zug startet, sichert vorher Ihren Code — es gibt nichts einzurichten, Sie müssen nur wissen, wie das Zurückspulen geht.
- Führen Sie /rewind aus (oder drücken Sie bei leerem Prompt zweimal Esc), um ein Menü der Wiederherstellungspunkte zu bekommen, die jeweils anbieten: Code und Konversation wiederherstellen, nur die Konversation oder nur den Code.
- Rewind ist Wiederherstellung auf Sitzungsebene, keine Versionsverwaltung: Bash-Nebenwirkungen (rm, mv, cp), die meisten Subagent-Änderungen und Ihre eigenen manuellen Änderungen werden nicht erfasst. Committen Sie weiterhin nach git.
- Claude Code behält die 100 neuesten Checkpoints einer Sitzung für rund 30 Tage (einstellbar über cleanupPeriodDays), und Checkpoints überleben /resume — Sie können die Sitzung von gestern heute zurückspulen.
12 Claude Code Features Every Engineer Should Know: Subagents, CLAUDE.md, Checkpoints, MCP, and more
Kanal: ByteByteAI7:30
Claude Code Checkpoints Are Here (First Look)
Kanal: Build at Scale8:16
Checkpointing — official documentation
Offizielle Doku: code.claude.com/docs
Jede Wiederherstellungsoption, jeder Grenzwert und jede Aufbewahrungszahl auf dieser Seite ist gegen die offizielle Checkpointing-Dokumentation verifiziert; die Videos oben sind die visuelle und faktische Quelle.
Screenshots werden ihren Urhebern zugeordnet, mit Deep-Links zu den exakten Zeitstempeln. Keine Kamera-Bilder von Gesichtern.
Mit Claude-Code-Checkpoints zurückspulen, Schritt für Schritt
Teil 1 — Was erfasst wird
- 1
Wissen, was ein Checkpoint ist
Ein Checkpoint ist ein automatischer Schnappschuss des Codes, aufgenommen vor jedem Prompt, der einen neuen Zug startet. Er existiert, damit ein schiefgeratener Refactor, ein übervorsichtiger Edit oder eine falsche Richtung nur einen Befehl vom Rückgängigmachen entfernt ist — kein Stashing, kein Committing, kein Zeremoniell.
Das Checkpoints-Versprechen: vor jedem Edit snapshoten, Code und Konversation zurückspulen, wann immer ein Experiment kippt.Ansehen bei 2:15 - 2
Jeder zugstartende Prompt erzeugt einen
Checkpoints legen Sie nicht von Hand an — jeder Prompt, der Claude losschickt, snapshotet die Dateien, die es anfassen wird. Eine lange Sitzung baut eine Kette von Wiederherstellungspunkten auf, einer pro Prompt, wie automatische Spielstände für Ihr Repository.
Die Edit-Schleife: Claude ändert, ein Snapshot landet in der Checkpoint-Kette, und der nächste Prompt startet einen frischen Zyklus.Ansehen bei 2:33 - 3
Das Rewind-Menü mit /rewind öffnen
Tippen Sie /rewind am Prompt, um die Checkpoints der aktuellen Sitzung aufzulisten. Der Tastatur-Weg geht noch schneller: zweimal Esc bei leerem Eingabefeld. (Steht Text im Feld, leert Doppel-Esc ihn nur — mit Pfeil-auf holen Sie Gescheibtes zurück.)
/rewind am Claude-Code-Prompt getippt — die Checkpoint-Liste öffnet sich direkt in der Sitzung.Ansehen bei 2:40 - 4
Wiederherstellungspunkt aussuchen
Das Menü listet jeden Checkpoint mit dem Prompt, der ihn erzeugt hat — „Code und/oder Konversation auf den Punkt davor zurücksetzen…“. Navigieren Sie zu dem Moment, in dem es schiefging, drücken Sie Enter und wählen, was wiederhergestellt werden soll.
Das Wiederherstellungsmenü: den Prompt vor dem Fehler wählen — die rot markierten Einträge sind frühere Fragen dieser Sitzung.Ansehen bei 2:45
Teil 2 — Das Rewind-Menü
- 5
Code und Konversation zusammen wiederherstellen
Der volle Rewind: Dateien kehren in ihren Snapshot-Zustand zurück, und die Konversation gabelt an diesen Punkt zurück. Genau richtig, wenn die ganze Richtung verkehrt war — der Code und Claudes Erinnerung an die Aufgabe werden beide zurückgesetzt.
- 6
Nur den Code wiederherstellen — Konversation behalten
Wer nur den Code wiederherstellt, setzt die Dateien zurück, während die Konversation bleibt, wo sie ist. Perfekt für „der Ansatz stimmt, das Ergebnis nicht“: Claude erinnert sich an alles Besprochene, aber die kaputten Änderungen sind weg.
- 7
Nur die Konversation wiederherstellen — das Gespräch gabeln
Die dritte Option spult die Konversation an einen früheren Punkt zurück und lässt Ihre Dateien unangetastet — dasselbe Forking, das Doppel-Esc schon vor den Checkpoints konnte. Nehmen Sie sie, wenn der Code in Ordnung ist, die Diskussion aber in einem Kaninchenbau gelandet ist.
- 8
Ab hier lieber zusammenfassen statt zurückspulen
Das Menü bietet auch „Summarize from here“ und „Summarize up to here“ — ein gezieltes /compact, das einen Konversationsabschnitt in eine Zusammenfassung verdichtet und Ihre ersten Anweisungen behält. Für echte Gabelungen nutzen Sie /branch oder claude --continue --fork-session.
Teil 3 — Grenzen und die git-Gewohnheit
- 9
Wissen, was Rewind nicht rückgängig machen kann
Checkpoints verfolgen die Dateiänderungen, die Claude vornimmt, nicht alles: Änderungen über Bash (rm, mv, cp), die meisten Subagent-Änderungen, Ihre eigenen manuellen Änderungen und Änderungen anderer Sitzungen werden nicht erfasst. Symlinks werden übersprungen — die Wiederherstellung meldet „Code wiederhergestellt, aber N Dateien übersprungen“.
- 10
Checkpoints vs. git: die Arbeit teilen
Checkpoints sind für schnelle Wiederherstellung auf Sitzungsebene: diesen Prompt ungeschehen machen, die Idee nochmal versuchen. Git ist für die dauerhafte Historie: funktionierende Zustände committen, Branches anlegen, pushen. Der empfohlene Rhythmus: beim Erkunden frei zurückspulen, gezielt committen, wenn eine Änderung es wert ist.
- 11
Das Aufbewahrungsfenster im Blick behalten
Claude Code behält die 100 neuesten Checkpoints pro Sitzung und fegt alte Snapshots nach rund 30 Tagen weg — dieselbe cleanupPeriodDays-Einstellung, die auch den Transkript-Verlauf regelt. Verlängern Sie sie in der settings.json, wenn /rewind und /resume weiter zurückreichen sollen.
Checkpoints vs. Git vs. /branch vs. Doppel-Esc vs. /compact
Claude Code gibt Ihnen fünf Wege zurück — sie lösen verschiedene Probleme:
- 1Checkpoints (/rewind) — sofort, automatisch, auf Sitzungsebene: Code, Konversation oder beides bis zu einer Prompt-Grenze zurücksetzen. Kein Setup, nicht dauerhaft, nicht geteilt.
- 2Git — die echte Historie: explizite Commits, die Sie machen, wenn Arbeit es wert ist. Checkpoints ersetzen es nie; sie sitzen in der Sicherheitskette davor.
- 3/branch und --fork-session — eine parallele Zeitlinie aus der aktuellen Konversation starten, ohne Dateien anzutassen. Für den Fall, dass Sie eine Alternative erkunden und beide Linien behalten wollen.
- 4Doppel-Esc — der Tastaturweg zum selben Rewind-Menü, wenn der Prompt leer ist; mit Text im Feld leert es nur die Eingabe (der Verlauf behält sie, mit Pfeil-auf zurückholen).
- 5/compact und „Summarize from here“ — die Konversation schrumpfen statt in ihr zurückwandern: Kontext zurückgewinnen und Entscheidungen behalten, auf Kosten von Detailtiefe.
Ein einfaches mentales Modell: Rewind für Fehler, git für Fortschritt, Fork für Alternativen, Zusammenfassen für Platz.
Rewind hat nicht getan, was Sie erwarteten? Erste Hilfe
Vier häufige Checkpoint-Überraschungen und was Sie tun:
- 1„No files were restored“. Die Snapshots wurden weggefegt — über die 100-Checkpoint-Grenze oder die rund 30-tägige Aufbewahrung hinaus. Verlängern Sie cleanupPeriodDays in der settings.json für einen längeren Schweif.
- 2„Restored the code, but skipped N files“. Symlinks und Hard Links werden absichtlich übersprungen. Führen Sie /debug aus und prüfen Sie ~/.claude/debug/<session-id>.txt für die exakt übersprungenen Pfade, dann holen Sie diese von Hand zurück.
- 3Über Bash veränderte Dateien bleiben unverändert. rm, mv und cp laufen in der Shell, außerhalb des Snapshot-Systems — machen Sie die mit git checkout rückgängig oder holen Sie sie aus Backups.
- 4Der gesuchte Prompt fehlt in der Liste. Während eines Zugs eingereihte Nachrichten erzeugen keine Checkpoints — spulen Sie stattdessen zum nächstgelegenen zugstartenden Prompt zurück, und Subagent-Änderungen brauchen womöglich ein git revert.
- 5Es gibt gar keinen /rewind-Befehl. Checkpoints kamen mit Claude Code 2.0 — führen Sie claude update (oder claude doctor) aus, um Ihre Version zu prüfen, und bedenken Sie, dass wirklich alte Sitzungen aus der Zeit vor dem Feature keine Snapshots zum Zurückspulen haben.
Goldene Regel: Wenn die Änderung zählt, committe sie. Checkpoints sind der Airbag, git der Sicherheitsgurt — legen Sie beides an.