Sitzungen verwalten

Benennen, fortsetzen, verzweigen und wechseln Sie zwischen Claude Code-Gesprächen. Behandelt --continue, --resume, --from-pr, die /resume-Auswahl, Sitzungsbenennung 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:

• Fortsetzen eines vorherigen Gesprächs nach Flag, Name oder PR
• Benennen Sie Sitzungen, damit Sie sie später finden können
• Durchsuchen Sie Sitzungen mit der /resume-Auswahl
• Verzweigen Sie ein Gespräch, um einen anderen Ansatz zu versuchen
• Exportieren Sie Transkripte und finden Sie sie auf der Festplatte

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.

Transkripte werden als JSONL unter ~/.claude/projects/<project>/<session-id>.jsonl gespeichert, wobei <project> von Ihrem Arbeitsverzeichnispfad abgeleitet wird. Jede Zeile ist ein JSON-Objekt für eine Nachricht, Tool-Verwendung oder Metadateneintrag. Um Sitzungen an einem anderen Ort als ~/.claude zu speichern, legen Sie CLAUDE_CONFIG_DIR fest. Diese lokalen Dateien werden standardmäßig nach 30 Tagen entfernt; ändern Sie dies mit cleanupPeriodDays.

Um Transkriptschreibvorgänge vollständig zu unterdrücken, legen Sie CLAUDE_CODE_SKIP_PROMPT_HISTORY fest, oder verwenden Sie im nicht-interaktiven Modus --no-session-persistence.

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