Sitzungen verwalten

Benennen, fortsetzen, verzweigen und wechseln Sie zwischen Claude Code-Gesprächen. Behandelt --continue, --resume, --from-pr, die /resume-Auswahl, Sitzungsbenennung, Exportieren von Transkripten und wo Transkripte gespeichert werden.

Eine Sitzung ist ein gespeichertes Gespräch, das an ein Projektverzeichnis gebunden ist. Claude Code speichert es lokal während Sie arbeiten, sodass Sie dort weitermachen können, wo Sie aufgehört haben, zu einem anderen Ansatz verzweigen oder zwischen Aufgaben wechseln können.

Die Desktop-App, Claude Code im Web und die VS Code-Erweiterung verwalten jeweils ihre eigene Sitzungsverlauf. Diese Seite behandelt die CLI.

Sitzung fortsetzen

Sitzungen werden kontinuierlich in lokale Transkriptdateien gespeichert, während Sie arbeiten, sodass Sie nach dem Beenden oder Ausführen von /clear zu einer zurückkehren können. Verwenden Sie diese Einstiegspunkte:

Sitzungen, die mit claude -p oder dem Agent SDK erstellt wurden, werden nicht in der Sitzungsauswahl angezeigt, aber Sie können eine trotzdem fortsetzen, indem Sie ihre Sitzungs-ID an claude --resume <session-id> übergeben. Führen Sie dies aus dem Verzeichnis aus, in dem die Sitzung gestartet wurde: Die Sitzungs-ID-Suche ist auf das aktuelle Projektverzeichnis und seine Git Worktrees beschränkt, daher meldet eine anderswo erstellte Sitzung No conversation found with session ID: <session-id>.

Wo die Sitzungsauswahl sucht

Sitzungen werden pro Projektverzeichnis gespeichert. Standardmäßig zeigt die Sitzungsauswahl interaktive Sitzungen aus dem aktuellen Worktree sowie Sitzungen, die anderswo gestartet wurden und das aktuelle Verzeichnis mit /add-dir hinzugefügt haben. {/* min-version: 2.1.169 */}Ab v2.1.169 verschiebt das Verschieben einer Sitzung mit /cd diese in den Projektspeicher des neuen Verzeichnisses, sodass sie danach in der Auswahl dieses Verzeichnisses angezeigt wird. Verwenden Sie Ctrl+W, um auf alle Worktrees des Repositorys zu erweitern, oder Ctrl+A, um auf jedes Projekt auf dieser Maschine zu erweitern.

Das Auswählen einer Sitzung aus einem anderen Worktree desselben Repositorys setzt sie an Ort und Stelle fort. Das Auswählen einer Sitzung aus einem nicht verwandten Projekt kopiert stattdessen einen cd- und Resume-Befehl in Ihre Zwischenablage.

Das Fortsetzen nach Name wird über das aktuelle Repository und seine Worktrees hinweg aufgelöst. Beide Formen suchen nach einer genauen Übereinstimmung und setzen sie direkt fort, auch wenn sie sich in einem anderen Worktree befindet:

Benennen Sie Ihre Sitzungen

Geben Sie Sitzungen aussagekräftige Namen, damit sie in der Sitzungsauswahl auffindbar und nach Name wiederaufnehmbar sind. Dies ist am wichtigsten, wenn Sie an mehreren Aufgaben parallel arbeiten.

Sobald eine Sitzung benannt ist, kehren Sie mit claude --resume <name> oder /resume <name> zu ihr zurück. Siehe Sitzung fortsetzen, um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.

Verwenden Sie die Sitzungsauswahl

Führen Sie /resume innerhalb einer Sitzung oder claude --resume ohne Argumente aus, um die interaktive Sitzungsauswahl zu öffnen. Verwenden Sie diese Tastaturkürzel zum Navigieren, Suchen und Erweitern der Liste:

Jede Zeile zeigt den Sitzungsnamen, falls festgelegt, andernfalls die Gesprächszusammenfassung oder erste Eingabeaufforderung, zusammen mit der Zeit seit der letzten Aktivität, der Nachrichtenanzahl und dem Git-Branch. Der Projektpfad wird angezeigt, nachdem Sie mit Ctrl+A auf alle Projekte erweitert haben.

Verzweigte Sitzungen, die mit /branch, /rewind oder --fork-session erstellt wurden, werden unter ihrer Root-Sitzung gruppiert. Drücken Sie →, um eine Gruppe zu erweitern.

Verzweigen Sie eine Sitzung

Das Verzweigen erstellt eine Kopie des bisherigen Gesprächs und wechselt Sie hinein, wobei das Original intakt bleibt. Verwenden Sie es, um einen anderen Ansatz zu versuchen, ohne den Weg zu verlieren, auf dem Sie waren.

Führen Sie innerhalb einer Sitzung /branch mit einem optionalen Namen aus:

/branch try-streaming-approach

Kombinieren Sie von der Befehlszeile aus --continue oder --resume mit --fork-session:

claude --continue --fork-session

Die ursprüngliche Sitzung bleibt unverändert und bleibt in der Sitzungsauswahl verfügbar. Die /branch-Bestätigung gibt zwei Sitzungs-IDs aus: den neuen Branch, in dem Sie sich jetzt befinden, und das Original. Um zum Original zurückzukehren, übergeben Sie seine ID an /resume, verwenden Sie die Sitzungsauswahl oder führen Sie /resume <original-name> aus. Berechtigungen, die Sie mit „für diese Sitzung zulassen" genehmigt haben, werden nicht auf den neuen Branch übertragen. Wenn Sie dieselbe Sitzung in zwei Terminals ohne Verzweigung fortsetzen, werden Nachrichten von beiden in ein Transkript verschachtelt.

Für Checkpoint-basiertes Zurückspulen innerhalb einer einzelnen Sitzung siehe Checkpointing.

Verwalten Sie den Kontext innerhalb einer Sitzung

Diese Befehle steuern, was sich im Kontextfenster befindet, ohne die Sitzung zu verlassen:

• /clear: Beginnen Sie mit einem leeren Kontext von vorne. Das vorherige Gespräch wird gespeichert und kann wiederaufgenommen werden
• /compact [instructions]: Ersetzen Sie den Verlauf durch eine Zusammenfassung, optional fokussiert auf das, was Sie angeben
• /context: Zeigen Sie an, was derzeit Kontext verbraucht

Wie die Komprimierung mit CLAUDE.md, Skills und Regeln interagiert, finden Sie im Kontextfenster-Leitfaden. Strategien, wann Sie löschen oder komprimieren sollten, finden Sie unter Best Practices.

Exportieren und lokalisieren Sie Sitzungsdaten

Führen Sie /export aus, um das aktuelle Gespräch in Ihre Zwischenablage zu kopieren oder als Nur-Text-Datei zu speichern, wobei Nachrichten und Tool-Ausgaben als lesbarer Text gerendert werden. Übergeben Sie einen Dateinamen, um direkt in diese Datei zu schreiben.

Zugriff auf Gespräche aus Skripten

/export erzeugt ein gerendertes Transkript zum Lesen durch eine Person. Die folgenden Schnittstellen erzeugen strukturierte Daten zum Analysieren durch ein Skript: ein JSON-Ergebnis aus einer Ausführung, der Pfad zur Transkriptdatei einer Sitzung oder ein Live-Stream von Ereignissen. Wählen Sie basierend darauf, was das Skript auslöst:

• Claude einmal ausführen und das Ergebnis erfassen: Rufen Sie claude -p mit --output-format json oder stream-json auf, um das Ergebnis, die Sitzungs-ID, die Nutzung und die Kosten einer nicht-interaktiven Ausführung als strukturiertes JSON zu erfassen.
• Eine vorhandene Sitzung eine Frage stellen: Übergeben Sie eine Sitzungs-ID an claude -p --resume, um eine Folgeanfrage zu senden, z. B. eine Zusammenfassungsanfrage, und die strukturierte Antwort zu erfassen.
• Auf Sitzungsereignisse reagieren: Lesen Sie das Feld transcript_path, das Hooks und Statuszeilen-Befehle als Eingabe erhalten. Ein SessionEnd-Hook kann das Transkript archivieren, wenn eine Sitzung endet.
• Claude in eine TypeScript- oder Python-App einbetten: Verwenden Sie das Agent SDK, um jede Nachricht programmgesteuert zu empfangen.

Das folgende Beispiel verwendet die zweite Schnittstelle. Es sendet eine Folgeanfrage an eine vorhandene Sitzung und liest die Antwort mit jq:

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

Wo Transkripte gespeichert sind

Standardmäßig werden Transkripte als JSONL unter ~/.claude/projects/<project>/<session-id>.jsonl gespeichert, wobei <project> Ihr Arbeitsverzeichnispfad mit nicht-alphanumerischen Zeichen ist, die durch - ersetzt wurden. Jede Zeile ist ein JSON-Objekt für eine Nachricht, Tool-Verwendung oder Metadateneintrag. Das Eintragsformat ist intern für Claude Code und ändert sich zwischen Versionen, daher können Skripte, die diese Dateien direkt analysieren, bei jeder Veröffentlichung unterbrochen werden. Um auf Sitzungsdaten aufzubauen, verwenden Sie stattdessen /export oder die Skript-Schnittstellen.

Der Speicherort, die Aufbewahrung und das Schreibverhalten sind konfigurierbar:

Siehe auch

Diese Seiten behandeln verwandte Sitzungs- und Parallelisierungsmechaniken:

• Worktrees: Führen Sie isolierte parallele Sitzungen auf separaten Branches aus
• Checkpointing: Spulen Sie Code und Gespräch zu einem früheren Punkt zurück
• Kontextfenster: Was füllt den Kontext und was überlebt die Komprimierung
• Nicht-interaktiver Modus: Sitzungsverhalten unter claude -p