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. 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. Verwenden Sie Ctrl+W, um auf alle Worktrees des Repositorys zu erweitern, oder Ctrl+A, um auf jedes Projekt auf dieser Maschine zu erweitern.
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. Ab v2.1.196 bleibt eine verschobene Sitzung aus der Auswahl des alten Verzeichnisses ausgeschlossen, auch nach einem Absturz oder erzwungenen Beenden. In früheren Versionen konnte sie auch nach einem nicht sauberen Beenden in der Liste des alten Verzeichnisses erneut angezeigt werden, wenn der alte Pfad Sonderzeichen wie Unterstriche enthielt.
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.
Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start automatisch einen Standard-Anzeigenamen. Erfordert Claude Code v2.1.196 oder später. Der Standard kombiniert den Namen des Arbeitsverzeichnisses mit einem zweistelligen Suffix, beispielsweise my-app-3f, und identifiziert die Sitzung in Auflistungen laufender Sitzungen, wie z. B. Agent-Ansicht und claude agents --json Ausgabe.
Der Standard ist kein Resume-Handle: claude --resume <name>, /resume <name> und die Sitzungsauswahl stimmen nur mit Namen überein, die Sie festgelegt haben. Das Benennen der Sitzung ersetzt den Standard.
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:
--continue oder --resume mit --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
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 -pmit--output-format jsonoderstream-jsonauf, 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. EinSessionEnd-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.
jq:
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:
| Zu | Einstellen | Wo |
|---|---|---|
Speicher von ~/.claude verschieben | CLAUDE_CONFIG_DIR | Umgebungsvariable |
| Ändern Sie die 30-Tage-Aufbewahrung | cleanupPeriodDays | settings.json |
| Transkriptschreibvorgänge in allen Modi unterdrücken | CLAUDE_CODE_SKIP_PROMPT_HISTORY | Umgebungsvariable |
| Schreibvorgänge für eine nicht-interaktive Ausführung unterdrücken | --no-session-persistence | CLI-Flag mit claude -p |
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