Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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:
| Befehl | Was er tut |
|---|
claude --continue | Setzt die neueste Sitzung im aktuellen Verzeichnis fort |
claude --resume | Öffnet die Sitzungsauswahl |
claude --resume <name> | Setzt die benannte Sitzung direkt fort |
claude --from-pr <number> | Setzt die mit diesem Pull Request verknüpfte Sitzung fort |
/resume | Wechselt zu einem anderen Gespräch innerhalb einer aktiven Sitzung |
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.
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. 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:
| Befehl | Genaue Übereinstimmung | Mehrdeutiger Name |
|---|
claude --resume <name> | Setzt direkt fort | Öffnet die Sitzungsauswahl mit dem Namen als Suchbegriff vorausgefüllt |
/resume <name> | Setzt direkt fort | Meldet einen Fehler; führen Sie /resume ohne Argument aus, um die Sitzungsauswahl zu öffnen |
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.
| Wann | So legen Sie den Namen fest |
|---|
| Beim Start | claude -n auth-refactor |
| Während einer Sitzung | /rename auth-refactor. Der Name wird auch in der Eingabeaufforderungsleiste angezeigt |
| Aus der Sitzungsauswahl | Markieren Sie eine Sitzung und drücken Sie Ctrl+R |
| Bei Plan-Annahme | Das Akzeptieren eines Plans im Plan-Modus benennt die Sitzung aus dem Plan-Inhalt, es sei denn, Sie haben bereits einen Namen festgelegt |
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:
| Tastaturkürzel | Aktion |
|---|
↑ / ↓ | Navigieren Sie zwischen Sitzungen |
→ / ← | Erweitern oder reduzieren Sie gruppierte Sitzungen |
Enter | Setzt die markierte Sitzung fort |
Space | Zeigt eine Vorschau des Sitzungsinhalts an. Ctrl+V funktioniert auch auf Terminals, die es nicht als Einfügen erfassen |
Ctrl+R | Benennen Sie die markierte Sitzung um |
/ oder ein beliebiges druckbares Zeichen außer Space | Geben Sie den Suchmodus ein und filtern Sie Sitzungen. Fügen Sie eine GitHub-, GitHub Enterprise-, GitLab- oder Bitbucket-Pull- oder Merge-Request-URL ein, um die Sitzung zu finden, die sie erstellt hat |
Ctrl+A | Zeigen Sie Sitzungen aus allen Projekten auf dieser Maschine an. Drücken Sie erneut, um zum aktuellen Repository zurückzukehren |
Ctrl+W | Zeigen Sie Sitzungen aus allen Worktrees des aktuellen Repositorys an. Drücken Sie erneut, um zum aktuellen Worktree zurückzukehren. Wird nur in Multi-Worktree-Repositorys angezeigt |
Ctrl+B | Filtern Sie zu Sitzungen aus dem aktuellen Git-Branch. Drücken Sie erneut, um alle Branches anzuzeigen |
Esc | Beenden Sie die Sitzungsauswahl oder den Suchmodus |
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
--continue oder --resume mit --fork-session:
claude --continue --fork-session
/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:
