SpyBara
Go Premium

sessions.md 2026-09-30 23:00 UTC to 2026-10-01 05:00 UTC

This page contains 57 additions and 39 deletions.

2026
Thu 1 06:02

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.ai/code und die VS Code-Erweiterung verwalten jeweils ihre eigene Sitzungsliste, und die Desktop-App kann auch eine CLI-Sitzung fortsetzen. Diese Seite behandelt die CLI.

Eine 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 Öffnet das neueste Gespräch im aktuellen Verzeichnis erneut
claude --resume Öffnet die Sitzungsauswahl
claude --resume <name> Setzt die benannte Sitzung direkt fort
claude --resume <transcript-path> Setzt das Gespräch fort, das in der .jsonl Transkriptdatei unter diesem absoluten Pfad gespeichert ist
claude --from-pr <number> Öffnet die Sitzungsauswahl gefiltert nach Sitzungen, die mit diesem Pull Request verknüpft sind
/resume Wechselt zu einem anderen Gespräch innerhalb einer aktiven Sitzung

Claude Code lässt Sitzungen, die mit claude -p oder dem Agent SDK erstellt wurden, aus der Sitzungsauswahl und aus claude --continue aus. Sie können eine trotzdem fortsetzen, indem Sie ihre Sitzungs-ID an claude --resume <session-id> übergeben. Mit claude --continue überspringt Claude Code auch Sitzungen, deren erste Eingabeaufforderung /loop war. Wenn Sie claude -p --continue ausführen, bezieht Claude Code -p, SDK und /loop Sitzungen ein.

claude --continue öffnet eine Hintergrundsitzung, die beendet wurde, aber nicht eine, die noch läuft; das Öffnen beendeter Hintergrundsitzungen erfordert Claude Code v2.1.257 oder später. Wenn Ihr letztes Gespräch eines ist, das Sie in den Hintergrund verschoben haben, und es läuft dort noch, beendet Claude Code mit Your most recent conversation is running in the background und der ID dieser Sitzung. Verbinden Sie sich mit der Sitzung von claude agents aus, oder führen Sie claude --resume aus, um eine andere auszuwählen.

Wenn das Gespräch, das Sie mit claude --resume oder /resume fortsetzen, zu einer Hintergrundsitzung gehört, die noch läuft, öffnet Claude Code die laufende Sitzung selbst. Mit --bg in der Befehlszeile ist die Fortsetzung stattdessen ein Hintergrund-Dispatch. Vor v2.1.285 weigerte sich Claude Code und sagte Ihnen, die Sitzung mit claude attach <id> zu öffnen oder sie zuerst mit claude stop <id> zu stoppen.

  • Von Ihrer Shell aus: claude --resume <session> führt claude attach auf dieser Sitzung im selben Terminal aus, anstatt das Transkript selbst zu laden. Eine Eingabeaufforderung, die Sie in der Befehlszeile übergeben, wie in claude --resume <session> "check the tests too", geht zuerst als nächster Zug an die Sitzung, und Claude Code gibt Sent your prompt to the background session (<id>); opening it… aus, bevor es sich verbindet. claude -p --resume <session> "prompt" in einem Terminal eingegeben macht dasselbe, sodass -p diesen Lauf nicht nicht-interaktiv hält.

    Claude Code öffnet die Sitzung nicht, wenn die Befehlszeile eines dieser Elemente enthält:

    • Weitergeleitete oder umgeleitete Ein- oder Ausgabe
    • Flags, die die Sitzung konfigurieren, wie --permission-mode, --model oder --settings
    • Flags, die die Ausgabe lesen, wie --output-format json oder --json-schema
    • Flags, die den Lauf begrenzen oder zurückspulen, wie --max-turns oder --max-budget-usd

    Mit einem dieser Elemente oder wenn Agent View ausgeschaltet ist, sendet Claude Code nichts und beendet sich mit Status 1, gibt aus, dass die Sitzung im Hintergrund läuft, zusammen mit dem claude attach <id> Befehl, der sie öffnet, oder teilt Ihnen mit, sie in claude agents zu finden, wenn die ID nicht bestimmt werden kann. Fügen Sie --fork-session hinzu, um stattdessen eine Kopie des Gesprächs fortzusetzen. Um das Gespräch selbst in einer Sitzung Ihrer eigenen fortzusetzen, mit Ihren Flags angewendet, führen Sie claude stop <id> aus und wiederholen Sie dann den Befehl.

    Eine Eingabeaufforderung, die mit / oder ! beginnt, wird nicht gesendet, und auch keine Eingabeaufforderung, während die Sitzung auf Ihre Antwort auf eine Frage wartet. In beiden Fällen öffnet Claude Code die Sitzung nicht, und die Nachricht enthält Your prompt was not sent to it mit dem Grund.

  • Von innerhalb einer Sitzung: /resume verschiebt Ihr aktuelles Gespräch in den Hintergrund und verbindet dieses Terminal mit der laufenden Sitzung, gibt Opening "<title>", running in the background (<id>) aus. Drücken Sie ← auf einer leeren Eingabeaufforderung, um zur Agent View zurückzukehren, die auch das Gespräch auflistet, das Sie verlassen haben. Wenn das aktuelle Gespräch nicht in den Hintergrund verschoben werden kann, beispielsweise weil Sie bereits an einer Hintergrundsitzung angehängt sind oder die Sitzungspersistenz ausgeschaltet ist, gibt /resume den claude attach Befehl aus, den Sie stattdessen ausführen müssen.

Sie können claude --resume <session-id> von jedem Verzeichnis aus ausführen: Claude Code sucht zuerst nach der ID im aktuellen Projektverzeichnis und seinen Git Worktrees, dann in jedem anderen Projekt auf dieser Maschine, sodass es eine Sitzung findet, die anderswo gestartet wurde oder sich mit /cd verschoben hat. Die projektübergreifende Suche löst die ID nur auf, wenn genau ein anderes Projekt ein Transkript mit Nachrichten dafür enthält, sodass eine manuell kopierte Kopie Claude Code dazu bringt, nicht gefunden zu melden, anstatt eine beliebige Kopie fortzusetzen. Wenn keine gespeicherte Sitzung der ID entspricht, meldet Claude Code No conversation found with session ID: <session-id>. Vor v2.1.223 stoppte die Suche im aktuellen Projektverzeichnis und seinen Git Worktrees, sodass Sie die Sitzung von dem Verzeichnis aus fortsetzen mussten, in dem die Sitzung zuletzt funktioniert hat.

Was eine fortgesetzte Sitzung wiederherstellt

Wenn Claude Code ein Gespräch aus seinem Transkript lädt, stellt die fortgesetzte Sitzung das Gespräch zusammen mit dem darin gespeicherten Zustand wieder her:

  • Gesprächsverlauf: der vollständige Verlauf, einschließlich Werkzeugaufrufe und Ergebnisse. Ein Werkzeug, das noch lief, als der vorherige Prozess endete, beispielsweise bei einem Absturz, wird nicht beendet und läuft nicht erneut, wenn Sie fortsetzen. Claude sieht den Aufruf als abgebrochen markiert, bevor sein Ergebnis aufgezeichnet wurde, und wird angewiesen, zu überprüfen, ob er wirksam wurde, bevor er ihn erneut ausführt, es sei denn, CLAUDE_CODE_RESUME_INTERRUPTED_TURN ist gesetzt. Vor v2.1.281 ließ Claude Code den abgebrochenen Aufruf aus dem Gespräch fallen oder zeigte ihn Claude als einen, den Sie unterbrochen haben.
  • Modell: die Sitzung wird auf dem Modell fortgesetzt, das sie verwendete. Das Modell wird nicht wiederhergestellt, wenn es eingestellt wurde oder nicht von availableModels erlaubt ist, wenn ein --model Flag oder eine ANTHROPIC_MODEL-Familie Umgebungsvariable beim Start eine auswählt, oder bei Anbietern, die anbieterspezifische Deployment-IDs verwenden, wie Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry; siehe Modellkonfiguration für die Auflösungsreihenfolge.
  • Agent: eine Sitzung, die mit --agent oder der agent Einstellung gestartet wurde, wird als dieser Agent fortgesetzt, wobei seine Werkzeugbeschränkungen und sein Modell beibehalten werden. Übergeben Sie --agent beim Fortsetzen, um einen anderen auszuwählen; für die Systemaufforderung in beiden Fällen siehe Systemaufforderungs-Flags in fortgesetzten Gesprächen. Claude Code sucht nach dem Agent an zwei Stellen: dem ursprünglichen Verzeichnis der Sitzung, vorausgesetzt, Sie haben diesem Arbeitsbereich vertraut, und dann dem Verzeichnis, von dem aus Sie fortsetzen, sodass ein projektbezogener Agent immer noch geladen wird, wenn Sie von einem anderen Verzeichnis aus fortsetzen. Wenn Claude Code den Agent an keiner Stelle findet, wird die Sitzung mit den Standard-Werkzeugen fortgesetzt und zeigt eine Warnung mit dem Namen des Agents.
  • Berechtigungsmodus: Wenn Sie von einem Terminal aus mit claude --continue, claude --resume <session-id> oder claude --resume <name> fortsetzen, wenn der Name einer Sitzung entspricht, ohne -p, stellt Claude Code den Berechtigungsmodus wieder her, in dem sich die Sitzung befand, außer in den Fällen in Berechtigungsmodus beim Fortsetzen, die auch die Sitzungsauswahl, /resume und das Fortsetzen mit claude -p abdecken. Übergeben Sie --permission-mode oder --dangerously-skip-permissions, um den wiederhergestellten Modus zu überschreiben.
  • Aktives Ziel: ein Ziel, das noch aktiv war, als die Sitzung endete, wird übertragen; seine Zugzahl, sein Timer und seine Token-Ausgabenbaseline werden zurückgesetzt.
  • Geplante Aufgaben: Aufgaben, die nicht abgelaufen sind, werden wiederhergestellt. Hintergrund-Bash und Monitor-Aufgaben nicht.
  • Hintergrundarbeit: ein Hintergrund-Subagent, Hintergrund-Bash-Befehl oder Workflow, der mit dem vorherigen Prozess endete, wird im fortgesetzten Transkript als Notiz angezeigt, dass er nicht beendet wurde. Claude Code startet keinen Zug von diesen Notizen; Claude liest sie mit Ihrer nächsten Eingabeaufforderung.

Nicht jedes Konfigurationsflags aus dem ursprünglichen Start wird wiederhergestellt. Wenn die Sitzung von --mcp-config, --settings, --plugin-dir, --fallback-model oder Verzeichnissen, die mit --add-dir hinzugefügt wurden, abhängig war, übergeben Sie sie erneut, wenn Sie fortsetzen; Verzeichnisse, die während der Sitzung mit /add-dir hinzugefügt wurden, werden nicht wiederhergestellt, obwohl die Sitzungsauswahl sie immer noch verwendet, um die Sitzung zu finden. Die Standard-Einstellungsdateien, wie settings.json und settings.local.json, werden beim Start erneut gelesen, sodass Konfiguration, die darin lebt, nicht erneut übergeben werden muss. Für --system-prompt und --append-system-prompt siehe Systemaufforderungs-Flags in fortgesetzten Gesprächen.

Berechtigungsmodus beim Fortsetzen

Welcher Berechtigungsmodus Claude Code eine fortgesetzte Sitzung startet, hängt davon ab, wie Sie fortsetzen. Die folgenden Fälle gelten, wenn Claude Code das Gespräch aus seinem Transkript lädt; wenn Sie stattdessen eine Hintergrundsitzung öffnen, die noch läuft, behält diese Sitzung den Berechtigungsmodus bei, in dem sie sich befindet.

  • Terminal: claude --continue, claude --resume <session-id> oder claude --resume <name>, wenn der Name einer Sitzung entspricht, ohne -p. Claude Code stellt den Berechtigungsmodus wieder her, in dem sich die Sitzung befand, außer in den Fällen in der Tabelle. Übergeben Sie --permission-mode oder --dangerously-skip-permissions, um den wiederhergestellten Modus zu überschreiben.
  • Nicht-interaktiv: claude -p --resume oder claude -p --continue. Claude Code startet den Lauf im Berechtigungsmodus, in dem ein neuer claude -p Lauf gestartet würde, außer dass eine Sitzung, die im Plan Mode endete, unter den Bedingungen unten im Plan Mode fortgesetzt wird.
  • VS Code: das Gesprächsfenster der Erweiterung. Die Tabelle behandelt nur ein Gespräch, das im Plan Mode endete; für den Rest siehe frühere Gespräche fortsetzen.
  • Sitzungsauswahl beim Start: eine Sitzung, die Sie aus der Sitzungsauswahl auswählen, ob Sie sie mit claude --resume allein, claude --from-pr oder einem Namen, der mehr als einer Sitzung entspricht, geöffnet haben. Claude Code stellt den gespeicherten Berechtigungsmodus nicht wieder her. Es startet die Sitzung im Berechtigungsmodus, in dem es eine neue Sitzung von derselben Befehlszeile aus starten würde.
  • /resume innerhalb einer Sitzung, mit oder ohne Argument: Claude Code stellt den gespeicherten Berechtigungsmodus nicht wieder her. Das Gespräch, zu dem Sie wechseln, wird im Berechtigungsmodus Ihrer aktuellen Sitzung fortgesetzt.

Das Wiederherstellen des Plan Mode auf den nicht-interaktiven und VS Code Pfaden erfordert Claude Code v2.1.246 oder später. Jede Zeile benennt den Berechtigungsmodus, in dem die Sitzung endete, welche der Terminal-, nicht-interaktiven und VS Code Pfade Sie ihn fortsetzen, und den Berechtigungsmodus, in dem Claude Code die fortgesetzte Sitzung startet.

Sitzung endete in Wie Sie fortsetzen Berechtigungsmodus nach dem Fortsetzen
bypassPermissions Terminal Der Berechtigungsmodus, in dem eine neue Sitzung gestartet würde. Um Berechtigungen zu umgehen, aktivieren Sie es beim Start mit einem seiner Start-Flags oder permissions.defaultMode: "bypassPermissions" in Benutzer-, --settings- oder verwalteten Einstellungen
plan Terminal Der Berechtigungsmodus, in dem eine neue Sitzung gestartet würde
auto Terminal auto, nur wenn Ihr Konto immer noch die Auto Mode Anforderungen erfüllt
Manual Terminal Manual, wenn eine neue Sitzung im Auto Mode von der integrierten Standardeinstellung gestartet würde. Wenn ein defaultMode aus einer Einstellungsdatei wirksam wird, startet Claude Code die fortgesetzte Sitzung stattdessen in diesem Modus
plan Nicht-interaktiv, unter den Bedingungen unten Plan Mode
Beliebiger Modus Nicht-interaktiv, in jedem anderen Fall Der Berechtigungsmodus, in dem ein neuer claude -p Lauf gestartet würde
plan VS Code Plan Mode, mit den Ausnahmen auf der VS Code Seite
Im Plan Mode mit `-p` fortsetzen

Ein claude -p --resume oder claude -p --continue Lauf wird nur im Plan Mode fortgesetzt, wenn alle diese Bedingungen erfüllt sind:

  • Sie übergeben --permission-prompt-tool und übergeben nicht --permission-prompts none, sodass Claude Code den Plan zur Genehmigung präsentieren kann
  • Sie übergeben nicht --permission-mode oder --dangerously-skip-permissions
  • Sie übergeben nicht --fork-session
  • Der Lauf wird nicht über Kanäle gestartet

Aus einer Zusammenfassung fortsetzen

Bei einem Pro oder Max Plan öffnet Claude Code, wenn Sie eine Sitzung fortsetzen, die länger als etwa eine Stunde inaktiv war und über 100.000 Token umfasst, das Gespräch wieder her und öffnet dann einen Dialog, bevor Sie Ihre erste Nachricht senden. Der Prompt Cache der Sitzung ist bis dahin abgelaufen, sodass die nächste Anfrage die vollständige Historie einmal verarbeitet, unabhängig davon, welche Option des Dialogs Sie wählen.

Der Dialog bietet drei Möglichkeiten, die Sitzung fortzusetzen. Sie unterscheiden sich darin, wie viel des Gesprächs jede in spätere Anfragen trägt, was ein Kompromiss zwischen dem Behalten jedes Details und dem Senden weniger Token pro Anfrage ist:

  • Aus Zusammenfassung fortsetzen: führt /compact sofort aus. Claude Code sendet eine Zusammenfassungsanfrage über die vollständige Historie, ersetzt dann die Historie durch die Zusammenfassung, Ihre letzten Austausche und bis zu fünf kürzlich gelesene Dateien. Spätere Anfragen tragen die Zusammenfassung anstelle der vollständigen Historie.
  • Vollständige Sitzung wie vorhanden fortsetzen: lädt das Gespräch unverändert. Nachdem Sie Ihre erste Nachricht senden, verarbeitet Claude Code die vollständige Historie erneut und speichert sie zwischen, liest sie dann später aus dem Cache, während der Cache warm bleibt.
  • Mich nicht mehr fragen: setzt die vollständige Sitzung fort und stoppt die Anzeige des Dialogs bei allen zukünftigen Fortsetzungen.

Das Fortsetzen wie vorhanden behält jedes Detail des Gesprächs verfügbar, mit Kosten pro Anfrage, die mit der Größe des Gesprächs skalieren. Das Fortsetzen aus der Zusammenfassung kostet weniger bei jeder späteren Anfrage, weil es die Zusammenfassung anstelle der vollständigen Historie trägt, aber was die Zusammenfassung auslässt, ist nicht mehr in Claudes Kontext. Siehe warum die Nutzung in einer langen Sitzung steigt für den Ursprung dieser Kosten pro Anfrage.

Wo die Sitzungsauswahl sucht

Claude Code speichert Sitzungen pro Projektverzeichnis. Standardmäßig zeigt die Sitzungsauswahl:

  • Sitzungen aus dem aktuellen Worktree, einschließlich Hintergrundsitzungen, die in der Liste als bg markiert sind
  • 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.

Sitzungen, deren erste Eingabeaufforderung ein /loop Befehl war, erscheinen nicht in der Auswahl, und claude --continue überspringt sie auch. Das Ausführen von /loop später in einem Gespräch versteckt die Sitzung nicht. Vor v2.1.211 versteckte ein /loop Lauf früh in einem Gespräch die Sitzung dauerhaft aus der Auswahl.

Das Verschieben einer Sitzung mit /cd verlegt sie zum Projektlager des neuen Verzeichnisses, sodass sie danach in der Auswahl dieses Verzeichnisses erscheint. Ab v2.1.196 bleibt eine verschobene Sitzung aus der Auswahl des alten Verzeichnisses, 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 erscheinen, wenn der alte Pfad Sonderzeichen wie Unterstriche enthielt.

Wenn Sie eine Sitzung aus einem anderen Worktree desselben Repositorys auswählen, setzt Claude Code sie an Ort und Stelle fort; wenn der eigene Worktree der Sitzung nicht mehr existiert, setzt Claude Code sie in Ihrem aktuellen Verzeichnis fort. Wenn Sie eine Sitzung aus einem nicht verwandten Projekt auswählen, kopiert Claude Code stattdessen einen cd und Resume-Befehl in Ihre Zwischenablage. Wenn das Verzeichnis dieses Projekts nicht mehr existiert, setzt Claude Code die Sitzung in Ihrem aktuellen Verzeichnis fort, anstatt einen cd Befehl zu kopieren, der fehlschlagen würde.

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

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 gibt der Sitzung einen generierten Titel basierend auf dem Plan, es sei denn, Sie haben bereits einen Namen festgelegt
Von claude.ai oder der Claude-App Benennen Sie eine Remote-Control-Sitzung um; Claude Code wendet denselben Namen in der CLI an. Erfordert Claude Code v2.1.221 oder später
Von der Desktop-App Benennen Sie eine Sitzung in der Desktop-App um

Sobald Sie eine Sitzung über eine CLI-Route oder von claude.ai aus benannt haben, kehren Sie mit claude --resume <name> oder /resume <name> zu ihr zurück; eine Desktop-App-Sitzung wird in der Desktop-App fortgesetzt. Siehe Sitzung fortsetzen, um zu erfahren, wie die Namensauflösung über Worktrees hinweg funktioniert.

Wenn Sie eine interaktive Sitzung mit einem Namen starten oder fortsetzen, den bereits eine andere aktive Sitzung auf diesem Computer verwendet, oder eine Sitzung in einen solchen Namen umbenennen, behält Claude Code den Namen bei der Sitzung, die ihn bereits hat, benennt Ihre Sitzung in eine Variante mit einem zweistelligen Suffix um, z. B. auth-refactor-graceful-unicorn, und teilt Ihnen dies mit. Führen Sie /rename mit einem neuen Namen aus, wenn Sie lieber selbst einen auswählen möchten. Vor v2.1.232 behielten beide Sitzungen den Namen.

In drei Fällen benennt Claude Code das Duplikat nicht um, sodass Sie in Auflistungen immer noch zwei Sitzungen mit demselben Namen sehen können:

  • Es prüft nicht auf KI-generierte Titel oder Standard-Anzeigenamen.
  • Es prüft nicht den --name einer Hintergrund- oder -p-Sitzung beim Start.
  • Es kann eine Sitzung auf einer früheren Version von Claude Code nicht umbenennen.

Sitzungen, die Sie nicht benennen, erhalten immer noch zwei Bezeichnungen, die Claude Code zuweist. Nur der generierte Titel funktioniert als Resume-Handle:

  • Standard-Anzeigename: Interaktive Sitzungen, die Sie nie benennen, erhalten beim Start 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. Wenn Sie ihn an claude --resume oder /resume übergeben, findet Claude Code die Sitzung nicht. Das Benennen der Sitzung ersetzt den Standard in diesen Auflistungen, ebenso wie das Akzeptieren eines Plans.

  • Generierter Titel: Wenn Sie eine Sitzung nicht benennen, generiert Claude Code einen Sitzungstitel für sie. Der Titel ist eine kurze Zusammenfassung Ihres ersten Prompts, geschrieben durch eine Hintergrundanfrage an das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Eine claude -p-Ausführung, die Sie direkt von einer Shell oder einem Skript aus starten, erhält keinen.

    Das Akzeptieren eines Plans ersetzt den generierten Titel durch einen Titel basierend auf dem Plan. Das Benennen der Sitzung ersetzt ihn ebenfalls.

    Sie sehen den Titel des ersten Prompts in der Sitzungsauswahl und im Statusline-Feld session_name, wenn kein Name festgelegt ist. Der Plan-Titel wird an denselben zwei Stellen angezeigt und auch in den Auflistungen laufender Sitzungen, wo er den Platz des Standard-Anzeigenamens einnimmt.

    Sie können jeden Titel an claude --resume oder /resume übergeben, und Claude Code löst ihn auf dieselbe Weise auf wie einen Namen, den Sie festgelegt haben.

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

Jede Zeile zeigt den Sitzungsnamen, falls festgelegt, andernfalls den KI-generierten Sitzungstitel, die Gesprächszusammenfassung oder die erste Eingabeaufforderung, zusammen mit der Zeit seit der letzten Aktivität, dem Git-Branch und der Dateigröße. Erweitern Sie auf alle Projekte mit Ctrl+A, um auch den Projektpfad jeder Sitzung anzuzeigen.

Sitzungen, die mit /branch oder --fork-session erstellt wurden, erhalten ihre eigenen Sitzungs-IDs und werden als separate Zeilen angezeigt. Wenn die Auswahl mehr als einen Eintrag für dieselbe Sitzung findet, werden diese unter einer einzelnen Zeile gruppiert. Drücken Sie →, um eine Gruppe zu erweitern.

Wenn Claude Code die Sitzung, die Sie aus der claude --resume-Auswahl auswählen, nicht laden kann, wird Failed to resume the conversation mit einem Befehl zum Wiederholen ausgegeben, dann wird mit Code 1 beendet. Aus der /resume-Auswahl innerhalb einer Sitzung meldet Claude Code den Fehler, und Ihr aktuelles Gespräch läuft weiter.

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

Wenn Sie den Namen weglassen, benennt Claude Code den neuen Branch nach der ersten Eingabeaufforderung im Gespräch. Ab v2.1.198 gilt dies auch nach Komprimierung; frühere Versionen fielen auf den wörtlichen Namen Branched conversation zurück, anstatt die Komprimierungszusammenfassung zu überschreiten, um die ursprüngliche erste Eingabeaufforderung zu finden.

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

claude --continue --fork-session

Die /branch-Bestätigung gibt zwei Sitzungs-IDs aus: den neuen Branch, in dem Sie sich jetzt befinden, und das Original. Das Original bleibt unverändert auf der Festplatte und bleibt in der Sitzungsauswahl verfügbar; kehren Sie mit /resume <original-name> oder durch Übergabe seiner ID an /resume zu ihm zurück.

/branch kopiert das Transkript und wechselt den laufenden Claude Code-Prozess, um darin zu schreiben. Diese Unterscheidung bestimmt, was der Branch erbt:

Status Nach /branch
Gesprächsverlauf In den Branch bis zu dem Punkt kopiert, an dem Sie /branch ausgeführt haben
Berechtigungen für „Für diese Sitzung zulassen" Übertragen; der Branch läuft im selben Prozess, daher gelten Ihre bestehenden Genehmigungen weiterhin. Wenn Sie mit --fork-session in einen separaten Prozess verzweigen, startet der neue Prozess ohne diese und Sie genehmigen sie dort erneut
Laufende Hintergrund-Subagenten und Hintergrund-Bash-Befehle Laufen weiter. Ihre Ausgabe wird in dem neuen Branch angezeigt, in den Sie gewechselt haben, nicht in der ursprünglichen Sitzung
Remote Control-Verbindung Bleibt verbunden. Ein Telefon oder Browser, das mit der Sitzung verbunden ist, folgt Ihnen in den Branch und empfängt dort weiterhin neue Nachrichten

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. Claude Code speichert das vorherige Gespräch; nehmen Sie es mit /resume wieder auf, oder, im selben Claude Code-Prozess, aus dem Eintrag der vorherigen Sitzung im Rewind-Menü. Ohne Argument behält das neue Gespräch einen Namen bei, den Sie mit --name oder /rename festgelegt haben, aber nicht einen von der KI generierten Sitzungstitel. Um stattdessen das Gespräch zu benennen, das Sie verlassen, übergeben Sie den Namen, wie in /clear release-prep; das neue Gespräch beginnt dann ohne Namen
  • /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 ein Menü zu öffnen, das Ihnen ermöglicht, 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 das Menü zu überspringen und 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 speichert Claude Code Transkripte als JSONL unter ~/.claude/projects/<project>/<session-id>.jsonl, wobei <project> Ihr Arbeitsverzeichnispfad mit nicht-alphanumerischen Zeichen ist, die durch - ersetzt wurden. Für ein Arbeitsverzeichnis, dessen konvertierter Name 200 Zeichen überschreitet, kürzt Claude Code den Namen auf 200 Zeichen und hängt einen Hash des vollständigen Pfads an, damit der Verzeichnisname innerhalb der Dateisystem-Limits bleibt.

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
Benennen Sie das Verzeichnis <project> selbst CLAUDE_CODE_PROJECT_DIR_NAME Umgebungsvariable
Ändern Sie die 30-Tage-Aufbewahrung cleanupPeriodDays settings.json
Legen Sie ein Alterslimit für Claude Desktop und Cowork-Transkripte fest desktopSessionCleanupPeriodDays Benutzereinstellungen, verwaltete Einstellungen oder --settings
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

Sitzungsdaten löschen

Transkripte werden unter den Aufbewahrungsbereinigungsregeln gelöscht. Um die Transkripte eines Projekts und den zugehörigen Status schneller zu löschen, führen Sie claude project purge aus. Wenn Sie eine Hintergrund-Sitzung mit claude rm <id> löschen, bleibt ihr Transkript auf der Festplatte und bleibt über claude --resume verfügbar.

Benennen Sie das Verzeichnis `` selbst

Standardmäßig leitet Claude Code den Namen <project> vom gesamten Arbeitsverzeichnispfad ab. Um den Namen selbst zu wählen, setzen Sie CLAUDE_CODE_PROJECT_DIR_NAME zusammen mit CLAUDE_CONFIG_DIR. Claude Code speichert dann die Transkripte dieser Sitzung und Auto-Memory unter Ihrem Namen. Dies eignet sich für einen Host, der Claude Code einbettet und jeder Sitzung ein eigenes Konfigurationsverzeichnis gibt. Erfordert Claude Code v2.1.234 oder später.

Beispielsweise behält dieser Start die Daten von Mandant A unter /srv/tenant-a und benennt sein Projektverzeichnis work:

CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude

Claude Code schreibt die Transkripte der Sitzung in /srv/tenant-a/projects/work/ und sein Auto-Memory in /srv/tenant-a/projects/work/memory/, unabhängig davon, welches Arbeitsverzeichnis verwendet wird.

Drei Regeln gelten, wenn Sie es setzen:

  • Setzen Sie auch CLAUDE_CONFIG_DIR: Der Name variiert nicht mit dem Arbeitsverzeichnis, daher würde er unter dem Standard ~/.claude die Transkripte und das Auto-Memory aller Projekte in ein Verzeichnis zusammenführen. Claude Code ignoriert CLAUDE_CODE_PROJECT_DIR_NAME, wenn CLAUDE_CONFIG_DIR nicht gesetzt ist.
  • Verwenden Sie 1-64 Buchstaben, Ziffern, Bindestriche oder Unterstriche: Verwenden Sie keinen Windows-Gerätenamen wie con. Claude Code ignoriert jeden anderen Wert und verwendet den abgeleiteten Namen.
  • Setzen Sie es in der Shell-Umgebung, die claude startet: Claude Code liest es beim Start einmal aus dieser Umgebung, daher kann ein env-Block in einer Einstellungsdatei es nicht setzen.

Nachdem Sie ein Projektverzeichnis eines Konfigurationsverzeichnisses benannt haben, starten Sie weiterhin mit diesem Namen. Wenn Sie Claude Code mit demselben CLAUDE_CONFIG_DIR starten, aber ohne CLAUDE_CODE_PROJECT_DIR_NAME, liest und schreibt es das abgeleitete Verzeichnis erneut. Die unter Ihrem Namen gespeicherten Sitzungen bleiben auf der Festplatte: Drücken Sie Ctrl+A in der Sitzungsauswahl, um Sitzungen aus jedem Projektverzeichnis unter diesem Konfigurationsverzeichnis aufzulisten, einschließlich des angehefteten, und unabhängig davon, wie Sie starten, findet claude --resume <session-id> eine Sitzung, die unter beiden Namen gespeichert ist.

Siehe auch

Diese Seiten behandeln verwandte Sitzungs- und Parallelisierungsmechaniken: