Claude Code Sitzung fortsetzen und Verlauf finden

So setzen Sie eine Claude-Code-Sitzung fort

Führen Sie claude --continue aus, um die letzte Unterhaltung im aktuellen Verzeichnis fortzusetzen, oder claude --resume, um eine ältere Unterhaltung aus einer Liste auszuwählen. Innerhalb einer bereits laufenden Sitzung wechseln Sie mit dem Befehl /resume zu einer anderen Unterhaltung, ohne die Sitzung zu beenden. Die Kurzformen sind -c und -r.

claude --continue
claude --resume
claude --resume auth-refactor

Wenn Sie den Namen oder die ID der Sitzung bereits kennen, übergeben Sie sie als Argument. Claude Code wechselt dann direkt zu dieser Sitzung, ohne die Auswahlliste anzuzeigen.

Alle folgenden Angaben entsprechen der offiziellen Sitzungsdokumentation mit Stand August 2026. Claude Code wird häufig veröffentlicht. Dabei ändern sich auch Flag-Namen und Tastaturkürzel. Orientieren Sie sich daher an claude --help und dieser Seite, wenn die Angaben nicht mit der Ausgabe Ihres Terminals übereinstimmen.

Was eine Sitzung tatsächlich ist

Eine Sitzung ist eine gespeicherte Unterhaltung, die an ein Projektverzeichnis gebunden ist. Sie enthält den vollständigen Nachrichtenverlauf, einschließlich der von Claude ausgeführten Tool-Aufrufe und der von diesen Aufrufen zurückgegebenen Ergebnisse. Claude Code schreibt die Daten während Ihrer Arbeit kontinuierlich auf die Festplatte und nicht erst am Ende. Dadurch bleibt die Unterhaltung auch nach dem Schließen des Terminals oder dem Abbruch der SSH-Verbindung erhalten.

Beim Fortsetzen wird mehr als nur der Text wiederhergestellt. Der vollständige Unterhaltungsverlauf wird geladen, ebenso das Modell, das die Sitzung verwendet hat, und der Subagent, mit dem sie gestartet wurde, falls Sie --agent verwendet haben. Auch der Berechtigungsmodus wird wiederhergestellt. Aus Sicherheitsgründen gibt es jedoch Ausnahmen: Der Planmodus und der Modus zum Umgehen von Berechtigungen werden nie wiederhergestellt. Eine Sitzung, die sich in einem dieser Modi befand, wird daher in dem Modus fortgesetzt, mit dem eine neue Sitzung starten würde.

Einige Einstellungen werden nicht wiederhergestellt, weil sie beim Start übergebene Flags und kein gespeicherter Zustand waren. Mit --add-dir hinzugefügte Verzeichnisse sowie Optionen wie --mcp-config, --settings und --plugin-dir müssen beim Fortsetzen erneut übergeben werden. Einstellungsdateien wie settings.json werden beim Start erneut eingelesen. Einstellungen aus diesen Dateien müssen daher nicht erneut angegeben werden. Für Zugangsdaten gilt dasselbe: Claude Code ermittelt beim Start anhand Ihrer Anmeldung und Ihrer Umgebung, wie die Authentifizierung erfolgen soll. Die Authentifizierung wird nicht zusammen mit der Unterhaltung wiederhergestellt. Wird eine Sitzung auf einem VPS fortgesetzt, in dessen Shell sich unbemerkt ANTHROPIC_API_KEY befindet, tritt daher der Fehler aufgrund eines ungültigen API-Schlüssels auf, obwohl sie beim letzten Mal ordnungsgemäß ausgeführt wurde.

Warum der Sitzungsverlauf auf einem VPS wichtiger ist

Hier ist die Tatsache, die viele überrascht. Das Transkript wird auf dem Rechner gespeichert, auf dem der Agent ausgeführt wurde. Es befindet sich nicht in Ihrem Konto und wird nicht mit einer Cloud synchronisiert. Es ist eine Datei auf der Festplatte dieses Rechners.

Eine Sitzung, die Sie in einem tmux-Fenster auf Ihrem VPS zurückgelassen haben, erscheint daher nicht in der Auswahlliste auf Ihrem Laptop. Eine Sitzung von Ihrem Laptop erscheint umgekehrt nicht auf dem VPS. Zwischen den Rechnern wird nichts übertragen. Wenn Sie wie die meisten Benutzer Claude Code in tmux auf einem VPS ausführen, sammelt sich Ihr tatsächlicher Gesprächsverlauf auf dem Server an. Die lokal angezeigte Auswahlliste enthält dann eine andere und deutlich kleinere Auswahl.

Dieselbe Trennung gilt für die verschiedenen Oberflächen. Die Desktop-App und die VS Code-Erweiterung führen jeweils einen eigenen Sitzungsverlauf. Keine von beiden verwendet den Verlauf der CLI. Claude Code im Web führt ebenfalls einen eigenen Verlauf. Cowork ist noch weiter davon getrennt. Es läuft in einer Anthropic-Sandbox und nicht auf Hardware, die Sie besitzen. Wenn Sie Cowork mit Claude Code vergleichen, ist der Speicherort des Transkripts daher ein Teil der Entscheidung.

Auf einem einzelnen Rechner durchsucht die Suche mehr, als Sie vielleicht erwarten. claude --resume <session-id> sucht zuerst im aktuellen Projektverzeichnis und in dessen Git-Worktrees. Danach durchsucht der Befehl jedes andere Projekt auf diesem Rechner. Entscheidend ist die Formulierung „auf diesem Rechner“. Eine Sitzungs-ID von einem anderen Host führt zu keinem Ergebnis. Claude Code weist Sie mit No conversation found with session ID: <session-id> darauf hin.

Wo speichert Claude Code den Sitzungsverlauf

Standardmäßig werden Transkripte in Ihrem Claude-Code-Konfigurationsverzeichnis unter einem Pfad der Form ~/.claude/projects/<project>/<session-id>.jsonl gespeichert.

<project> ist der Pfad Ihres Arbeitsverzeichnisses, wobei jedes nicht alphanumerische Zeichen durch einen Bindestrich ersetzt wird. Eine Sitzung, die in /home/deploy/apps/api gestartet wurde, wird daher in einem Verzeichnis mit dem Namen -home-deploy-apps-api gespeichert. Würde dieser umgewandelte Name mehr als 200 Zeichen umfassen, kürzt Claude Code ihn und hängt einen Hash des vollständigen Pfads an. Dadurch bleibt der Verzeichnisname innerhalb der Dateisystemgrenzen.

Die Datei verwendet das JSONL-Format: Pro Zeile steht ein JSON-Objekt. Jede Zeile enthält eine Nachricht, eine Tool-Verwendung oder einen Metadateneintrag. Die Datei ist lesbarer Text. Das Lesen ist unproblematisch.

Sie sollten jedoch keinen Parser dafür schreiben. Das Format der Einträge ist intern und ändert sich zwischen den Versionen von Claude Code. Ein Skript, das diese Dateien direkt liest, kann daher nach jedem Update ausfallen. Die Dokumentation von Anthropic empfiehlt aus genau diesem Grund, stattdessen /export oder die dokumentierten Skriptschnittstellen zu verwenden.

Zwei Einstellungen ändern diesen Speicherort und die Aufbewahrung. CLAUDE_CONFIG_DIR verschiebt das gesamte Konfigurationsverzeichnis. Damit können Sie Transkripte auf einem separaten oder verschlüsselten Volume speichern. cleanupPeriodDays in settings.json steuert, wie lange die Transkripte aufbewahrt werden. Der Standardwert beträgt 30 Tage, der Mindestwert 1.

Was tatsächlich in diesen Transkriptdateien enthalten ist

Jedes Tool-Ergebnis wird aufgezeichnet. Ein Transkript enthält daher den Inhalt der Dateien, die Claude gelesen hat, sowie die Ausgabe der Befehle, die Claude ausgeführt hat. Auf der Datennutzungsseite von Anthropic wird das ausdrücklich erklärt: Claude Code speichert Sitzungstranskripte lokal als Klartext unter ~/.claude/projects/.

Überlegen Sie, was das auf einem Server bedeutet. Wenn Claude eine .env-Datei gelesen hat, um zu ermitteln, warum ein Dienst nicht gestartet ist, befindet sich der Inhalt dieser Datei nun in einer JSONL-Datei in Ihrem Home-Verzeichnis. Wenn ein Befehl eine Verbindungszeichenfolge ausgegeben hat, ist auch diese dort enthalten. Es ist nichts nach außen gelangt. Das Transkript hat lediglich aufgezeichnet, was passiert ist. Genau dafür ist es gedacht. Deshalb gehört es in Ihr Bedrohungsmodell.

• Backups: Ein einfaches Backup von /home oder /root kopiert Ihre Transkripte an den Ort, an dem Backups gespeichert werden. Fügen Sie einen Ausschluss hinzu. Andernfalls liegen Kopien Ihrer Prompts und Dateiinhalte künftig auch in Ihrem Backup-Speicher.
• Snapshots und Images: Ein aus beliebigem Grund erstellter VPS-Snapshot enthält das gesamte Verzeichnis. Das gilt auch für ein Image, das Sie klonen, um daraus einen zweiten Server zu erstellen.
• Andere Accounts auf dem System: Prüfen Sie die Berechtigungen selbst mit ls -ld ~/.claude ~/.claude/projects, statt davon auszugehen, dass sie ausreichend restriktiv sind.
• Bewusste Uploads: Der Befehl /feedback sendet den Gesprächsverlauf absichtlich an Anthropic. Auch /bug und /share übertragen Informationen über denselben Weg. Diese Aktionen führen Sie selbst aus. Informieren Sie sich daher vor der Bestätigung darüber, worauf Sie sich einlassen.

Wenn Sie grundsätzlich kein Transkript wünschen, unterdrückt CLAUDE_CODE_SKIP_PROMPT_HISTORY das Schreiben von Transkripten. --no-session-persistence unterdrückt es für einen einzelnen nicht interaktiven claude -p-Lauf. Machen Sie sich die Konsequenzen klar, bevor Sie eine der beiden Optionen setzen. Für das Fortsetzen einer Sitzung werden Transkripte benötigt. Ohne Transkript ist daher kein Fortsetzen möglich.

So finden Sie eine alte Unterhaltung

Öffnen Sie die Auswahl mit claude --resume oder innerhalb einer laufenden Sitzung mit /resume. Jede Zeile zeigt den Sitzungsnamen, falls Sie einen festgelegt haben, oder einen generierten Titel, falls nicht. Außerdem werden die Zeit seit der letzten Aktivität, der Git-Branch und die Dateigröße angezeigt.

Die Auswahl bietet eine Suchfunktion. Drücken Sie / oder beginnen Sie einfach mit der Eingabe, um die Liste zu filtern. Die wichtigsten Tastenkürzel erweitern den Suchbereich: Ctrl+A zeigt Sitzungen aus allen Projekten auf diesem Rechner, Ctrl+W zeigt alle Worktrees des aktuellen Repositorys und Ctrl+B filtert auf den aktuellen Git-Branch. Drücken Sie Space, um den Inhalt einer Sitzung vor der Auswahl in einer Vorschau anzuzeigen, und Ctrl+R, um die markierte Sitzung umzubenennen.

Mit benannten Sitzungen wird das deutlich einfacher. Starten Sie eine Sitzung mit claude -n auth-refactor oder führen Sie /rename auth-refactor an der Stelle aus, an der Sie feststellen, dass sich die Unterhaltung zu einer echten Arbeitsaufgabe entwickelt hat. Eine benannte Sitzung können Sie anschließend direkt aus der Shell anhand ihres Namens fortsetzen.

Eine unbenannte Sitzung erhält weiterhin einen generierten Titel. Dieser wird von einer Hintergrundanfrage an ein kleines, schnelles Modell erstellt, das Ihre erste Eingabe zusammenfasst. Der Titel hilft Ihnen, die Zeile in der Auswahl wiederzuerkennen. Er kann jedoch nicht zum Fortsetzen der Sitzung verwendet werden. claude --resume <name> findet nur Namen, die Sie selbst festgelegt haben.

Nach Text in Transkripten suchen, um die richtige Sitzung zu finden

Manchmal erinnern Sie sich an eine Formulierung und an nichts anderes. Die Transkripte sind Textdateien. Sie können darin suchen.

grep -rl "nftables" ~/.claude/projects/

Der Befehl gibt die Pfade der passenden Transkripte aus. Der Dateiname ohne die Erweiterung .jsonl ist die Sitzungs-ID, und claude --resume <session-id> akzeptiert diese ID. Ermitteln Sie mit grep, welche Sitzung Sie benötigen. Setzen Sie sie anschließend fort oder exportieren Sie sie, um den Inhalt tatsächlich zu lesen.

Beachten Sie zwei Einschränkungen. Der Inhalt ist JSON-escaped. Eine Formulierung mit Anführungszeichen oder eine Formulierung, die über einen Zeilenumbruch hinweg aufgeteilt wurde, wird daher möglicherweise nicht als Literalzeichenkette gefunden. Ein Treffer innerhalb eines Tool-Ergebnisses bedeutet außerdem, dass Claude diesen Text gesehen hat. Er bedeutet nicht, dass jemand ihn eingegeben hat.

Lesen und Exportieren einer Unterhaltung

/export gibt die aktuelle Unterhaltung als Klartext aus. Nachrichten und Tool-Ausgaben werden dabei lesbar statt als JSON dargestellt. Ohne Argument öffnet der Befehl ein Menü, in dem Sie die Zwischenablage oder eine Datei auswählen können. Mit einem Dateinamen schreibt /export handover.txt direkt in diesen Pfad. So übertragen Sie eine Unterhaltung von einem Server auf Ihren Laptop oder hängen sie an ein Ticket an.

Verwenden Sie für Automatisierungen die dafür vorgesehenen stabilen Schnittstellen. Hooks und Befehle für die Statuszeile erhalten ein Feld transcript_path als Eingabe. Ein SessionEnd-Hook kann daher ein Transkript archivieren, wenn eine Sitzung endet. Sie können einer gespeicherten Sitzung auch eine Frage stellen, ohne sie zu öffnen:

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

Dadurch wird eine Folgeaufforderung an die alte Unterhaltung gesendet und strukturiertes JSON zurückgegeben. Das ist eine deutlich bessere Grundlage, als ein JSONL-Format zu parsen, das sich in der nächsten Version ändern kann.

Wenn ein Neustart besser ist als das Fortsetzen

Beim Fortsetzen wird die gesamte Historie wiederhergestellt. Jede spätere Anfrage enthält diese gesamte Historie. Eine Unterhaltung, die gestern vier Stunden lang lief, ist heute teuer fortzusetzen. Wie sich der Tokenverbrauch über eine lange Sitzung summiert erklärt, wo diese Kosten tatsächlich entstehen.

Claude Code bietet manchmal einen Mittelweg. Bei einem Pro- oder Max-Tarif öffnet das Fortsetzen einer seit etwa einer Stunde inaktiven Sitzung mit mehr als 100,000 Tokens vor Ihrer ersten Nachricht einen Dialog. Der Prompt-Cache ist bis dahin abgelaufen. Daher wird die vollständige Historie bei der nächsten Anfrage unabhängig von der gewählten Option einmal neu verarbeitet.

• Resume from summary führt sofort eine Komprimierung durch. Spätere Anfragen enthalten dann eine Zusammenfassung statt der vollständigen Historie. Das ist pro Anfrage günstiger. Alles, was die Zusammenfassung ausgelassen hat, ist jedoch nicht mehr verfügbar.
• Resume full session as-is lädt die Unterhaltung unverändert. Jedes Detail bleibt erhalten, die Kosten pro Anfrage steigen jedoch mit der Größe der Unterhaltung.

Eine dritte Option setzt die Sitzung vollständig fort und verhindert, dass der Dialog bei späteren Fortsetzungen erneut angezeigt wird.

Die Entscheidung ist einfacher, als sie zunächst wirkt. Setzen Sie die Sitzung fort, wenn das, was Sie als Nächstes eingeben möchten, von den bisherigen Aussagen abhängt. Starten Sie eine neue Sitzung, wenn das nicht der Fall ist. Drift lässt sich leicht erkennen, wenn Sie darauf achten: Claude bezieht sich auf eine Datei, die Sie vor einer Stunde gelöscht haben, oder diskutiert eine Entscheidung erneut, die Sie zu Beginn der Sitzung bereits getroffen haben. Das ist veralteter Kontext. Wenn Sie ihn mitführen, kostet das gleichzeitig Tokens und Genauigkeit.

Wenn der nützliche Teil einer alten Unterhaltung aus einer Entscheidung oder einer Information besteht, die Sie später wieder benötigen, sollten Sie sich nicht darauf verlassen, dass das Fortsetzen sie überträgt. Schreiben Sie sie an einen Ort, den jede Sitzung sehen kann. Dafür sind die Speicherdateien von Claude Code vorgesehen.

/branch ist in diesem Zusammenhang ebenfalls nützlich. Der Befehl kopiert die Unterhaltung bis zum aktuellen Punkt und wechselt in die Kopie. Das Original bleibt unverändert und weiterhin im Auswahlfenster verfügbar. Verwenden Sie ihn, um einen zweiten Ansatz zu testen, ohne den ersten zu verlieren.

Wie sich Resume von Komprimierung und Memory unterscheidet

Diese Funktionen werden ständig verwechselt, lösen aber unterschiedliche Probleme.

Bei Resume geht es darum, eine Konversation überhaupt wiederherzustellen, nachdem Sie sie beendet, einen Neustart durchgeführt oder mit einer anderen Aufgabe weitergemacht haben. Bei der Komprimierung geht es um das Kontextfenster innerhalb einer laufenden Konversation: /compact ersetzt den von Claude vorgehaltenen Kontext durch eine Zusammenfassung, sodass spätere Anfragen weniger Tokens übertragen. Wenn das Kontextfenster voll ist, ist die Komprimierung das geeignete Werkzeug. Das Kontextfenster von Claude Code verwalten erläutert dies ausführlich.

Memory funktioniert wiederum anders. CLAUDE.md-Dateien und der automatische Speicher enthalten Anweisungen und Fakten, die zu Beginn jeder Sitzung geladen werden. Sie bilden daher keine Konversation, zu der Sie zurückkehren. Sie halten darin Informationen fest, damit Sie nie zu einer früheren Konversation zurückkehren müssen.

Wenn Sie zwei gleichzeitig laufende Konversationen koordinieren möchten, benötigen Sie einen separaten Mechanismus. Claude-Code-Sitzungen können sich gegenseitig Nachrichten senden, solange beide aktiv sind. Das ist ein anderes Problem, als die Sitzung vom Vortag wieder von der Festplatte zu laden.

FAQ

Wo speichert Claude Code meinen Sitzungsverlauf?

Standardmäßig wird er in Ihrem Konfigurationsverzeichnis unter ~/.claude/projects/<project>/<session-id>.jsonl gespeichert. <project> ist dabei der Pfad zum Arbeitsverzeichnis, in dem nicht alphanumerische Zeichen durch Bindestriche ersetzt wurden. Jede Datei verwendet das JSONL-Format: Pro Nachricht, Tool-Aufruf oder Metadateneintrag steht ein JSON-Objekt in einer eigenen Zeile. Mit CLAUDE_CONFIG_DIR verschieben Sie das Konfigurationsverzeichnis an einen anderen Ort. cleanupPeriodDays in settings.json legt fest, wie lange Transkripte aufbewahrt werden. Der Standardwert beträgt 30 Tage, das Minimum 1.

Warum wird meine VPS-Sitzung auf meinem Laptop nicht im Auswahlfenster angezeigt?

Weil Transkripte auf dem Datenträger des Rechners gespeichert werden, auf dem der Agent ausgeführt wurde. Zwischen den Rechnern werden sie nicht synchronisiert. Eine Unterhaltung, die Sie innerhalb von tmux auf Ihrem VPS geführt haben, existiert nur auf dem VPS. Setzen Sie sie dort über SSH fort. Alternativ können Sie darin /export ausführen und die Textdatei kopieren, wenn Sie eine lokale Aufzeichnung benötigen.

Kann ich eine Sitzung fortsetzen, die ich in einem anderen Verzeichnis gestartet habe?

Ja, wenn Ihnen die Sitzungs-ID vorliegt. claude --resume <session-id> sucht zuerst im aktuellen Projektverzeichnis und dessen git worktrees. Danach sucht es in jedem anderen Projekt auf demselben Rechner. Im Auswahlfenster erweitert Ctrl+A die Liste auf alle Projekte des Rechners. Ctrl+W erweitert sie auf alle worktrees des aktuellen Repositorys. Wenn keine Übereinstimmung gefunden wird, meldet Claude Code No conversation found with session ID: <session-id>.

Sollte ich eine alte Sitzung fortsetzen oder eine neue starten?

Setzen Sie eine Sitzung fort, wenn Ihre nächste Nachricht von den bisherigen Inhalten dieser Unterhaltung abhängt. Starten Sie eine neue Sitzung, wenn das nicht der Fall ist. Beim Fortsetzen wird der gesamte Verlauf geladen, sodass jede spätere Anfrage diesen Verlauf mitführt. Achten Sie auf veralteten Kontext: Wenn sich eine Sitzung weiterhin auf Dateien bezieht, die Sie bereits gelöscht haben, enthält sie überholte Informationen. Das kostet bei jeder Anfrage Tokens und beeinträchtigt die Genauigkeit.

Kann ich verhindern, dass Claude Code Transkripte auf dem Datenträger speichert?

Ja. CLAUDE_CODE_SKIP_PROMPT_HISTORY unterdrückt das Schreiben von Transkripten. --no-session-persistence unterdrückt es für einen einzelnen nicht interaktiven Lauf von claude -p. Berücksichtigen Sie zuerst die Konsequenzen: resume liest die Transkripte, daher haben --continue und --resume bei deaktivierter Speicherung nichts zu laden. Wenn es Ihnen nicht darum geht, die Dateien vollständig zu vermeiden, sondern nur um ihren Speicherort, richten Sie CLAUDE_CONFIG_DIR auf ein verschlüsseltes Volume und reduzieren Sie stattdessen cleanupPeriodDays.