SpyBara
Go Premium

agent-view.md 2026-10-01 23:59 UTC to 2026-10-02 09:02 UTC

This page contains 94 additions and 74 deletions.

2026
Thu 1 23:59 Fri 2 09:02

Mehrere Agenten mit der Agenten-Ansicht verwalten

Versenden und verwalten Sie viele Claude Code-Sitzungen von einem Bildschirm aus. Die Agenten-Ansicht zeigt, was jede Sitzung tut und welche Ihre Eingabe benötigen.

Die Agenten-Ansicht, die mit claude agents geöffnet wird, ist ein Bildschirm für alle Ihre Hintergrund-Sitzungen: was läuft, was Ihre Eingabe benötigt und was erledigt ist. Versenden Sie neue Sitzungen, beobachten Sie ihren Status auf einen Blick, anstatt durch Transkripte zu scrollen, und greifen Sie nur ein, wenn eine Sitzung Sie benötigt. Jede Hintergrund-Sitzung ist eine vollständige Claude Code-Konversation, die ohne angeschlossenes Terminal weiterläuft, sodass Sie sie jederzeit öffnen, antworten und verlassen können.

Agenten-Ansicht in einem Terminal. Eine Zeile oben zählt die Sitzungen, die auf Eingabe warten, arbeiten und abgeschlossen sind. Vier Sitzungen sind unter Benötigt Eingabe, Wird ausgeführt und Abgeschlossen gruppiert. Jede Zeile zeigt den Namen der Sitzung, ihren neuesten Status oder ihre Frage und eine Zeit. Am unteren Rand befinden sich eine Eingabe zur Beschreibung einer neuen Aufgabe und eine Reihe von Tastaturhinweisen. Agenten-Ansicht in einem Terminal. Eine Zeile oben zählt die Sitzungen, die auf Eingabe warten, arbeiten und abgeschlossen sind. Vier Sitzungen sind unter Benötigt Eingabe, Wird ausgeführt und Abgeschlossen gruppiert. Jede Zeile zeigt den Namen der Sitzung, ihren neuesten Status oder ihre Frage und eine Zeit. Am unteren Rand befinden sich eine Eingabe zur Beschreibung einer neuen Aufgabe und eine Reihe von Tastaturhinweisen.

Verwenden Sie die Agenten-Ansicht, wenn Sie mehrere unabhängige Aufgaben haben, an denen Claude ohne Ihre ständige Überwachung arbeiten kann. Versenden Sie eine Fehlerbehebung, eine Pull-Request-Überprüfung und eine Untersuchung eines instabilen Tests als drei Zeilen, arbeiten Sie in einem anderen Fenster weiter und überprüfen Sie später, wenn eine Zeile anzeigt, dass sie Sie benötigt oder ein Ergebnis hat.

Wenn Sie direkter in einer Agenten-Sitzung arbeiten möchten, hängen Sie sich an die Zeile an, um die vollständige Konversation zu betreten.

Um die Agenten-Ansicht mit Subagenten, Agent-Teams und Worktrees zu vergleichen, siehe Agenten parallel ausführen. Die Agenten-Ansicht führt Sitzungen auf Ihrem Computer aus und Sie versenden jede einzelne; um Claude stattdessen parallele Sitzungen in der Cloud von einer Konversation aus starten und verfolgen zu lassen, siehe Projekte.

Schnellstart

Diese Anleitung behandelt die Kern-Agenten-Ansicht-Schleife: versenden Sie eine Aufgabe, beobachten Sie, wie ihre Zeile aktualisiert wird, während Claude arbeitet, schauen Sie nach, um sie zu überprüfen und zu antworten, und hängen Sie sich für das vollständige Gespräch an. Die Sitzung, die Sie versenden, läuft weiter, nachdem Sie die Agenten-Ansicht schließen, sodass Sie sie verlassen und später zurückkehren können.

1

Agenten-Ansicht öffnen

Führen Sie in Ihrer Shell aus:

claude agents

Falls Sie den Dialog zum Vertrauen im Arbeitsbereich für das Verzeichnis noch nicht akzeptiert haben, zeigt Claude Code ihn vor dem Öffnen der Agenten-Ansicht an, denselben Dialog, den claude anzeigt. Akzeptieren Sie, um das Vertrauen für den Arbeitsbereich zu speichern und fortzufahren. Falls Sie ablehnen, beendet Claude Code sich, ohne die Agenten-Ansicht zu öffnen.

Die Agenten-Ansicht öffnet sich mit einer Eingabe am unteren Rand und einer Tabelle, die sich füllt, wenn Sitzungen starten. Drücken Sie Esc, um zu Ihrer Shell zurückzukehren; falls Sie die Agenten-Ansicht durch Hintergrundverarbeitung einer Sitzung mit ← geöffnet haben, kehrt Esc stattdessen zu diesem Gespräch zurück. Ihre Sitzungen laufen weiter, während Sie weg sind, und erscheinen erneut, wenn Sie die Agenten-Ansicht das nächste Mal öffnen.

2

Eine Sitzung versenden

Geben Sie eine Eingabeaufforderung ein, die eine Aufgabe beschreibt, und drücken Sie Enter. Eine neue Hintergrund-Sitzung startet bei dieser Aufgabe und wird als Zeile angezeigt, die zeigt, ob sie funktioniert, auf Sie wartet oder erledigt ist. Die neue Sitzung verwendet das Modell, das in der Agenten-Ansicht-Kopfzeile angezeigt wird. Welcher Berechtigungsmodus sie startet, hängt davon ab, wie Sie die Agenten-Ansicht geöffnet haben.

Jede Eingabeaufforderung, die Sie hier eingeben, startet ihre eigene neue Sitzung. Wenn Sie eine weitere Eingabeaufforderung eingeben und Enter drücken, wird eine zweite Sitzung neben der ersten gestartet, anstatt eine Folgefrage daran zu senden. Sie können auf diese Weise mehrere parallel ausführen.

Jede Sitzung nutzt Ihr Abonnementkontingent unabhängig, daher lesen Sie Einschränkungen, bevor Sie viele auf einmal versenden.

3

Vorschau und Antwort

Wählen Sie eine Zeile mit den Pfeiltasten aus und drücken Sie Space, um das Vorschau-Panel zu öffnen. Es zeigt die neueste Ausgabe der Sitzung oder die Frage, auf die sie wartet, anstelle des vollständigen Transkripts. Geben Sie eine Antwort ein und drücken Sie Enter, um sie zu senden, ohne die Agenten-Ansicht zu verlassen.

4

Anhängen und Abhängen

Drücken Sie Enter oder → auf einer Zeile, um sich anzuhängen, wenn Sie das vollständige Gespräch möchten. Die Sitzung übernimmt das Terminal als vollständige interaktive Claude Code-Sitzung. Drücken Sie ← auf einer leeren Eingabeaufforderung, um sich abzuhängen und zur Tabelle zurückzukehren.

5

Eine vorhandene Sitzung einbringen

Dieser Schritt benötigt eine laufende Sitzung. Falls Sie die früheren Schritte befolgt haben, haben Sie keine offene Sitzung in diesem Terminal, daher öffnen Sie eine reguläre claude-Sitzung in einem anderen Terminal und senden Sie ihr zuerst eine Nachricht.

Um eine Sitzung, die Sie bereits offen haben, in die Agenten-Ansicht zu verschieben, führen Sie /bg darin aus, oder drücken Sie ← auf einer leeren Eingabeaufforderung, um sie in den Hintergrund zu verschieben und die Agenten-Ansicht in einem Schritt zu öffnen. In einer neuen Sitzung ohne Nachrichten fragt /bg Sie, zuerst eine Nachricht zu senden, während ← sofort funktioniert. Die Sitzung läuft weiter und wird als Zeile neben den Sitzungen angezeigt, die Sie versendet haben.

Innerhalb einer regulären claude-Sitzung zählt der Hinweis ← in der Eingabeaufforderungs-Fußzeile die Hintergrund-Agenten, die auf Sie warten, wie z. B. ← 2 agents, und kehrt zu ← for agents zurück, wenn keiner Eingaben benötigt. Zählungen über 99 werden als 99+ angezeigt. Die Zählung wird etwa alle zehn Sekunden aktualisiert, während das Terminal fokussiert ist, und sofort, wenn der Fokus zurückkehrt. Sie ändert kurzzeitig die Farbe, wenn sie sich bewegt und wenn ein Agent abgeschlossen wird, und wenn eine Hintergrund-Sitzung endet, während keiner Eingaben benötigt, zeigt sie kurzzeitig die Anzahl der abgeschlossenen Sitzungen an, wie z. B. ← 2 done. Beide Blitze sind aus, wenn die Einstellung prefersReducedMotion aktiviert ist, und der Hinweis ist im Bildschirmlesemodus verborgen.

Agenten-Ansicht standardmäßig öffnen

Um claude ohne Argumente die Agenten-Ansicht statt eines neuen Gesprächs zu öffnen, aktivieren Sie eine /config-Einstellung.

1

Aktivieren Sie die Einstellung

Führen Sie in einer regulären claude-Sitzung /config aus und aktivieren Sie Open agents view by default. Um das Menü zu überspringen, setzen Sie den Schlüssel defaultToAgentsView direkt:

/config defaultToAgentsView=true
2

Starten Sie Claude Code

Beenden Sie die Sitzung und führen Sie claude ohne Argumente aus:

claude

Die Agenten-Ansicht öffnet sich statt eines neuen Gesprächs.

Um eine reguläre Sitzung zu starten, während die Einstellung aktiviert ist, übergeben Sie eine Eingabeaufforderung: claude "fix the login test". Um die Einstellung auszuschalten, führen Sie /config defaultToAgentsView=false in einer regulären Sitzung oder in einer aus, an die Sie sich aus der Agenten-Ansicht anhängen.

Sitzungen mit Agent-Ansicht überwachen

Führen Sie claude agents aus, um die Agent-Ansicht zu öffnen. Sie übernimmt das gesamte Terminal und listet jede Sitzung gruppiert nach Status auf, mit angehefteten Sitzungen und denjenigen, die Sie benötigen, oben. Jede Zeile zeigt den Namen der Sitzung, die aktuelle Aktivität und ihr Alter, gezählt von der Erstellung der Sitzung; das Alter einer abgeschlossenen Sitzung friert bei der Dauer des Durchlaufs ein.

Der Name ist mit der Farbe getönt, die durch /color in dieser Sitzung festgelegt wurde, einschließlich wenn Sie eine Sitzung in den Hintergrund verschieben mit ← oder /background.

Standardmäßig zeigt die Liste jede Hintergrund-Sitzung an, die Sie gestartet haben, über alle Ihre Projekte hinweg. Eine Sitzung, die in einem Repository arbeitet, und eine andere in einem anderen Worktree erscheinen beide hier, unabhängig davon, aus welchem Verzeichnis Sie die Agent-Ansicht geöffnet haben. Um die Liste auf ein Projekt zu beschränken, übergeben Sie --cwd:

claude agents --cwd ~/projects/my-app

Dies zeigt nur Sitzungen an, die unter diesem Verzeichnis gestartet wurden. Es listet immer noch eine Sitzung auf, die in einen Worktree verschoben wurde unter ~/projects/my-app/.claude/worktrees/.

Interaktive Sitzungen, die Sie in anderen Terminals offen haben, erscheinen nicht, bis Sie sie in den Hintergrund verschieben. Subagenten und Teamkollegen, die eine Sitzung erzeugt, werden nicht als separate Zeilen aufgelistet.

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Needs input
  ✻ power-up design           double jump or wall climb?                    1m

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

Sitzungsstatus lesen

Jede Zeile beginnt mit einem Symbol, dessen Farbe und Animation den Status der Sitzung anzeigen:

Status Symbol zeigt sich als Was es bedeutet
Working Animiert Claude führt aktiv Tools aus oder generiert eine Antwort
Needs input Gelb Claude wartet auf etwas, das nur Sie bereitstellen können: eine Antwort auf eine Frage, eine Genehmigungsentscheidung oder eine andere Eingabeaufforderung, die nur Sie beantworten können, wie z. B. eine Sandbox-Eingabeaufforderung, um einen Netzwerk-Host oder einen MCP-Server-Anfrage für Eingabe zuzulassen. Ein Befehl, der ein angehängtes Terminal benötigt, wie /install-github-app oder die /mcp-Einstellungsliste, hält auch eine unbeaufsichtigte Sitzung hier
Idle Gedimmt Die Sitzung hat nichts zu tun und ist bereit für Ihre nächste Eingabeaufforderung
Completed Grün Die Aufgabe wurde erfolgreich abgeschlossen
Failed Rot Die Aufgabe endete mit einem Fehler
Stopped Grau Sie haben die Sitzung mit Ctrl+X oder claude stop gestoppt, ihr Prozess wurde von außerhalb von Claude Code beendet, oder sie endete, während der Hintergrund-Service aus war

Separat zeigt die Form des Symbols, ob der zugrunde liegende Prozess ausgeführt wird:

Form Was es bedeutet
✻ oder animiert ✽ Der Sitzungsprozess ist aktiv und antwortet sofort
∙ Der Prozess hat beendet. Sie können die Zeile immer noch einsehen, und wenn Sie antworten oder anhängen, startet Claude von dort neu, wo es aufgehört hat
✢ Eine /loop-Sitzung, die zwischen Iterationen schläft. Die Zeile zeigt ihre Laufzahl und einen Countdown

Das #N- oder !N-Label, das am rechten Rand einer Zeile erscheinen kann, ist ein Link zum Pull Request oder Merge Request der Sitzung, nicht Teil des Status-Symbols.

Der Terminal-Tab-Titel zeigt die Anzahl der wartenden Eingaben, während die Agent-Ansicht offen ist: 2 awaiting input · claude agents, wenn Sitzungen Eingaben benötigen, oder claude agents, wenn keine benötigt werden.

Um den Sitzungsstatus aus einem Skript oder einem anderen Programm zu lesen, verwenden Sie claude agents --json anstelle der Dateien unter ~/.claude/jobs/.

Während die Agent-Ansicht offen ist, sendet Claude Code auch eine Benachrichtigung über Ihren konfigurierten Terminal-Benachrichtigungskanal, wenn eine lokale Hintergrund-Sitzung Ihre Eingabe benötigt, abgeschlossen wird oder fehlschlägt. Sitzungen, die nach einem Zeitplan ausgeführt werden, wie z. B. /loop-Sitzungen, benachrichtigen nur, wenn sie Ihre Eingabe benötigen. Benachrichtigungen verwenden die gleiche preferredNotifChannel-Einstellung wie der Rest von Claude Code und aktivieren den Notification-Hook mit dem Typ agent_needs_input oder agent_completed.

Hintergrund-Sitzungen benötigen kein offenes Terminal, um weiterhin zu funktionieren. Ein separater Supervisor-Prozess führt sie aus, sodass Sie die Agent-Ansicht schließen, Ihre Shell schließen oder eine neue interaktive Sitzung starten können und Ihre versendete Arbeit weitergeht.

Der Sitzungsstatus bleibt auf der Festplatte durch automatische Updates und Supervisor-Neustarts erhalten. Sitzungen werden auch beibehalten, wenn Ihr Computer in den Ruhezustand wechselt. Ihre Prozesse werden beim Aufwachen fortgesetzt und der Supervisor verbindet sich wieder mit ihnen, anstatt die Zeitlücke als Leerlauf zu behandeln. Das Herunterfahren stoppt immer noch laufende Sitzungen; siehe Sitzungen zeigen sich nach dem Herunterfahren als fehlgeschlagen oder gestoppt, um sie wiederherzustellen.

Eine Sitzung, die sich mitten in einer Antwort befand, als der Computer in den Ruhezustand wechselte, kann nicht reagierend zurückkommen. Wenn Sie eine Sitzung öffnen, die nicht mehr reagiert, startet der Supervisor seinen Prozess neu und die Sitzung setzt die unterbrochene Antwort von dort fort, wo sie aufgehört hat.

Zeilenzusammenfassungen

Die einzeilige Zusammenfassung in jeder Zeile wird von einem Haiku-Klasse-Modell generiert, damit die Zeile Ihnen sagen kann, was die Sitzung tut, was sie benötigt oder was sie produziert hat, ohne das Transkript zu öffnen. Während eine Sitzung aktiv arbeitet, wird der Zeilentext höchstens alle 15 Sekunden aus der eigenen aktuellen Ausgabe der Sitzung aktualisiert, ohne eine Modellanfrage zu senden, und das Modell schreibt eine neue Zusammenfassung, wenn jede Runde endet.

Eine arbeitende Zeile zeigt, was die Sitzung sagt, dass sie tut, und eine blockierte Zeile zeigt die Frage, die sie stellt. Während einer langen Runde schreibt das Modell die Zusammenfassung auch alle paar Minuten neu, damit eine beschäftigte Zeile keine veraltete Zeile mehr anzeigt. Der Zusammenfassungstext füllt die verbleibende Breite der Zeile; öffnen Sie das Peek-Panel, um einen Satz zu lesen, den der Terminal-Rand abschneidet.

Wenn die Liste nach Verzeichnis gruppiert ist, beginnt die Zusammenfassung mit dem Status der Sitzung als farbiges Wort, wie z. B. Needs input · double jump or wall climb?. Bei der Standard-Status-Gruppierung benennt der Gruppen-Header bereits den Status, daher zeigt die Zeile nur die Zusammenfassung.

Die End-of-Turn-Zusammenfassung und jede Mid-Turn-Umschreibung sind eine kurze Haiku-Klasse-Anfrage über Ihren normalen Anbieter, abgerechnet und behandelt unter den gleichen Datennutzungsbedingungen wie die Sitzung selbst. Die 15-Sekunden-Updates zwischen Modell-Umschreibungen verwenden die eigene Ausgabe der Sitzung wieder und senden keine Anfrage. Bei einem Drittanbieter oder Gateway ohne konfiguriertes Haiku-Klasse-Modell verwendet die Anfrage stattdessen das Hauptmodell der Sitzung; setzen Sie ANTHROPIC_DEFAULT_HAIKU_MODEL, um eines auszuwählen.

Pull-Request-Status

Wenn eine Sitzung einen Pull Request öffnet, fügt Claude Code ein Label am rechten Rand der Zeile hinzu, das mit dem Pull Request verlinkt ist:

  • Claude Code schreibt das Label als #1234 für einen Pull Request und als !1234 für einen GitLab-Merge-Request.
  • Claude Code gibt den Link aus, auch wenn es Hyperlink-Unterstützung nicht erkennen kann, z. B. über SSH oder tmux. Setzen Sie FORCE_HYPERLINK=0, um das Label als Klartext zu rendern.
  • Nachdem Sie eine Nachverfolgung an die Sitzung senden, behält Claude Code das Label bei, während die Zeile zum Live-Fortschritt zurückkehrt.

Eine Sitzung, die an einem bestehenden Pull Request arbeitet, ist auf die gleiche Weise damit verlinkt. Claude Code findet den Pull Request unterschiedlich, je nachdem, welchen Befehl Claude ausführt:

  • Wenn Claude einen Pull Request mit gh bearbeitet, kommentiert, schließt oder als bereit markiert, verlinkt Claude Code den Pull Request, den die Ausgabe des Befehls selbst benennt. Ein gh-Befehl, dessen erfasste Ausgabe keinen Pull Request benennt, erstellt keinen Link; gh pr merge ist der häufige Fall, da er sein Ergebnis nur auf einem interaktiven Terminal ausgibt.
  • Wenn Claude einen Pull Request mit gh pr checkout auscheckt oder zu einem Branch pusht, schaut Claude Code den Branch mit gh pr view nach und verlinkt seinen offenen Pull Request.
  • Der Pull Request muss nicht existieren, wenn Claude pusht: Claude Code versucht die Branch-Suche nach bis zu fünf späteren git-, gh-, glab- oder curl-Befehlen, die im gleichen Verzeichnis ausgeführt werden, erneut, sodass ein Pull Request, der nach dem Push erstellt wird, einschließlich eines, den Claude über die GitHub REST API erstellt, verlinkt wird, wenn ein erneuter Versuch ihn findet.

Wenn eine Sitzung mit mehr als einem Pull Request verlinkt ist, zeigt das Label stattdessen eine Anzahl an, wie z. B. 3 PRs, farbig nach dem offenen Pull Request, der am meisten Aufmerksamkeit benötigt. Öffnen Sie das Peek-Panel, um sie alle zu sehen.

Die Pull-Request-Nummer ist nach ihrem Status farbig:

Farbe Pull-Request-Status
Gelb Wartet auf Überprüfungen oder Überprüfung, oder Überprüfungen fehlgeschlagen
Grün Überprüfungen bestanden und keine Überprüfung blockiert
Lila Zusammengeführt
Grau Entwurf oder geschlossen

Überprüfen Sie für eine Aufgabe, die in einem Pull Request endet, dieses Label auf das Ergebnis: Überprüfen und führen Sie den Pull Request zusammen, wenn seine Nummer grün wird.

Peek und Antwort

Drücken Sie Space auf einer ausgewählten Zeile, um das Peek-Panel zu öffnen. Es öffnet sich mit dem Satz, den die Zeile am Terminal-Rand abschneidet, und welcher Satz das ist, hängt vom Status der Sitzung ab:

  • Eine Sitzung, die auf Sie wartet: die genaue Frage, die sie stellt, über der Antwort-Eingabe
  • Eine abgeschlossene Sitzung: ihr Ergebnis
  • Eine arbeitende Sitzung: ihr vollständiger Status-Satz

Alle Pull Requests, die mit der Sitzung verlinkt sind, werden als nächstes aufgelistet. Für eine Sitzung, die auf Sie wartet, zeigt eine Zeile wie waiting 3m darunter, wie lange sie wartet, und es ist die einzige Zeit, die im Panel angezeigt wird. Das Alter am rechten Rand der Zeile ist eine andere Zahl: es zählt von der Erstellung der Sitzung.

Meistens ist das Peek-Panel ausreichend und Sie müssen das vollständige Transkript nicht öffnen.

Geben Sie im Peek-Panel eine Antwort ein und drücken Sie Enter, um sie an diese Sitzung zu senden. Stellen Sie einer Antwort ! voran, um stattdessen einen Bash-Befehl zu senden. Was mit der Antwort geschieht, hängt von der Sitzung und davon ab, was Sie senden:

  • Eine arbeitende Sitzung: Die Antwort wird in die Nachrichtenwarteschlange der Sitzung eingereiht, anstatt die laufende Antwort zu unterbrechen, und wird wirksam, wenn auch Eingaben in der Warteschlange wirksam werden. Ein Befehl wartet, bis der Turn endet, selbst einer, der sofort ausgeführt wird, wenn Sie ihn im eigenen Prompt einer Sitzung eingeben
  • Eine Antwort, die genau /stop lautet: stoppt die Sitzung sofort, anstatt an sie zugestellt zu werden, unabhängig davon, ob die Sitzung arbeitet oder auf Sie wartet
  • Ein Shell-Job: Die Antwort, einschließlich /stop, geht als getippte Eingabe an das Terminal des Befehls

Wenn die Sitzung auf Sie wartet, hängt die Art, wie Sie im Peek-Panel antworten, davon ab, worauf sie wartet:

  • Eine Frage mit vordefinierten Optionen: Das Panel listet die Optionen nummeriert auf. Drücken Sie bei leerer Antwort-Eingabe die Nummer einer Option, um sie einzufügen, und dann Enter, um sie zu senden, oder geben Sie stattdessen Ihre eigene Antwort ein
  • Eine Frage ohne vordefinierte Optionen: Geben Sie Ihre Antwort ein. Wenn die leere Eingabe eine vorgeschlagene Antwort zeigt, drücken Sie Tab, um sie einzufügen, und bearbeiten Sie sie vor dem Senden
  • Eine Berechtigungsabfrage oder ein anderer Dialog, wie z. B. eine Sandbox-Abfrage oder die Anfrage nach Eingaben eines MCP-Servers: Eine Antwort beantwortet ihn nicht. Ihre Antwort wartet in der Warteschlange. Um den Dialog zu beantworten, hängen Sie mit → an

Wenn ein PermissionRequest- oder PreToolUse-Hook eine Ausgabe zurückgibt, die Claude Code für den Aufruf, den die Sitzung fragt, nicht validieren kann, zeigt die Zeile das Hook-Ereignis und hook output invalid: mit dem Validierungsfehler vor dem Text der ausstehenden Anfrage. Für einen Hook, der auf andere Weise fehlschlägt, sagt die Zeile, dass der Hook fehlgeschlagen ist. Die Sitzung wartet immer noch auf die gleiche Anfrage.

Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrund-Service nicht erreichbar ist oder das Senden fehlschlägt, wird gespeichert und an die Sitzung als nächste Eingabeaufforderung gesendet, wenn ihr Prozess wieder startet, und die Fehlermeldung sagt, dass die Antwort gespeichert wurde. Eine Antwort mit dem Präfix ! wird nicht gespeichert, da der gespeicherte Text die Sitzung als einfache Eingabeaufforderung erreichen würde, anstatt als Bash-Befehl ausgeführt zu werden.

Mit Sprachdiktat aktiviert, halten oder tippen Sie Ihre Push-to-Talk-Taste, während die Antwort-Eingabe fokussiert ist, um eine Antwort zu diktieren, anstatt sie einzugeben. Das gleiche funktioniert in der Versand-Eingabe am unteren Rand der Agent-Ansicht.

Verwenden Sie ↑ und ↓, um benachbarte Sitzungen zu einsehen, ohne das Panel zu schließen, oder →, um anzuhängen.

An eine Sitzung anhängen

Drücken Sie Enter oder → auf einer ausgewählten Zeile, um anzuhängen. Die Agent-Ansicht wird durch die vollständige interaktive Sitzung ersetzt. Wenn Sie anhängen, sendet Claude eine kurze Zusammenfassung dessen, was passiert ist, während Sie weg waren.

Während Sie angehängt sind, verhält sich die Sitzung wie jede andere Claude Code-Sitzung: Befehle, Tastaturkürzel und Funktionen funktionieren alle, mit den folgenden Ausnahmen.

Während Sie angehängt sind, funktionieren /install-github-app und die /mcp-Einstellungsliste normal, da ein Mensch am Terminal ihre Dialoge abschließen kann. Wenn niemand angehängt ist, können diese Befehle ihre Dialoge nicht öffnen, daher erscheint die Sitzung unter Needs input in der Agent-Ansicht mit einer Zeile wie open this session to manage MCP servers, und die Transkript-Antwort sagt das gleiche. Hängen Sie an und führen Sie den Befehl erneut aus, um fortzufahren; die Needs-Input-Zeile wird gelöscht, wenn Sie anhängen. /mcp reconnect <server>, /mcp enable und /mcp disable funktionieren ohne Anhängen auf beide Arten.

Angehängte Sitzungen werden immer im Vollbildmodus gerendert, unabhängig von Ihrer tui-Einstellung, da eine Hintergrund-Sitzung keinen Terminal-Scrollback zum Anhängen hat. Scrollen Sie mit PgUp, PgDn oder dem Mausrad, und drücken Sie Ctrl+O für den Transkript-Modus. Ihr natives Terminal-Scroll und tmux-Kopier-Modus zeigen nur den aktuellen Viewport, das gleiche wie wenn Sie eine beliebige Vollbildanwendung ausführen.

Drücken Sie ← auf einer leeren Eingabeaufforderung oder führen Sie /exit aus, um zu trennen und zur Agent-Ansicht zurückzukehren, unabhängig davon, ob Sie die Sitzung aus der Agent-Ansicht oder mit claude attach <id> aus Ihrer Shell geöffnet haben.

← trennt sich auch, während das /btw-Overlay offen ist. Erfordert Claude Code v2.1.257 oder später. Eine Nebenfrage, die immer noch antwortet, läuft weiter, während Sie weg sind. Das nächste Mal, wenn Sie anhängen, öffnet sich das Overlay damit neu, oder mit seiner Antwort.

Unter Windows, wenn Sie ← innerhalb von etwa einer halben Sekunde nach dem Anhängen drücken, zeigt Claude Code Ambiguous ←, press again to detach, da das Terminal in diesem Fenster einen Druck von vor dem Anhängen erneut liefern kann. Drücken Sie ← erneut, um zu trennen.

Ctrl+Z trennt sich auch, geht aber stattdessen dorthin zurück, wo Sie angefangen haben: Agent-Ansicht, wenn Sie von dort angehängt haben, oder Ihre Shell, wenn Sie claude attach ausgeführt haben. Verwenden Sie Ctrl+Z, wenn ein Dialog den Fokus hat und nicht auf ← reagiert.

Ctrl+C behält sein Standard-Interrupt-Verhalten bei, während es angehängt ist: Es bricht eine laufende Antwort oder einen !-Shell-Befehl ab, anstatt zu trennen. Wenn Sie Ctrl+C zweimal auf einer leeren Eingabeaufforderung drücken, trennen Sie sich, das gleiche wie in jeder Sitzung.

Das Trennen stoppt niemals eine Hintergrund-Sitzung: ←, Ctrl+Z, /exit und doppeltes Ctrl+C oder doppeltes Ctrl+D lassen sie alle laufen. Um eine Sitzung von innen zu beenden, führen Sie /stop aus.

Sitzungen wechseln, ohne das Terminal zu verlassen

In einer Sitzung, die im Vordergrund läuft, eine, die Sie im Terminal gestartet haben, anstatt sie aus der Agent-Ansicht anzuhängen, drücken Sie ← auf einer leeren Eingabeaufforderung, um sie in den Hintergrund zu verschieben und die Agent-Ansicht mit dieser Zeile ausgewählt zu öffnen, sodass Sie Sitzungen wechseln können, ohne das Terminal zu verlassen. Der gleiche einzelne Druck trennt eine angehängte Sitzung.

Wenn Sie ← direkt nach dem Löschen des letzten Textes der Eingabeaufforderung oder dem Durchsuchen des Eingabeverlaufs drücken, fragt Claude Code Sie zur Bestätigung: Der erste Druck zeigt Press ← again to open agents oder Press ← again to go back to agents in einer angehängten Sitzung, und der zweite Druck wechselt.

Wenn ← eine Vordergrund-Sitzung in den Hintergrund verschiebt, zeigt die Agent-Ansicht Your conversation moved to the background über der Liste, mit dieser Sitzungszeile bereits ausgewählt. Von dort:

  • Drücken Sie Enter, um die Konversation erneut zu öffnen.
  • Drücken Sie Esc, um den Wechsel rückgängig zu machen und zur Konversation zurückzukehren. Wenn Esc Still starting — try again in a moment anzeigt, ist die Hintergrund-Sitzung noch nicht bereit, also drücken Sie Esc in einem Moment erneut.
  • Drücken Sie Ctrl+C zweimal, um zu Ihrer Shell zu beenden.

Wenn Claude Code die Konversation nicht erneut öffnen kann, wird es beendet und gibt einen claude --resume-Befehl aus, der sie fortgesetzt.

Claudes Aufgabenliste wird mit der Konversation zur Hintergrund-Sitzung verschoben, sodass die Checkliste intakt ist, wenn Sie zu dieser Zeile zurückkehren.

Die Zeile, auf die Sie ← drückten, behält auch einen fetten, nicht gedimmten Namen, nachdem Sie die Auswahl mit den Pfeiltasten oder der Maus verschieben, sodass Sie sehen können, von welcher Sitzung Sie gekommen sind.

Wenn ein Tool läuft, wenn Sie ← drücken, wartet Claude Code bis zu etwa zehn Sekunden, bis es fertig ist, bevor es in den Hintergrund verschoben wird, und Claude setzt die Antwort in der Hintergrund-Sitzung fort. Drücken Sie ← erneut, um sofort in den Hintergrund zu verschieben, anstatt zu warten. Wenn in-flight-Arbeit nicht zur Hintergrund-Sitzung übertragen werden kann, zeigt Claude Code zuerst den Background this session?-Dialog, das gleiche wie mit /background.

Das zehn-Sekunden-Limit gilt nicht, während die Vordergrund-Subagenten, die Claude in der Konversation gestartet hat, noch laufen. Claude Code wartet weiter, damit ihre Arbeit übertragen wird, und zeigt eine Still backgrounding after the current tool-Benachrichtigung, während es wartet. Drücken Sie ← erneut, um ohne Warten in den Hintergrund zu verschieben, was diese Subagenten von vorne neu startet. Claude Code wartet nicht auf die Subagenten, die ein dynamischer Workflow ausführt. Wenn ein Workflow Subagenten ausführt, zeigt Claude Code stattdessen den Background this session?-Dialog.

Claude Code verschiebt die Sitzung nicht in den Hintergrund, während Sie ungesendeten Text in der Eingabeaufforderung haben, da der Text in Ihrem Terminal-Eingabefeld bleibt und nicht zur Hintergrund-Sitzung verschoben würde. Wenn Sie in die Eingabe tippen, während Claude Code wartet, um die Sitzung in den Hintergrund zu verschieben, bricht es den Wechsel mit Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again. ab.

Wenn Sie ← drücken, wird die Sitzungszeile erstellt, auch wenn die Konversation noch keine Nachrichten hat, sodass → immer noch zu ihr zurückkehrt.

Sie können diese Verknüpfung mit der leftArrowOpensAgents-Einstellung in /config ausschalten.

Liste organisieren

Die Agent-Ansicht gruppiert Sitzungen, sodass die, die Eingaben benötigen, oben sind, mit Ready for review und Needs input über Working und Completed. Diese Gruppennamen entsprechen nicht eins-zu-eins den Status oben: Eine Sitzung wechselt zu Ready for review, wenn sie einen offenen Pull Request hat, und Completed sammelt abgeschlossene, fehlgeschlagene und gestoppte Sitzungen zusammen.

Drücken Sie Ctrl+S, um stattdessen nach Verzeichnis zu gruppieren. Ihre Wahl bleibt über Durchläufe hinweg erhalten.

Innerhalb einer Gruppe:

  • Drücken Sie Ctrl+T, um eine Sitzung oben anzuheften und ihren Prozess im Leerlauf laufen zu lassen
  • Drücken Sie Shift+↑ oder Shift+↓, um Sitzungen neu zu ordnen
  • Drücken Sie Ctrl+R, um eine Sitzung umzubenennen
  • Drücken Sie Enter auf einem Gruppen-Header, um ihn einzuklappen, außer während ein Filter aktiv ist; dann bleiben alle Gruppen ausgeklappt

Um eine Sitzung aus der Liste zu entfernen, drücken Sie Ctrl+X, um sie zu stoppen, und Ctrl+X erneut innerhalb von zwei Sekunden, um sie zu löschen. Wenn Sie Ctrl+X auf einem Gruppen-Header drücken, werden alle Sitzungen in dieser Gruppe nach Bestätigung gelöscht.

Der zweite Druck löscht die Sitzung auch, wenn der Stoppversuch fehlschlägt, z. B. weil der Hintergrund-Service nicht reagiert: Die Bestätigung bleibt für weitere zwei Sekunden aktiv, und das Löschen beendet den Prozess der Sitzung selbst. Drücken Sie Esc, um die Bestätigung zu schließen, ohne zu löschen.

Mit Ausnahme der beibehaltenen Fälle, die in Was das Löschen einer Sitzung entfernt behandelt werden, entfernt das Löschen die Sitzung aus der Liste, und ein Worktree, den Claude dafür erstellt hat, wird entfernt, beibehalten oder an Ort und Stelle gelassen, je nachdem, wie Sie löschen und was der Worktree enthält. Das Konversations-Transkript bleibt immer auf Ihrem lokalen Computer, verfügbar über claude --resume.

Um eine Sitzung auf Claude Code v2.1.212 oder später zurückzubringen, geben Sie /resume in die Versand-Eingabe ein. Ein Picker öffnet sich mit vergangenen Sitzungen des Repositorys, aus dem Sie die Agent-Ansicht geöffnet haben, neueste zuerst, einschließlich Sitzungen, die Sie aus der Liste gelöscht haben; Sitzungen, die bereits eine Zeile haben, werden nicht aufgelistet. ↑/↓ verschieben die Auswahl, Enter setzt die ausgewählte Sitzung als Hintergrund-Sitzung fort, damit sie als Zeile wieder in die Liste aufgenommen wird, und Esc schließt den Picker.

Der Picker öffnet sich nur für ein einfaches /resume. Ein gezieltes, bereichsgebundenes oder eingeschränktes Resume kann nicht vom Picker bedient werden, daher zeigt die Agent-Ansicht den attach to a session to run it-Hinweis stattdessen, wenn:

  • /resume eine ID oder einen Suchbegriff benennt
  • Die Ansicht ist mit --cwd bereichsgebunden
  • Die Ansicht wurde mit --safe-mode gestartet
  • Die Ansicht wurde mit einem Flag wie --permission-mode oder --settings geöffnet

Abgeschlossene Sitzungen, die nicht auf den Bildschirm passen, werden in eine … N more-Zeile gefaltet. Fehler und Sitzungen mit einem offenen Pull Request bleiben immer sichtbar. Die Completed-Gruppe füllt den vertikalen Platz, der nach den Live-Gruppen verbleibt, und auf einem kurzen Terminal wird der Header zu einer einzelnen Zusammenfassungszeile komprimiert, sodass Sitzungen, die arbeiten oder Eingaben benötigen, sichtbar bleiben.

Sitzungen filtern

Beginnen Sie die Versand-Eingabe mit einem dieser Filter, um die Liste während der Eingabe einzugrenzen:

Filter Zeigt
a:<name> Sitzungen, die den benannten Agenten ausführen
s:<state> Sitzungen im angegebenen Status, wie z. B. s:working, oder unter dem angegebenen Gruppen-Header, wie z. B. s:ready für Ready for review. s:blocked listet alles auf, was auf Sie wartet
n:<text> Sitzungen, deren Name oder erster Prompt den Text enthält, wie z. B. n:login. Erfordert Claude Code v2.1.287 oder später
o:<text> Sitzungen, deren Ergebnis den Text enthält, wie z. B. o:merged. Ein einfaches o: listet jede Sitzung auf, die ein Ergebnis gemeldet hat
Eine Pull- oder Merge-Request-Nummer, wie z. B. #1234, oder ihre URL Die Sitzung, die an diesem Pull Request oder Merge Request arbeitet
Jede andere URL Die Sitzung, deren erste Eingabeaufforderung diese URL enthielt

Um Filter zu kombinieren, beginnen Sie mit a:, s:, n: oder o: und fügen Sie weitere hinzu, getrennt durch Leerzeichen. Die Liste zeigt die Sitzungen, die allen entsprechen. Zum Beispiel listet s:blocked a:reviewer die reviewer-Sitzungen auf, die auf Sie warten.

Während ein Filter aktiv ist, werden eingeklappte Gruppen ausgeklappt, um ihre Treffer anzuzeigen, und der erste Treffer ist ausgewählt, sodass Enter ihn öffnet. Leeren Sie die Eingabe, um den Filter zu entfernen, und diese Gruppen werden wieder eingeklappt.

Tastaturkürzel

Drücken Sie ? in der Agent-Ansicht, um jede Verknüpfung im Kontext zu sehen. Die folgende Tabelle fasst sie zusammen.

Verknüpfung Aktion
↑ / ↓ Zwischen Zeilen verschieben
PgUp / PgDn Um eine Bildschirmseite an Zeilen nach oben oder unten wechseln
Home / End Zur ersten oder letzten Zeile springen
Enter An die ausgewählte Sitzung anhängen oder den Text der Eingabe absenden, wenn es sich nicht um einen Filter handelt
Space Peek-Panel für die ausgewählte Sitzung öffnen oder schließen
Shift+Enter Zeilenumbruch in der Versand-Eingabe einfügen, wie in der Haupt-Eingabeaufforderung
Ctrl+Enter Versenden und sofort anhängen, in Terminals, in denen das ?-Overlay ctrl+enter to start and open auflistet
→ An die ausgewählte Sitzung anhängen
Alt+1..Alt+9 An Sitzung 1–9 im fokussierten Sitzungsverzeichnis anhängen
Tab Bei leerer Eingabe alle Subagenten durchsuchen. Andernfalls den hervorgehobenen Vorschlag anwenden
Ctrl+S Gruppierung zwischen Status und Verzeichnis wechseln
Ctrl+T Ausgewählte Sitzung anheften oder abheften
Ctrl+R Ausgewählte Sitzung umbenennen
Ctrl+G Versand-Eingabeaufforderung in Ihrem $VISUAL oder $EDITOR öffnen
Ctrl+J Zeilenumbruch in der Versand-Eingabe einfügen
Ctrl+X Sitzung stoppen; innerhalb von zwei Sekunden erneut drücken, um sie zu löschen
Shift+↑ / Shift+↓ Ausgewählte Sitzung neu ordnen
Esc Peek-Panel schließen, Eingabe löschen oder beenden. Wenn Sie die Agent-Ansicht durch Verschieben Ihrer Sitzung mit ← in den Hintergrund geöffnet haben, kehrt das letzte Esc zu dieser Konversation zurück, anstatt zu beenden. Mit Vim-Editor-Modus an, drücken Sie Esc in der Eingabe, um von INSERT zu NORMAL-Modus zu wechseln und Ihren Text zu behalten, wie in der Haupt-Eingabeaufforderung
Ctrl+C Eingabe löschen; zweimal drücken, um zu beenden
? Alle Verknüpfungen anzeigen

Ctrl+S, Ctrl+T und Ctrl+G folgen Ihrer keybindings.json. Binden Sie Ctrl+S und Ctrl+T mit den Aktionen agents:switchView und agents:togglePin im Agents-Kontext neu oder heben Sie die Bindung auf, und Ctrl+G über die Chat-Kontext-Bindung chat:externalEditor. Die anderen Verknüpfungen in der Tabelle können nicht neu gebunden werden.

Neue Agenten versenden

Sie können neue Hintergrund-Sitzungen aus der Agenten-Ansicht versenden, eine vorhandene interaktive Sitzung in den Hintergrund verschieben oder eine direkt aus der Shell starten.

Aus der Agenten-Ansicht

Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand der Agenten-Ansicht ein und drücken Sie Enter, um eine neue Hintergrund-Sitzung zu starten. Die Sitzung wird automatisch aus der Eingabeaufforderung benannt. Sie können sie später mit Ctrl+R umbenennen.

Der automatische Name ist eine kurze Bezeichnung, die von einem Haiku-Klasse-Modell geschrieben wird. Ein Name, den die Sitzung später erhält, wird auch auf ihrer Zeile angezeigt, einschließlich des generierten Titels, den die Sitzung erhält, wenn Sie einen Plan akzeptieren in dieser Sitzung.

Fügen Sie ein Bild in die Eingabeaufforderung ein, um einen Screenshot oder ein Diagramm mit der Aufgabe einzubeziehen.

Eingefügter Text, der länger als 800 Zeichen ist oder mehr als drei Zeilen umfasst, wird zu einem [Pasted text #N]-Platzhalter zusammengefasst, sodass die Eingabe auf einer Zeile bleibt; der vollständige Text wird beim Versenden gesendet. Um den zusammengefassten Text vor dem Versenden zu überprüfen oder zu bearbeiten, fügen Sie denselben Text erneut ein und der Platzhalter wird wieder in die Eingabe erweitert.

Präfixieren oder erwähnen Sie Teile der Eingabeaufforderung, um zu steuern, wie die Sitzung startet:

Eingabe Effekt
<agent-name> <prompt> Wenn das erste Wort einem benutzerdefinierten Subagenten-Namen entspricht, wird dieser Subagent als Hauptagent der Sitzung mit der Konfiguration aus seinem Frontmatter ausgeführt
@<agent-name> Erwähnen Sie einen benutzerdefinierten Subagenten überall in der Eingabeaufforderung, um ihn als Hauptagent auszuführen
@<repo> Erwähnen Sie ein Repository, um die Sitzung dort auszuführen. Siehe In ein bestimmtes Verzeichnis versenden, um zu erfahren, welche Repositories aufgelistet sind
/<command> Schlagen Sie Skills und Befehle vor, um als Eingabeaufforderung zu versenden
! <command> Führen Sie einen Shell-Befehl als Hintergrund-Job aus, anstatt eine Claude-Sitzung zu starten. Der Job wird als Zeile angezeigt, die Sie anhängen, beobachten und trennen können
#<number> oder eine Pull- oder Merge-Request-URL Wenn eine Sitzung bereits an diesem Pull Request oder Merge Request funktioniert, wählt Claude Code ihre Zeile aus, anstatt eine neue Sitzung zu versenden

Ein kleiner Satz von Befehlen wird in der Agenten-Ansicht selbst ausgeführt, anstatt zu versenden:

  • /exit und /quit schließen die Agenten-Ansicht
  • /logout meldet Sie ab
  • /model setzt das Versand-Modell
  • /login öffnet den Anmeldedialog, damit Sie sich erneut anmelden können, ohne an eine Sitzung anzuhängen
  • Ein einfaches /resume oder sein Alias /continue öffnet eine Auswahl der vergangenen Sitzungen des Repositories, um eine zurückzubringen als Hintergrund-Sitzung. Erfordert Claude Code v2.1.212 oder später

Skills, Ihre eigenen Befehle und Eingabeaufforderungs-erweiternde Built-ins wie /init werden als erste Eingabeaufforderung an eine neue Hintergrund-Sitzung gesendet. Andere Built-in-Befehle zeigen stattdessen einen attach to a session to run it-Hinweis an. Alles, was Sie eingegeben haben, bleibt in der Eingabe neben dem Hinweis, damit Sie es bearbeiten können.

Das Verpacken einer wiederkehrenden Aufgabe als Skill ermöglicht es Ihnen, denselben Workflow aus der Agenten-Ansicht wiederholt zu starten, ohne die Eingabeaufforderung erneut einzugeben.

Wenn derselbe @name sowohl einem Subagenten als auch einem gleichgeordneten Repository entspricht, hat der Subagent Vorrang. Die Übereinstimmung mit dem ersten Wort gilt auch, sodass eine Eingabeaufforderung, die mit einem Ihrer Subagenten-Namen beginnt, diesen Subagenten versendet, anstatt das Wort als einfachen Text zu behandeln. Verwenden Sie die @-Form, wenn Sie explizit sein möchten, oder beginnen Sie die Eingabeaufforderung mit einem anderen Wort, um die Übereinstimmung zu vermeiden.

In ein bestimmtes Verzeichnis versenden

Eine neue Sitzung läuft in dem Verzeichnis, in dem Sie die Agenten-Ansicht geöffnet haben. Um ein anderes Verzeichnis anzusteuern, verwenden Sie eines dieser Verfahren:

  • Öffnen Sie claude agents in diesem Verzeichnis.

  • Öffnen Sie claude agents in einem übergeordneten Verzeichnis und erwähnen Sie ein untergeordnetes Repository mit @<repo> in der Eingabeaufforderung. Wenn Sie @ eingeben, werden diese Ziele aufgelistet:

    • Git-Repositories eine Ebene unter dem Startverzeichnis
    • Die registrierten Git-Worktrees des Repositories, von dem Sie gestartet haben, die sich in seinem Verzeichnisbaum befinden, wie die, die Claude unter .claude/worktrees/ erstellt, gekennzeichnet mit ihrem ausgecheckten Branch. Worktrees, die außerhalb des Repositories hinzugefügt wurden, wie mit git worktree add ../feature, werden nicht aufgelistet
    • Jedes Verzeichnis, das bereits eine Sitzung in der Liste hat

    Ein Verzeichnis, dessen Name ein Leerzeichen enthält, wird nicht aufgelistet.

  • Führen Sie in der Shell cd in das Verzeichnis aus und führen Sie claude --bg "<prompt>" aus.

Wenn die Agenten-Ansicht nach Verzeichnis gruppiert ist, wird das Verzeichnis der ausgewählten Zeile zum Versand-Ziel, sodass Sie eine Gruppe auswählen und darin versenden können, ohne den Pfad erneut einzugeben.

Aus einer Sitzung heraus

Zwei Befehle verschieben Arbeit aus der Sitzung, in der Sie sich befinden, in den Hintergrund: /background sendet das aktuelle Gespräch dorthin und gibt Ihr Terminal frei, und /fork sendet eine Kopie, während Sie weiterarbeiten, wo Sie sind.

Die Sitzung in den Hintergrund verschieben

Führen Sie /background oder seinen Alias /bg aus, um das aktuelle Gespräch in eine Hintergrund-Sitzung zu verschieben. Übergeben Sie eine Eingabeaufforderung wie /bg run the test suite and fix any failures, um eine weitere Anweisung zu senden, bevor Sie verschieben. Wenn Claude antwortet, wenn Sie /bg ausführen, wird die Antwort in der Hintergrund-Sitzung fortgesetzt.

Das Beenden einer Sitzung, die noch Hintergrund-Arbeit ausführt, wie z. B. Subagenten, Hintergrund-Shell-Befehle, Workflows oder Monitore, zeigt einen Dialog Background work is running an, anstatt sofort zu beenden. Wählen Sie Move to background and exit, um die Sitzung auf die gleiche Weise wie /background in den Hintergrund zu verschieben und zu Ihrer Shell zurückzukehren. Die Option wird nicht angezeigt, wenn die Agenten-Ansicht ausgeschaltet ist.

Wenn eine Hintergrund-Sitzung auf der Liste bereits den Namen des Gesprächs hat, nummeriert Claude Code den Namen der neuen Zeile, z. B. my-session (2), und lässt den Namen der vorhandenen Zeile unverändert. Um die neue Zeile umzubenennen, wählen Sie sie in der Agenten-Ansicht aus und drücken Sie Ctrl+R.

Die Sitzung mit /fork kopieren

Führen Sie /fork aus, um das aktuelle Gespräch in eine neue Hintergrund-Sitzung zu kopieren, während das Original weiterläuft. Die Kopie beginnt mit allem im Gespräch bis zu diesem Punkt; siehe die Aufzählungspunkte unten, wo die Kopie läuft. Sie trägt auch das Modell, den Berechtigungsmodus, die Aufwandsstufe und alle Verzeichnisse oder „nicht erneut fragen"-Berechtigungszuschüsse mit sich, die Sie während der Sitzung hinzugefügt haben. Die Kopie wird als eigene Zeile in der Agenten-Ansicht angezeigt.

Nach dem Fork sind die beiden Gespräche unabhängig: Nichts, was die Kopie tut, gelangt von selbst in das ursprüngliche Gespräch, obwohl in Sitzungen, in denen sitzungsübergreifendes Messaging aktiviert ist, Claude aus beiden Sitzungen die andere explizit anschreiben kann.

Das Kopieren der Sitzung erfordert Claude Code v2.1.212 oder später; auf v2.1.161 bis v2.1.211 startet /fork stattdessen einen verzweigten Subagenten, der jetzt /subtask ist. Wenn Agenten-Ansicht ausgeschaltet ist, behält /fork das Verhalten des verzweigten Subagenten bei und /subtask ist nicht verfügbar.

Übergeben Sie eine Eingabeaufforderung wie /fork open a draft pull request with the work so far und die Kopie beginnt sofort damit zu arbeiten. Ohne eine Eingabeaufforderung wartet die Kopie auf ihre erste Anweisung: Wählen Sie ihre Zeile in claude agents aus und drücken Sie Space, um eine zu senden, oder führen Sie claude attach <id> aus. Die ausgewählte Zeile zeigt space to send it a prompt, während sie wartet.

Die /fork-Bestätigung ist eine Zeile, die den Zustand der Kopie anzeigt, z. B. session running, den Namen ihrer Agenten-Ansicht-Zeile und ihre Sitzungs-ID für claude attach. Klicken Sie auf den Namen, um in die Kopie zu wechseln: Diese Sitzung wird in den Hintergrund verschoben, genauso wie das Drücken von ←, und die Agenten-Ansicht öffnet die Sitzung der Kopie.

Außer wenn die Kopie an Ort und Stelle bearbeitet, weist Claude Code sie an, ihren eigenen Worktree zu erstellen, bevor Code-Änderungen vorgenommen werden. Außerhalb eines Git-Repositories erhält nur eine Kopie, die aus einem Hook-erstellten Worktree verschoben wird, die Anweisung; ohne WorktreeCreate-Hook bearbeitet die Kopie an Ort und Stelle. Eine Kopie, die aus Ihrem Worktree verschoben wird, wird auch angewiesen, diesen Worktree niemals zu bearbeiten, Befehle darin auszuführen oder einzugeben, unabhängig von der Isolationseinstellung.

Wo die Kopie startet, hängt davon ab, wo die aktuelle Sitzung läuft:

  • Wie jede versendete Sitzung verschiebt sich die Kopie in ihren eigenen Worktree, bevor Dateien bearbeitet werden. In diesem Fall erwähnt die Bestätigung nicht, wo die Kopie läuft.
  • Wenn Ihre Sitzung nach dem Start in ihren verknüpften Worktree verschoben wurde, startet die Kopie dort, wo die Sitzung vor der Verschiebung war, und macht, sofern sie nicht an Ort und Stelle bearbeitet, ihre Code-Änderungen in einem eigenen Worktree dort. Wenn Ihr Worktree auf einem Branch ausgecheckt ist, weist diese Anweisung auch eine Kopie an, deren Aufgabe auf Ihrer Arbeit aufbaut, ihre neuen Branches auf Ihrem zu basieren, da Ihr Branch in Ihrem Worktree ausgecheckt bleibt. Die Bestätigung endet mit runs in the origin tree.
  • Wenn Sie die Sitzung in einem verknüpften Worktree eines Repositories gestartet haben, das einen Haupt-Arbeitsbaum hat, startet die Kopie in diesem Haupt-Arbeitsbaum, mit der gleichen Worktree-eigenen Regel, aber ohne Branch-Anweisung. Die Bestätigung endet auch hier mit runs in the origin tree.
  • Eine Sitzung, die in einem Worktree eines Bare-Repository-Layouts gestartet wurde, hat keinen Haupt-Arbeitsbaum, zu dem sie zurückkehren kann, daher bleibt die Kopie dort, wo sie ist, und die Bestätigung endet mit edits this checkout. Die gleiche Notiz wird angezeigt, wenn Worktree-Isolation ausgeschaltet ist in einer Sitzung, die sich nicht in einem verknüpften Worktree befindet, weil die Kopie dann die Dateien bearbeitet, die Sie offen haben.

Sitzungen, die mit Start-Flags gestartet wurden, die die Kopie nicht erben würde, wie ein ersetzter System-Prompt oder eine --tools-Zulassungsliste, können nicht geforkt werden; Claude Code sagt das stattdessen, anstatt eine teilweise Kopie zu erstellen. Eine Sitzung, die aus der Agenten-Ansicht versendet wird, forkt normal: Die Kopie wird mit der gleichen Agent-Definition und angehängten Anweisungen wie die Sitzung, aus der sie kam, gestartet.

Was beim Verschieben in den Hintergrund übertragen wird

Das Verschieben in den Hintergrund startet einen neuen Prozess, der aus dem gespeicherten Gespräch fortgesetzt wird, und laufende Arbeit wird übertragen: Ausführen von Hintergrund-Shell-Befehlen, Hintergrund-Subagenten, dynamische Workflows, geplante Aufgaben, die Sie mit /loop erstellt haben, und Claudes automatische Antworten auf Artifact-Kommentare werden alle übertragen und laufen dort weiter. Ein Subagent wird zusammen mit allem übertragen, das er gestartet hat, daher wird er nur übertragen, wenn all diese Arbeit auch übertragen werden kann. Um laufende Arbeit stattdessen zu stoppen, anstatt sie zu übertragen, setzen Sie die Umgebungsvariable CLAUDE_DISABLE_ADOPT=1; Claude Code fordert Sie dann auf, zu bestätigen, bevor Sie verschieben.

Wenn ein dynamischer Workflow noch Subagenten ausführt, fragt Claude Code vor dem Verschieben mit dem Dialog Background this session? nach, der anzeigt, wie viele Subagenten neu gestartet würden. Wählen Sie Stay, um sie zuerst fertig zu stellen. Wenn Sie bestätigen, spielt Claude Code den Lauf in der Hintergrund-Sitzung ab: Subagenten, die noch liefen, starten von vorne, daher werden die Tokens, die sie bisher verwendet haben, erneut ausgegeben. Siehe Nach einer Pause fortsetzen, um zu erfahren, welche abgeschlossenen Subagenten ihre gespeicherten Ergebnisse zurückgeben und welche erneut ausgeführt werden.

Claude Code stoppt Arbeit, die nicht übertragen werden kann, wie z. B. ein laufender Monitor, und stoppt einen Hintergrund-Subagenten, der einen Monitor zusammen mit ihm besitzt. Wenn eine solche Arbeit läuft, zeigt Claude Code den Dialog Background this session? an, damit Sie bestätigen können, bevor es gestoppt wird.

Sobald sich die Sitzung im Hintergrund befindet, kann sie neue Subagenten, Monitore und Hintergrund-Befehle starten, und diese laufen bei späteren Trennungen und Wiederverbindungen weiter.

Konfigurationsflags aus dem ursprünglichen Start werden auf die versendete Sitzung übertragen, sodass ihre MCP-Server, Einstellungen und Fallback-Modell weiterhin wirksam sind:

  • --mcp-config und --strict-mcp-config
  • --settings
  • --setting-sources
  • --add-dir
  • --plugin-dir
  • --fallback-model
  • --allow-dangerously-skip-permissions

Verzeichnisse, die Sie während der Sitzung mit /add-dir hinzugefügt haben, werden ebenfalls übertragen. Das Übertragen von --allow-dangerously-skip-permissions hält bypassPermissions in der versendeten Sitzung erreichbar, gewährt aber nichts Neues: Der Modus erfordert immer noch die gleiche einmalige interaktive Akzeptanz, die in Berechtigungsmodus, Modell und Aufwand beschrieben ist.

Aus Ihrer Shell

Übergeben Sie --bg oder seine lange Form --background, um eine Sitzung zu starten, die direkt in den Hintergrund geht:

claude --bg "investigate the flaky SettingsChangeDetector test"

Die Eingabeaufforderung ist das Positionsargument, nicht ein -p-Wert. Claude Code lehnt --bg kombiniert mit -p oder --print ab, bevor eine Sitzung erstellt wird, da --print niemals die interaktive Sitzung startet, an die claude agents anhängt.

Wenn Sie claude --bg aus einem Terminal in einem Verzeichnis ausführen, das Sie nicht vertraut haben, wird der Workspace-Vertrauensdialog zuerst angezeigt und die Sitzung startet, sobald Sie akzeptieren. Wenn Sie ablehnen, wird Claude Code beendet, ohne eine Sitzung zu starten. Wo kein Dialog angezeigt werden kann, z. B. in einem Skript, wird der Befehl stattdessen mit einem Workspace not trusted-Fehler beendet.

Um einen bestimmten Subagenten, den Sie definiert haben, wie einen code-reviewer, als Hauptagent der Sitzung auszuführen, kombinieren Sie --bg mit --agent:

claude --agent code-reviewer --bg "address review comments on PR 1234"

Wenn der Name keinem Ihrer Subagenten entspricht, schlägt der Start fehl: Claude Code druckt eine no agent named-Warnung und meldet die Sitzung immer noch als versendet, aber die Sitzung wird sofort mit einem --agent '<name>' not found-Fehler beendet.

Wenn die versendete Sitzung später fortgesetzt oder neu gestartet wird, stellt Claude Code den Agenten und seine Tool-Einschränkungen wieder her; für seinen System-Prompt siehe System-Prompt-Flags in fortgesetzten Gesprächen. Es sucht zuerst im Sitzungsverzeichnis nach dem Agenten, sofern Sie diesen Arbeitsbereich vertraut haben, sodass ein projektbezogener Agent immer noch geladen wird, wenn die Sitzung aus einem anderen Verzeichnis fortgesetzt wird. Wenn der Agent nicht mehr existiert, wird die Sitzung mit den Standard-Tools fortgesetzt und sein Transkript öffnet sich mit einer Warnung, die den Agenten benennt.

Um ein vorhandenes Gespräch im Hintergrund fortzusetzen, übergeben Sie seine vollständige Sitzungs-ID mit --resume:

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

Auf Claude Code v2.1.257 oder später setzt Claude Code diese Sitzung entweder unter der gleichen ID fort oder startet eine Kopie unter einer neuen ID und druckt eine note:-Zeile, die erklärt, warum es nicht an Ort und Stelle fortgesetzt werden konnte. Wenn die Sitzung an Ort und Stelle fortgesetzt wird, zeigt claude agents eine Zeile dafür an.

Wenn Sie --bg mit --continue, einem bloßen --resume oder --resume mit einem Namen oder Dateipfad kombinieren, startet Claude Code immer eine solche Kopie. Fügen Sie --fork-session hinzu, um absichtlich eine Kopie zu starten, ohne die Notiz.

Übergeben Sie --name, um den Anzeigenamen der Sitzung in der Agenten-Ansicht anstelle des automatisch generierten festzulegen:

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

Nach dem Versenden druckt Claude die kurze ID der Sitzung und die Befehle zu ihrer Verwaltung. Wenn der Service, der Hintergrund-Sitzungen hostet, noch nicht läuft, kann --bg zuerst Starting background service… über dieser Ausgabe drucken. Wenn Sie --name übergeben, wird der Name nach der kurzen ID angezeigt:

backgrounded · 7c5dcf5d · flaky-test-fix
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

Einen Shell-Befehl ausführen

Um einen Shell-Befehl als Hintergrund-Job anstelle einer Claude-Sitzung auszuführen, übergeben Sie --exec. Das folgende Beispiel führt pytest -x als Hintergrund-Job aus:

claude --bg --exec 'pytest -x'

Aus der Agenten-Ansicht versenden Sie die gleiche Art von Job, indem Sie ! als erstes Zeichen der Versand-Eingabe eingeben: Das ! wird als Präfix angezeigt, alles danach ist der Befehl, und Enter startet den Job.

Der Befehl wird als PTY-gestützter Job ausgeführt und wird als Zeile in der Agenten-Ansicht angezeigt, mit der neuesten Ausgabezeile als Status. Ein Shell-Job führt den Befehl anstelle von Claude aus, sodass kein Modell aufgerufen wird und die Ausgabe nicht an eine Sitzung gesendet wird.

Um die Ausgabe zu sehen, hängen Sie an die Zeile an, drücken Sie Space, um einen Blick zu werfen, ohne anzuhängen, oder führen Sie claude logs <id> aus Ihrer Shell aus. Die erfasste Ausgabe bleibt im Speicher und wird nicht auf die Festplatte geschrieben. Die Zeile und ihre Ausgabe werden automatisch etwa fünf Minuten nach dem Beenden des Befehls bereinigt, daher lesen Sie sie vorher, wenn Sie das Ergebnis benötigen.

Wie Dateibearbeitungen isoliert werden

Jede Hintergrund-Sitzung, ob aus der Agenten-Ansicht, /bg oder claude --bg gestartet, beginnt in Ihrem Arbeitsverzeichnis. Bevor Dateien bearbeitet werden, verschiebt Claude die Sitzung in einen isolierten Git-Worktree unter .claude/worktrees/, sodass parallele Sitzungen denselben Checkout lesen können, aber jede in ihren eigenen schreibt. Sobald sich die Sitzung in ihrem Worktree befindet, erzwingt Claude Code Worktree-Isolation für die Sitzung und für alle Subagenten, die sie erzeugt.

Claude überspringt den Worktree, wenn:

  • Die Sitzung bereits in einem verknüpften Git-Worktree läuft, ob Claude ihn unter .claude/worktrees/ erstellt hat oder Sie ihn mit git worktree add anderswo erstellt haben
  • Die Datei, die Claude bearbeitet, sich in einem verknüpften Git-Worktree befindet, wie z. B. einer, den die Sitzung oder ihr Subagent mit git worktree add erstellt hat
  • Das Arbeitsverzeichnis kein Git-Repository ist und kein WorktreeCreate-Hook konfiguriert ist
  • Der Schreibvorgang außerhalb des Arbeitsverzeichnisses liegt

Um die Worktree-Isolation für ein Repository auszuschalten, in dem Git-Worktrees unpraktisch sind, setzen Sie worktree.bgIsolation auf "none". Hintergrund-Sitzungen bearbeiten dann Ihre Arbeitskopie direkt, ohne zuerst in einen Worktree zu wechseln. Fügen Sie die Einstellung zur .claude/settings.json des Projekts hinzu:

{
  "worktree": {
    "bgIsolation": "none"
  }
}

Außerhalb eines Git-Repositories schreiben Sitzungen direkt in das Arbeitsverzeichnis und sind nicht voneinander isoliert, daher vermeiden Sie das Versenden paralleler Sitzungen, die dieselben Dateien bearbeiten. Wenn Sie ein anderes Versionskontrollsystem verwenden, konfigurieren Sie einen WorktreeCreate-Hook und Claude isoliert Bearbeitungen auf die gleiche Weise wie für Git.

Wenn der Hook in einem Verzeichnis fehlschlägt, das kein Git-Repository ist, überspringt Claude die Isolation für dieses Verzeichnis und bearbeitet das Arbeitsverzeichnis an Ort und Stelle. Innerhalb eines Git-Repositories blockiert Claude Code Schreibvorgänge auf dem gemeinsamen Checkout, bis Claude die Sitzung in einen Worktree verschiebt.

Um den Worktree-Pfad einer Sitzung zu finden, schauen Sie sich die Sitzung an oder hängen Sie an und überprüfen Sie ihr Arbeitsverzeichnis.

Ein Subagent, den die Hintergrund-Sitzung erzeugt, erbt das Arbeitsverzeichnis der Sitzung, sodass seine Dateibearbeitungen im Worktree der Sitzung landen, anstatt in Ihrer Arbeitskopie. Um einem Subagenten stattdessen seinen eigenen separaten Worktree zu geben, setzen Sie isolation: worktree in seinem Frontmatter oder übergeben Sie isolation: "worktree" beim Erzeugen.

Wenn eine Hintergrund-Sitzung Code-Änderungen in einem Worktree vorgenommen hat, den Claude betreten hat, weist Claude Code Claude an, die Arbeit vor dem Beenden zu bewahren, damit sie überlebt, wenn Sie die Sitzung und ihren Worktree löschen:

  • Commit und Push: Claude committed ohne zu fragen und pusht den Branch, wenn das Repository ein Remote hat.
  • Entwurf-Pull-Request: Claude öffnet einen, wenn die Aufgabe es erfordert, und das #N-Label wird auf der Zeile angezeigt.
  • Niemals: Pushen zu main oder master, Force-Push und Merging.
  • Ihre Git-Anweisungen haben Vorrang: Wenn die Aufgabe, CLAUDE.md oder Memory sagt, dass Sie selbst Commits oder Pushes handhaben, lässt Claude Git für Sie.

Eine Sitzung, die einen Checkout bearbeitet, den sie nicht selbst isoliert hat, fragt immer noch, bevor sie committed oder Branches wechselt. Dies gilt, wenn Isolation auf "none" gesetzt ist, wenn der Worktree-Wechsel fehlgeschlagen ist, oder wenn die Sitzung in einem Worktree gestartet wurde, der bereits existierte.

Unabhängig von der Aufgabe endet Claude den Job mit einem Bericht, der sagt, was er getan hat und wo die Arbeit ist: ein Pfad, ein Branch, ein Pull Request oder die Antwort selbst.

Was das Löschen einer Sitzung entfernt

Löschen Sie eine Sitzung mit Ctrl+X zweimal in Agenten-Ansicht oder mit claude rm. Außer in den unten aufgeführten beibehaltenen Fällen wird die Sitzung aus der Liste entfernt. Ihr Transkript bleibt auf Ihrem Computer durch claude --resume erhalten, und die Entfernung überlebt Supervisor-Neustarts.

Was mit einem Worktree passiert, den Claude für die Sitzung erstellt hat:

  • Die Agenten-Ansicht entfernt ihn, einschließlich nicht committeter Änderungen, daher committen Sie zuerst, was Sie behalten möchten.

  • claude rm behält ihn zusammen mit der Sitzungszeile, wenn er nicht committete Änderungen hat.

  • Weder die Agenten-Ansicht noch claude rm entfernen einen Worktree, den eine andere laufende Sitzung verwendet oder gesperrt hat, und das Löschen erneut ändert das nicht. Claude Code behält den Worktree und die Sitzung, und benennt das beibehaltene Verzeichnis und den Grund; in der Agenten-Ansicht zeigt die Sitzungszeile not deleted. Schließen Sie die andere Sitzung, dann löschen Sie erneut.

  • Wenn Sie eine Sitzung löschen, deren Worktree Commits hat, die Claude Code nicht bestätigen kann, sind anderswo gespeichert, behält Claude Code den Worktree und die Sitzung, und die Nachricht benennt den Branch des Worktrees und wie viele Commits nicht gepusht sind. Die Nachricht bietet auch die zwei Wege nach vorne: Pushen Sie die Commits, oder löschen Sie erneut, um sie zu verwerfen.

    Commits auf einem Remote blockieren das Löschen nicht. Auch nicht Commits auf der lokalen Kopie des Standard-Branches Ihres origin-Remote, solange dieser Branch in Ihrem Haupt-Checkout ausgecheckt ist, dem Repository-Verzeichnis selbst, nicht einem Worktree.

    Nach dieser Ablehnung wählen Sie:

    • Um die Commits zu behalten, pushen Sie sie, oder mergen Sie sie in diesen Standard-Branch, dann löschen Sie die Sitzung erneut.
    • Um sie zu verwerfen, löschen Sie die Sitzung erneut ohne zu pushen: Drücken Sie Ctrl+X zweimal auf ihrer Zeile in der Agenten-Ansicht, oder führen Sie den claude rm <id> --discard-unpushed-Befehl aus, den die Ablehnung druckte. Dies entfernt die Sitzung und den Worktree zusammen mit seinem Branch, verwirft die nicht gepushten Commits und alle nicht committeten Änderungen.

    Wenn Sie erneut löschen, verwirft Claude Code nur, was die Ablehnung zeigte: Wenn der Worktree einen Commit gewonnen hat, behält Claude Code ihn erneut und zeigt den aktualisierten Zustand.

    Wenn die Aufzeichnungen einer anderen abgeschlossenen Sitzung auch den Worktree benennen, bleibt er, wenn Sie erneut löschen; pushen Sie die Commits, dann löschen Sie erneut.

  • Ein Worktree, den Git nicht mehr erkennt, z. B. nach git worktree prune, blockiert das Löschen nicht. Claude Code löscht die Sitzung und lässt das Verzeichnis auf der Festplatte.

  • Wenn Git oder Ihr WorktreeRemove-Hook fehlschlägt, den Worktree zu entfernen, behält Claude Code den Worktree und die Sitzung, und die Nachricht benennt die Ursache. Für einen Hook sagt die Nachricht, wie er endete, z. B. exited 1, und zitiert den Anfang seines stderr. Die Nachricht sagt Ihnen auch, welche dieser Aktionen Sie als nächstes tun sollten:

    • Löschen Sie die Sitzung erneut, um das Verzeichnis trotzdem zu entfernen, indem Sie Ctrl+X zweimal auf ihrer Zeile in der Agenten-Ansicht drücken oder den claude rm <id> --force-remove-worktree <worktree-id>-Befehl ausführen, den die claude rm-Ablehnung druckte. Der Worktree's Branch bleibt im Repository.

      Claude Code bietet dies nur an, wenn es bestätigen kann, dass alle folgenden Bedingungen erfüllt sind:

      • Das Verzeichnis ist einer der verknüpften Worktrees des Repositories unter .claude/worktrees/
      • Weder der Worktree noch ein ausgechecktes Submodul hat nicht committete Änderungen an verfolgten Dateien
      • Keine andere Sitzung's Aufzeichnung benennt ihn

      Wenn Claude Code den Zustand eines Submodul-Checkouts nicht überprüfen kann, z. B. einen, der durch ein separates Git-Repository ersetzt wurde, bietet es dies auch nicht an.

    • Beheben Sie, was im Weg steht, z. B. indem Sie nicht committete Änderungen committen oder stashen, ein separates Git-Repository aus dem Worktree verschieben, schließen Sie, was das Verzeichnis verwendet, oder beheben Sie den Hook, dann löschen Sie die Sitzung erneut.

    • Entfernen Sie das Verzeichnis selbst, dann löschen Sie die Sitzung erneut.

Ein Worktree, den Sie selbst erstellt haben und in dem Sie die Sitzung gestartet haben, wird in jedem Fall beibehalten.

Eine Sitzung, deren Worktree-Verzeichnis zu keinem Git-Repository gehört, weil das Repository gelöscht wurde oder ein WorktreeCreate-Hook das Verzeichnis anderswo erstellt hat, kann immer noch gelöscht werden. Während Dateien im Verzeichnis verbleiben:

  • Die Agenten-Ansicht fragt nach der gleichen Ctrl+X-Doppeldruckbestätigung, bevor sie verworfen werden. Für ein Hook-erstelltes Verzeichnis führt es stattdessen Ihren WorktreeRemove-Hook aus, und ohne einen lehnt es das Löschen ab und behält die Sitzung.
  • claude rm behält die Sitzung und den Worktree, und benennt den Grund.

Jeder Pfad behält ein Verzeichnis, das die Aufzeichnungen einer anderen abgeschlossenen Sitzung benennen.

Das Modell festlegen

Der im Header der Agenten-Ansicht angezeigte Modellname ist der Versand-Standard. Neue Sitzungen, die Sie aus der Eingabe starten, verwenden dieses Modell, das aus der model-Einstellung in Ihren Benutzereinstellungen stammt. Legen Sie es fest, indem Sie ein Modell in der /model-Auswahl auswählen, oder bearbeiten Sie die Einstellung direkt.

Um es für die gesamte Agenten-Ansicht-Sitzung zu überschreiben, übergeben Sie --model beim Öffnen der Agenten-Ansicht. Siehe Berechtigungsmodus, Modell und Aufwand.

Um den Versand-Standard aus der Agenten-Ansicht zu ändern, geben Sie /model gefolgt von einem Modellnamen in die Versand-Eingabe ein und drücken Sie Enter. Der Header wird aktualisiert, um dieses Modell mit einem (session)-Marker anzuzeigen, und Sitzungen, die Sie danach versenden, verwenden es. Geben Sie /model default ein, um die Überschreibung zu löschen und zum Versand-Standard zurückzukehren. Diese Überschreibung gilt für den Rest des aktuellen claude agents-Laufs und schreibt nicht in Ihre Einstellungsdatei. Das folgende Beispiel versendet eine Sitzung auf Opus und die nächste auf Sonnet:

/model opus
refactor auth
/model sonnet
run the test suite

Jede Hintergrund-Sitzung kann auf einem anderen Modell ausgeführt werden. Um es für eine Sitzung zu überschreiben:

  • Übergeben Sie in der Shell --model mit claude --bg.
  • Hängen Sie an eine laufende Sitzung an und führen Sie /model aus, um zu wechseln: Eine Auswahl aus der Auswahl oder ein eingegebenes /model <name> wird als Standard für neue Sitzungen gespeichert, es sei denn, Sie drücken s in der Auswahl für einen Wechsel nur für diese Sitzung. Ein Wechsel nur für diese Sitzung bleibt bestehen, wenn die Sitzung neu gestartet wird.
  • Versenden Sie einen Subagenten, dessen Frontmatter ein model-Feld setzt.

Berechtigungsmodus, Modell und Aufwand

Eine Hintergrund-Sitzung nimmt ihre Einstellungen, ihren Provider, ihren Berechtigungsmodus, ihr Modell und ihren Aufwand von dort, wo und wie Sie sie versendet haben. Die folgenden Unterabschnitte behandeln jede Quelle und was bestehen bleibt, wenn der Supervisor die Sitzung neu startet.

Einstellungen und Provider

Eine Hintergrund-Sitzung liest ihre Einstellungen aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie claude dort mit den Konfigurationsflags, die sie trägt gestartet hätten. Dies umfasst env-Werte in Projekteinstellungen, sodass ein dort gesetzter ANTHROPIC_MODEL oder Provider-Variable auf jede Hintergrund-Sitzung in diesem Verzeichnis angewendet wird.

Eine Hintergrund-Sitzung läuft auch mit dem PATH der Shell, von der Sie sie versendet haben, sodass die Befehle, die sie ausführt, die gleichen Tools finden wie Ihr Terminal. Sie behält auch die Cloud-Provider-Auswahl dieser Shell, wie CLAUDE_CODE_USE_BEDROCK oder CLAUDE_CODE_USE_VERTEX, zusammen mit ihren ANTHROPIC_DEFAULT_*_MODEL-Aliasen und jeder CLAUDE_CODE_EXTRA_BODY-Überschreibung, die Sie dort exportiert haben.

LLM-Gateway

Wenn Sie Claude Code durch ein LLM-Gateway leiten, setzen Sie die Gateway-Variablen in einen Einstellungsdatei-env-Block, anstatt sie in Ihrer Shell zu exportieren, und Hintergrund-Sitzungen lesen sie zusammen mit dem Rest ihrer Einstellungen. In einer Einstellungsdatei setzen zeigt den Block und welche Einstellungsdatei für die Anmeldedaten verwendet werden soll.

Wenn Sie ein Gateway-ANTHROPIC_BASE_URL nur in Ihrer Shell exportieren, erreicht es eine Hintergrund-Sitzung zusammen mit dem ANTHROPIC_CUSTOM_HEADERS und der Anmeldedaten, die Sie damit exportiert haben, nur wenn der Supervisor selbst aus einer Shell gestartet wurde, die das gleiche Gateway exportiert, und nur in diesen Fällen:

  • Sie verschieben Ihre eigene Sitzung mit ← oder /background in den Hintergrund
  • Sie versenden eine Sitzung in das Verzeichnis, in dem Sie sich befinden
  • Sie wecken eine gestoppte Sitzung in dem Verzeichnis, in dem Sie sich befinden, auf, indem Sie sie anhängen oder darauf antworten

Claude Code leitet ein Gateway vor einem Cloud-Provider weiter. Wenn die Shell, von der Sie versenden, den Provider auswählt und seinen Gateway-Endpunkt mit seinem Auth-Bypass-Flag exportiert, leitet Claude Code das Endpunkt-und-Flag-Paar unter den Bedingungen, die für ANTHROPIC_BASE_URL gelten, zusammen mit ANTHROPIC_CUSTOM_HEADERS an die Sitzung weiter. Exportieren Sie beispielsweise CLAUDE_CODE_USE_VERTEX=1 mit ANTHROPIC_VERTEX_BASE_URL und CLAUDE_CODE_SKIP_VERTEX_AUTH=1, und Claude Code leitet diesen Endpunkt und dieses Flag weiter.

Claude Code wendet ein weitergeleitetes Gateway nur auf den laufenden Prozess dieser Sitzung an und schreibt es niemals auf die Festplatte.

Berechtigungsmodus

Der Berechtigungsmodus hängt davon ab, wie Sie die Sitzung gestartet haben:

  • Mit /bg oder ← in den Hintergrund verschoben: Claude Code behält den Berechtigungsmodus, in dem sich die Sitzung befand, daher bleibt eine Sitzung, die Sie zu acceptEdits oder auto gewechselt haben, nach dem Trennen in diesem Modus
  • Aus einer Agenten-Ansicht versendet, die Sie mit ← geöffnet haben: Die Konfiguration des Ziels kommt zuerst, und der Berechtigungsmodus der Sitzung, von der Sie kamen, gilt, wenn nichts anderes einen setzt
  • Aus claude agents versendet, das in einer Shell gestartet wurde, oder mit claude --bg: Die neue Sitzung startet so, wie eine neue claude-Sitzung in diesem Verzeichnis würde, es sei denn, Sie haben sie aus einer Agenten-Ansicht versendet, die Sie mit Versand-Standardwerten geöffnet haben. Welcher Berechtigungsmodus eine Sitzung startet listet die Reihenfolge auf

Für eine Sitzung, die Sie aus einer Agenten-Ansicht versenden, die Sie mit ← geöffnet haben, nimmt Claude Code den Berechtigungsmodus aus dem ersten dieser Punkte, der zutrifft:

  1. Der permissions.defaultMode des Zielverzeichnisses. Zwei Quellregeln gelten:
  2. Der Berechtigungsmodus der Sitzung, von der Sie kamen

Wenn Claude Code einen Modus einer Quelle als zu permissiv ablehnt, entscheidet die nächste Quelle in der Liste. Wenn Sie beispielsweise aus einer Plan-Modus-Sitzung in ein Verzeichnis versenden, dessen eingecheckten Einstellungen acceptEdits anfordern, startet die neue Sitzung im Plan-Modus. Wenn Sie diesen defaultMode zu ~/.claude/settings.json verschieben, gilt er unabhängig vom Berechtigungsmodus der Sitzung, von der Sie kamen.

Permissivität läuft Plan, dann Manual und dontAsk, dann acceptEdits und auto, die jeweils als permissiver als die andere zählen, dann bypassPermissions.

Versand-Standardwerte

Um Standardwerte für jede Sitzung festzulegen, die Sie aus der Agenten-Ansicht versenden, übergeben Sie eines der folgenden Elemente beim Öffnen: --permission-mode, --model, --effort oder --agent:

claude agents --permission-mode plan --model opus --effort high

--effort akzeptiert hier die gleichen Werte wie das Top-Level---effort-Flag, einschließlich ultracode.

--agent setzt den Subagenten, der verwendet wird, wenn eine Versand-Eingabeaufforderung keinen benennt, entweder mit @name oder als erstes Wort. Es wird standardmäßig auf die agent-Einstellung gesetzt, wenn eine gesetzt ist, ansonsten auf den integrierten Catch-All-claude-Agent. Das Benennen eines Subagenten in der Versand-Eingabe überschreibt beide.

claude agents akzeptiert auch --dangerously-skip-permissions als Kurzform für --permission-mode bypassPermissions und --allow-dangerously-skip-permissions, um bypassPermissions in jedem versendeten Sitzungs-Shift+Tab-Zyklus verfügbar zu machen, ohne in diesem Modus zu starten. Beide entsprechen den Top-Level-CLI-Flags.

Übergeben Sie --restricted, um jede Sitzung, die Sie aus der Ansicht versenden, im eingeschränkten Modus zu starten, als ob jede mit dem Top-Level---restricted-Flag gestartet würde. Erfordert Claude Code v2.1.248 oder später.

Die aktiven Standardwerte werden in der Fußzeile unter der Versand-Eingabe angezeigt.

Claude Code lehnt claude --bg --permission-mode bypassPermissions ab, bis Sie den Bypass-Haftungsausschluss akzeptiert haben, indem Sie claude --dangerously-skip-permissions einmal interaktiv ausführen, da dieser Modus einer Sitzung, die Sie nicht beobachten, erlaubt, ohne Genehmigung zu handeln. Das Übergeben von --dangerously-skip-permissions oder --permission-mode bypassPermissions an claude agents zeigt denselben Haftungsausschluss an, wenn Sie ihn noch nicht akzeptiert haben, und das Akzeptieren wendet bypassPermissions auf die Sitzungen an, die Sie aus der Ansicht starten. Das Übergeben von --allow-dangerously-skip-permissions zeigt denselben Haftungsausschluss auch an, und das Akzeptieren macht bypassPermissions im Shift+Tab-Zyklus dieser Sitzungen verfügbar, ohne sie darin zu starten.

Was über Neustarts hinweg bestehen bleibt

Der Berechtigungsmodus, das Modell und der Aufwand, die Sie für eine Hintergrund-Sitzung gewählt haben, zusammen mit den Konfigurationsflags, die sie trägt, bleiben alle bestehen, wenn der Supervisor später seinen Prozess stoppt und neu startet. Eine Sitzung, die Sie mit claude --bg --dangerously-skip-permissions oder claude --bg --permission-mode bypassPermissions gestartet haben, bleibt nach diesem Neustart in bypassPermissions. Ein Modell oder Aufwand, den Sie während der Sitzung mit /model oder /effort geändert haben, wird ebenfalls beibehalten.

Wenn die Sitzung ihren Aufwand aus Ihren Einstellungen statt aus --effort oder /effort genommen hat, liest Claude Code Ihre Einstellungen jedes Mal neu, wenn es einen Prozess für die Sitzung startet. Wenn Sie also den gespeicherten Aufwand in settings.json bearbeiten, erreicht die Änderung Sitzungen, die Sie mit ← oder /bg in den Hintergrund verschieben, und ihre späteren Neustarts. Der gespeicherte Aufwand ist der effortLevel-Schlüssel oder ein modelSettings-Eintrag.

Claude Code behält auch einen Namen, den Sie mit /rename oder Ctrl+R festgelegt haben, über diesen Neustart hinweg, sodass Sie immer noch claude --resume <name> ausführen können, um die Sitzung zu erreichen.

Ein Prompt, den Sie mit Ctrl+S während des Anhängens verstaut haben, wird auch mit der Sitzung beibehalten. Öffnen Sie die Sitzung erneut, nachdem ihr Prozess gestoppt oder neu gestartet wurde, und Ctrl+S stellt den verstaut Text wieder her. Eingefügter Inhalt im Verstau überlebt den Neustart nicht.

Einstellungen, Plugins und MCP-Server

Die Agenten-Ansicht akzeptiert die gleichen Konfigurationsflags wie claude zum Laden von Einstellungen, Plugins, MCP-Servern und zusätzlichen Verzeichnissen. Die Agenten-Ansicht wendet --settings, --setting-sources und --plugin-dir auf sich selbst an und leitet jeden Konfigurationsflags an jede Sitzung weiter, die Sie daraus versenden, sodass ein Plugin oder MCP-Server, den Sie auf diese Weise laden, auch in diesen Sitzungen verfügbar ist.

Flag Effekt
--settings <file-or-json> Einstellungen für Agenten-Ansicht und versendete Sitzungen überschreiben
--setting-sources <sources> Nur die benannten Einstellungsquellen laden, in Agenten-Ansicht und versendeten Sitzungen
--add-dir <path> Dateizugriff auf ein zusätzliches Verzeichnis gewähren
--plugin-dir <path> Ein Plugin aus einem lokalen Verzeichnis laden
--mcp-config <file-or-json> MCP-Server aus einer Konfigurationsdatei oder JSON-Zeichenkette laden
--strict-mcp-config Nur die MCP-Server aus --mcp-config verwenden, andere MCP-Konfigurationen ignorieren. Siehe Exklusive Kontrolle mit managed-mcp.json, um zu erfahren, was das Flag unter einer verwalteten MCP-Datei tut

Wiederholen Sie --add-dir, --plugin-dir oder --mcp-config einmal pro Wert. claude agents unterstützt die durch Leerzeichen getrennte Form nicht, wie --add-dir a b c.

Sie können --settings, --setting-sources und --plugin-dir vor oder nach agents platzieren. Halten Sie --add-dir und --mcp-config nach agents: Wenn Sie eines davon vor agents platzieren, schlägt claude agents --json mit einem unknown option-Fehler fehl.

Das folgende Beispiel öffnet die Agenten-Ansicht mit einer Einstellungsüberschreibung und einem zusätzlichen Verzeichnis:

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

--settings akzeptiert einen Dateipfad oder eine Inline-JSON-Zeichenkette. Ein Dateipfad muss auf eine vorhandene Datei verweisen; Claude Code wird mit einem Settings file not found-Fehler beendet, wenn dies nicht der Fall ist.

Sitzungen aus der Shell verwalten

Jede Hintergrund-Sitzung hat eine kurze ID, die Sie aus der Shell verwenden können. Die ID wird gedruckt, wenn Sie eine Sitzung mit claude --bg starten, und die ID jeder Sitzung ist ihr Verzeichnisname unter ~/.claude/jobs/. Diese Befehle sind nützlich zum Scripting oder wenn Sie die Agenten-Ansicht nicht öffnen möchten.

Befehl Zweck
claude agents Agenten-Ansicht öffnen
claude agents --cwd <path> Agenten-Ansicht auf Sitzungen beschränken, die unter <path> gestartet wurden
claude agents --json Sitzungen als JSON-Array drucken und beenden. Siehe Sitzungen als JSON auflisten
claude attach <id> An eine Sitzung in diesem Terminal anhängen
claude logs <id> Neueste Ausgabe der Sitzung drucken
claude stop <id> Eine Sitzung stoppen. Akzeptiert auch claude kill
claude respawn <id> Eine Sitzung neu starten (laufend oder gestoppt), z. B. um eine aktualisierte Claude Code-Binärdatei zu verwenden. Die neu gestartete Sitzung setzt ihr gespeichertes Gespräch fort; wenn keines auf der Festplatte vorhanden ist, führt sie ihre ursprüngliche Eingabeaufforderung erneut als neues Gespräch aus
claude respawn --all Jede laufende Sitzung neu starten, z. B. um alle Sitzungen auf einmal auf eine aktualisierte Claude Code-Binärdatei zu verschieben
claude rm <id> Eine Sitzung aus der Liste entfernen, zusammen mit einem Worktree, den Claude dafür erstellt hat, wenn es sicher zu löschen ist; siehe Was das Löschen einer Sitzung entfernt. Das Gesprächstranskript bleibt auf Ihrem lokalen Computer und bleibt über claude --resume verfügbar
claude rm <id> --discard-unpushed <commit>@<worktree-id> Eine Sitzung löschen, deren Löschung wegen nicht gepushter Commits abgelehnt wurde, und dabei den Worktree zusammen mit seinem Branch und seinen Commits verwerfen. Übergeben Sie den genauen Wert, den die Ablehnung gedruckt hat; siehe Was das Löschen einer Sitzung entfernt. Erfordert v2.1.260 oder später
claude rm <id> --force-remove-worktree <worktree-id> Eine Sitzung löschen, deren Löschung abgelehnt wurde, weil git oder der WorktreeRemove-Hook seinen Worktree nicht entfernen konnte, und dabei das Worktree-Verzeichnis trotzdem löschen und seinen Branch im Repository belassen. Übergeben Sie den genauen Wert, den die Ablehnung gedruckt hat; siehe Was das Löschen einer Sitzung entfernt. Erfordert v2.1.268 oder später
claude daemon status Den Status des Supervisors, die Version, das Socket-Verzeichnis und die Anzahl der Worker drucken
claude daemon stop --any Den Supervisor-Prozess und die Hintergrund-Sitzungen, die er hostet, stoppen. Übergeben Sie --keep-workers, um Hintergrund-Sitzungen laufen zu lassen, damit der nächste Supervisor sich mit ihnen verbinden kann. Der nächste claude agents oder claude --bg startet einen neuen Supervisor

Sitzungen als JSON auflisten

claude agents --json druckt aktive Sitzungen als JSON-Array und beendet: jede Live-Sitzung sowie Hintergrund-Sitzungen, die noch arbeiten oder blockiert sind, auch wenn ihr Prozess beendet wurde. Fügen Sie --all hinzu, um auch abgeschlossene Hintergrund-Sitzungen einzubeziehen, und --cwd <path>, um die Liste auf Sitzungen zu beschränken, die unter diesem Verzeichnis gestartet wurden.

Jeder Eintrag beschreibt eine Sitzung:

Feld Vorhanden Beschreibung
cwd, kind, startedAt Immer Das Arbeitsverzeichnis, interactive oder background, und die Startzeit in Unix-Millisekunden
id Hintergrund-Sitzungen Kurze ID, verwendbar mit claude attach, claude logs und claude stop
state Hintergrund-Sitzungen Einer von working, blocked, done, failed oder stopped. Siehe Sitzungsstatus aus einem Skript lesen, um zu erfahren, was jeder Wert bedeutet
pid, status Während der Prozess aktiv ist Prozess-ID und einer von busy, waiting oder idle
waitingFor Wenn status waiting ist Worauf die Sitzung blockiert ist: permission prompt für eine Genehmigung, input needed für eine Frage von Claude oder eine Eingabeanforderung eines MCP-Servers, sandbox request, worker request oder dialog open
sessionId, name Wenn gesetzt sessionId ist die vollständige Sitzungs-UUID, verwendbar mit claude --resume. Der name einer interaktiven Sitzung ist ihr Standard-Anzeigename, bis Sie die Sitzung benennen oder einen Plan darin akzeptieren

Sitzungsstatus aus einem Skript lesen

claude agents --json ist die unterstützte Methode, um Sitzungsstatus von außerhalb von Claude Code zu lesen, beispielsweise aus einer Statusleiste, einem Scheduler oder einer anderen Claude-Sitzung, die Hintergrundarbeit überwacht. Fragen Sie claude agents --json --all ab, das weiterhin Sitzungen auflistet, deren Prozess beendet wurde, und lesen Sie den state, status und waitingFor jedes Eintrags.

state Was es bedeutet
working Ein Turn wird ausgeführt, oder die Sitzung befindet sich zwischen Schritten der Arbeit, die sie selbst antreibt, wie z. B. eine /loop-Iteration oder ein Warten auf CI. status teilt Ihnen mit, ob sein Prozess gerade busy ist
blocked Die Sitzung wartet auf Sie: eine Frage, die sie gestellt hat, eine Genehmigung oder Sandbox-Entscheidung, ein Fehler, den nur Sie beheben können, wie z. B. ein abgelaufener Login, oder ihre erste Eingabeaufforderung, wenn Sie sie ohne eine gestartet haben. Wenn das Warten eine offene Eingabeaufforderung in einem Live-Prozess ist, benennt waitingFor sie
done Der letzte Turn hat beendet, was Sie gefragt haben, und die Sitzung ist bereit für Ihre nächste Eingabeaufforderung, unabhängig davon, ob sein Prozess noch aktiv ist oder nicht
failed, stopped Die Aufgabe endete mit einem Fehler, oder die Sitzung wurde gestoppt

Eine Sitzung, die ihren Turn beendet hat und auf Ihre nächste Anweisung wartet, liest done, nicht blocked. blocked bedeutet immer, dass die Sitzung etwas von Ihnen benötigt, bevor sie fortfahren kann.

Die Dateien unter ~/.claude/jobs/<id>/ sind keine stabile Schnittstelle. Werte, die eine Sitzung oder ein anderes Programm in state, detail, tempo oder needs schreibt, werden beim nächsten Update ersetzt.

Wenn Sie möchten, dass eine Sitzung Fortschritt in ihren eigenen Worten meldet, lassen Sie sie eine eigene Datei schreiben, beispielsweise unter $CLAUDE_JOB_DIR/tmp, anstatt state.json zu bearbeiten.

Wie Hintergrund-Sitzungen gehostet werden

Claude Code behandelt jede Sitzung, die in der Agenten-Ansicht aufgelistet ist, als Hintergrund-Sitzung, unabhängig davon, ob Sie derzeit daran angehängt sind oder nicht. Im Gegensatz dazu ist eine Sitzung, die durch direktes Ausführen von claude gestartet wird, an dieses Terminal gebunden und endet, wenn es geschlossen wird, es sei denn, Sie senden sie in den Hintergrund.

Um zu überprüfen, welche Art von Sitzung Sie verwenden, führen Sie /status aus. Die Zeile Session kind zeigt background job · attached oder background job · unattended in einer Hintergrund-Sitzung an, je nachdem, ob ein Terminal angehängt ist, und interactive in jeder anderen Sitzung.

Der Supervisor-Prozess

Der Supervisor ist ein Hintergrund-Dienst, der Ihre Hintergrund-Sitzungen ausführt, damit sie weiterarbeiten, nachdem Sie die Agenten-Ansicht oder Ihr Terminal geschlossen haben. Claude Code startet ihn beim ersten Mal, wenn Sie eine Sitzung in den Hintergrund verschieben oder die Agenten-Ansicht öffnen, und Sie müssen ihn nicht selbst verwalten.

Jede Sitzung ist ihr eigener Claude Code-Prozess unter dem Supervisor, und was mit diesem Prozess geschieht, hängt vom Status der Sitzung ab:

  • Funktioniert, wartet auf eine Berechtigung oder einen anderen Dialog oder ist angehängt: Der Prozess läuft weiter. Ein laufender Subagent, Workflow oder Monitor zählt als funktionierend.
  • Fertig oder wartet auf Ihre nächste Nachricht und unverbunden für etwa eine Stunde: Der Supervisor stoppt den Prozess, um Ressourcen freizugeben. Eine Sitzung, die ihren Zug beendet hat, indem sie Ihnen eine Frage gestellt hat, zählt als Warten auf Ihre nächste Nachricht. Das Gespräch bleibt auf der Festplatte, und das nächste Mal, wenn Sie anhängen oder antworten, wird die Sitzung fortgesetzt. Heften Sie eine Sitzung mit Ctrl+T an, um ihren Prozess im Leerlauf am Laufen zu halten.
  • Unerwartet beendet, während der Supervisor läuft: Der Supervisor startet den Prozess neu. Das Beenden einer Sitzung, die Sie selbst mit ← oder /background in den Hintergrund verschoben haben, beispielsweise mit kill, markiert sie als gestoppt statt neu gestartet. Für Sitzungen, die mit einem Herunterfahren beendet wurden, siehe Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt.
  • Nach einem automatischen Update: Der Supervisor startet sich selbst in der neuen Version neu und verschiebt untätige Sitzungen im Hintergrund. Sitzungen, die funktionieren, auf Sie warten oder angehängt sind, werden nicht unterbrochen.

Wenn ein Sitzungsprozess stoppt oder neu gestartet wird, werden die Hintergrund-Shell-Befehle, dynamischen Workflows und Hintergrund-Subagenten, die Claude darin gestartet hat, in seinen nächsten Prozess übernommen; laufende Monitore und Shell-Befehle, die ein Subagent gestartet hat, stoppen mit dem Prozess. Das Löschen der Sitzung stoppt alles, das sie übernommen hat. Um alle Hintergrund-Arbeiten der Sitzung mit dem Prozess zu stoppen, anstatt sie zu übernehmen, setzen Sie CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF auf 1.

Der Supervisor und seine Sitzungen authentifizieren sich mit denselben gespeicherten Anmeldedaten wie Ihre interaktiven Sitzungen. Welche Einstellungen und Shell-Variablen eine Sitzung erreichen, einschließlich PATH, finden Sie unter Einstellungen und Anbieter. Für Gateway-Endpunkte siehe LLM-Gateway.

Wo der Status gespeichert ist

Der Sitzungsstatus wird unter Ihrem Claude Code-Konfigurationsverzeichnis gespeichert. Wenn Sie CLAUDE_CONFIG_DIR setzen, verwendet der Supervisor stattdessen dieses Verzeichnis und läuft als separate Instanz mit ihren eigenen Sitzungen.

Pfad Inhalt
~/.claude/daemon.log Supervisor-Protokoll
~/.claude/daemon/roster.json Liste der laufenden Hintergrund-Sitzungen, verwendet zum Wiederherstellen der Verbindung nach einem Neustart
~/.claude/jobs/<id>/state.json Pro-Sitzungs-Status in der Agenten-Ansicht angezeigt. Lesen Sie ihn über claude agents --json statt die Datei zu analysieren
~/.claude/jobs/<id>/tmp/ Pro-Sitzungs-Scratch-Verzeichnis. Clauds Write- und Edit-Aufrufe hier erfordern keine Berechtigung. Wird entfernt, wenn die Sitzung gelöscht wird

Jede Hintergrund-Sitzung hat die Umgebungsvariable CLAUDE_JOB_DIR auf ihr ~/.claude/jobs/<id>-Verzeichnis gesetzt, daher können Shell-Befehle, die die Sitzung ausführt, temporäre Dateien in $CLAUDE_JOB_DIR/tmp schreiben, ohne mit parallelen Sitzungen zu kollidieren.

Um diesen Status zu überprüfen, ohne die Dateien direkt zu lesen, führen Sie claude daemon status aus. Es meldet, ob der Supervisor erreichbar ist, seine Prozess-ID und Version, das Socket-Verzeichnis und wie viele Hintergrund-Sitzungen aktiv sind.

Der Befehl warnt auch, wenn der laufende Supervisor eine andere Version hat als der claude, den Sie aufgerufen haben, was nach einem Update geschieht, das der Supervisor noch nicht neu gestartet hat. Die Warnung zeigt beide Versionen an und teilt Ihnen mit, dass Sie claude daemon stop --any ausführen sollen, um die neue Version zu übernehmen. Wenn Claude Code als Betriebssystem-Dienst installiert ist, ist der vorgeschlagene Befehl claude daemon stop ohne das Flag.

Sitzungen bleiben bei diesem Versionskonflikt intakt: Eine ältere Claude Code-Version, die die state.json einer Sitzung aktualisiert, behält Felder, die sie nicht erkennt, und behält die Sitzung in der Liste. Die Sitzungsliste in roster.json folgt derselben Regel, daher bleiben Sitzungen, die von der neueren Version gestartet wurden, erreichbar und akzeptieren weiterhin Eingaben, nachdem der Supervisor neu gestartet wird.

Agenten-Ansicht ausschalten

Um Hintergrund-Agenten und die Agenten-Ansicht vollständig auszuschalten, setzen Sie die Einstellung disableAgentView setting auf true oder setzen Sie die Umgebungsvariable CLAUDE_CODE_DISABLE_AGENT_VIEW. Administratoren können dies durch verwaltete Einstellungen erzwingen.

Fehlerbehebung

`claude agents` listet Subagenten auf, anstatt die Agenten-Ansicht zu öffnen

Wenn claude agents eine Anzahl gefolgt von Ihren konfigurierten Subagenten ausgibt und dann beendet wird, ist die Agenten-Ansicht in Ihrer Umgebung nicht verfügbar. Führen Sie claude update aus, um die neueste Version zu installieren.

Wenn die Agenten-Ansicht nach dem Update immer noch nicht geöffnet wird, überprüfen Sie, ob sie durch eine Einstellung oder Umgebungsvariable deaktiviert wurde.

Agenten-Ansicht öffnet sich ohne Sitzungen

Bevor Sie Ihre erste Sitzung versenden, zeigt die Agenten-Ansicht die leeren Abschnittskopfzeilen mit einer Beschreibung unter jedem sowie eine einzeilige Erklärung über der Eingabe anstelle der Sitzungsliste. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie Enter, um Ihre erste Sitzung zu versenden.

Backgrounding zeigt einen `Background this session?`-Dialog

Wenn Sie ← drücken, um die aktuelle Sitzung in den Hintergrund zu verschieben, und Claude Code zeigt einen Background this session?-Dialog, hat die Sitzung laufende Arbeit, die das Backgrounding stoppen, neu starten oder unbeaufsichtigt laufen lassen würde, und Claude Code fragt, bevor es eines dieser Dinge tut:

  • Arbeit, die nicht verschoben werden kann: Die Sitzung hat Arbeit, die nicht zur Hintergrund-Sitzung verschoben werden kann, wie z. B. ein laufender Monitor. Der Dialog benennt die Arbeit, die Claude Code stoppen würde, und zählt separat die Aufgaben, die übertragen werden.
  • Ein Workflow mit laufenden Subagenten: Ein dynamischer Workflow hat noch laufende Subagenten. Der Workflow selbst wird übertragen, aber seine laufenden Subagenten starten von vorne neu, und der Dialog sagt, wie viele.
  • Automatische Artefakt-Antworten: Claude antwortet auf Kommentare zu einem Artefakt von selbst. Diese Antworten werden in der Hintergrund-Sitzung fortgesetzt, und der Dialog sagt dies.

Führen Sie /tasks aus, um zu sehen, was läuft, dann bestätigen Sie, um trotzdem in den Hintergrund zu gehen, oder wählen Sie Stay, um die Arbeit zuerst fertig zu stellen. Siehe Was wird übertragen, wenn Sie backgrounden, um zu sehen, welche Arten von Arbeit übertragen werden und welche Claude Code stoppt.

Eingabeaufforderung als zu kurz abgelehnt

Die Versand-Eingabe erwartet eine Aufgabenbeschreibung, keine Gesprächseröffnung. Eine Eingabeaufforderung, die kürzer als vier Zeichen ist, wird mit einem Too short-Hinweis abgelehnt, damit ein versehentlicher Tastendruck keine Sitzung startet. Beschreiben Sie, was die Sitzung tun soll, z. B. investigate the flaky checkout test.

Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt

Das Herunterfahren oder Neustarten Ihres Computers stoppt laufende Hintergrund-Sitzungen. Eine Sitzung, die auf Ihre Eingabe wartet, bleibt unter Needs input, wenn Sie zurückkommen. Für jede andere laufende Sitzung hängt das, was die Agenten-Ansicht zeigt, davon ab, wie lange es her ist, dass sie zuletzt Fortschritte gemacht hat:

  • Innerhalb von 48 Stunden wird die Sitzung als fehlgeschlagen angezeigt. Hängen Sie sich an oder antworten Sie darauf, und sie startet von dort neu, wo sie aufgehört hat.
  • Nach 48 Stunden, z. B. nachdem der Computer tagelang ausgeschaltet war, wird die Sitzung als gestoppt mit ended while the background service was off angezeigt. Drücken Sie Enter auf der Zeile und die Fußzeile zeigt Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Drücken Sie Enter auf derselben Zeile erneut, um die gespeicherte Konversation fortzusetzen. Eine Antwort oder claude attach <id> setzt sie fort, ohne diese Fußzeilenaufforderung.

Wenn die Transkript-Bereinigung die gespeicherte Konversation einer gestoppten Sitzung entfernt hat, weigert sich Claude Code, die Zeile zu öffnen: Die Meldung besagt, dass es nichts zum Fortsetzen gibt. claude rm <id> löscht die Zeile, außer in den beibehaltenen Fällen, die oben beschrieben sind, und claude respawn <id> führt die ursprüngliche Eingabeaufforderung erneut aus. Siehe Die gespeicherte Konversation dieser Sitzung ist nicht mehr auf der Festplatte.

Der Ruhezustand allein stoppt Sitzungen nicht. Sitzungen werden über den Ruhezustand hinweg beibehalten und der Supervisor verbindet sich beim Aufwachen wieder mit ihnen.

Öffnen einer Sitzung besagt, dass die Konversation bereits offen ist

Zwei Prozesse können nicht in dasselbe Transkript schreiben. Wenn die gespeicherte Konversation einer gestoppten Sitzung bereits in einem anderen laufenden Claude Code-Prozess offen ist, weigert sich Claude Code, den Prozess der Sitzung zu starten. Was Sie sehen, hängt davon ab, was die Konversation hält:

  • Ein Terminal, in dem Sie die Konversation fortgesetzt haben, z. B. mit claude --resume oder /resume: Die Zeile zeigt Open in a terminal mit einem Hinweis, um sie dort fortzusetzen, und das Öffnen der Zeile zeigt Can't open — this session is running in another terminal. Setzen Sie sie in diesem Terminal fort, oder beenden Sie es und öffnen Sie die Zeile erneut.
  • Ein anderer nicht-interaktiver Claude Code-Prozess, z. B. ein Hintergrund-Sitzungsprozess für dieselbe Konversation, der noch nicht beendet wurde: Das Öffnen der Zeile zeigt This conversation is already open in another running Claude session. Verwenden Sie diesen Prozess, oder warten Sie, bis er beendet wird, und öffnen Sie die Zeile erneut.

Claude Code speichert eine Antwort, die Sie mit dem abgelehnten Versuch eingegeben haben, und sendet sie, wenn die Sitzung das nächste Mal startet.

Öffnen einer Sitzung besagt, dass sie kein gespeichertes Transkript hat

Eine gestoppte Sitzung, die von einer anderen Konversation aus backgroundet wurde und gestoppt wurde, bevor ihre erste Antwort fertig wurde, hat nichts zum Fortsetzen: Bis diese erste Antwort fertig ist, lebt die Konversation noch nur in der Sitzung, von der sie backgroundet wurde. claude attach weigert sich, sie mit This session has no saved transcript zu öffnen.

In der Agenten-Ansicht zeigt das Öffnen dieser Zeile Press enter again to restart this session fresh unter der Liste. Drücken Sie Enter auf derselben Zeile erneut, um die Sitzung mit einer leeren Konversation neu zu starten, oder führen Sie claude respawn <id> aus der Shell aus.

Die ursprüngliche Konversation ist intakt; setzen Sie sie mit claude --resume fort oder arbeiten Sie weiter darin. Siehe die Fehlerreferenz für Details.

Der Terminal-Host ist gestorben oder die Sitzung hat nicht mehr reagiert

Der Supervisor führt den Terminal jeder Hintergrund-Sitzung in seinem eigenen Host-Prozess aus. Wenn dieser Prozess stirbt oder nicht mehr reagiert, zeigt Claude Code den Grund an und bietet einen Neustart an; in beiden Fällen wird die Konversation gespeichert und der Neustart setzt sie fort. Die Fehlerreferenz zitiert die vollständigen Meldungen.

Claude Code startet eine Zeile, die einen Shell-Befehl ausführt, nie neu, von Enter oder von claude attach, da dies den Befehl erneut ausführen würde; die Meldung der Zeile und claude attach sagen beide, dass der Befehl nicht erneut ausgeführt wird.

Eine Sitzung schlägt vor dem Start mit einer `possibly low memory`-Notiz fehl

Wenn der Prozess einer Hintergrund-Sitzung beendet wird, bevor er fertig startet, und der Host wenig Speicher hat, benennt der Status der Zeile den Exit und fügt possibly low memory — free some up and retry hinzu.

Die Notiz ist eine Hypothese, keine bestätigte Ursache. Claude Code fügt sie nur hinzu, wenn der Prozess stillschweigend beendet wurde, ohne einen Fehler zu schreiben und ohne durch ein Signal gestoppt zu werden, und der Host meldete zu diesem Zeitpunkt wenig Speicher. Wenn der Prozess vor dem Exit einen Fehler geschrieben hat, zeigt die Zeile stattdessen diesen Fehler.

Geben Sie Speicher auf dem Computer frei, dann hängen Sie sich an oder antworten Sie auf die Zeile und der Supervisor startet einen neuen Prozess für die Sitzung. Wenn der Speicher niedrig bleibt, stoppt der Supervisor auch untätige Sitzungen von selbst, um Ressourcen freizugeben, und stoppt untätige angeheftete Sitzungen auch, wenn das Stoppen der anderen nichts freigegeben hat.

Agenten-Ansicht sagt, dass der Hintergrunddienst nicht geantwortet hat

Wenn das Anhängen, Anschauen oder claude logs meldet, dass der Hintergrunddienst nicht geantwortet hat, ist der Supervisor-Prozess wahrscheinlich steckengeblieben. Stoppen Sie ihn und lassen Sie den nächsten claude agents einen neuen starten. Um Ihre Hintergrund-Sitzungen während des Neustarts am Laufen zu halten, übergeben Sie --keep-workers:

claude daemon stop --any --keep-workers

Der neue Supervisor verbindet sich wieder mit den laufenden Sitzungen. Ohne --keep-workers beendet der Befehl auch die Hintergrund-Sitzungen. Das Flag --any bestätigt, dass Sie einen Supervisor stoppen möchten, der bei Bedarf gestartet wurde, anstatt als installierter Dienst, was die Standardeinstellung ist.

Ein Supervisor, der startet, aber keine Verbindungen akzeptieren kann, beendet sich selbst und gibt seine Sperre frei, sodass der nächste claude agents ohne diesen manuellen Stop einen neuen startet. Die obigen Schritte gelten, wenn ein laufender Supervisor steckenbleibt.

Wenn der Befehl stattdessen beendet wird und sagt, dass der aufgezeichnete Prozess nicht als Supervisor verifiziert werden konnte, überprüfen Sie die gemeldete Prozess-ID: Wenn es ein Supervisor ist, den Sie besitzen, stoppen Sie ihn selbst, dann löschen Sie ~/.claude/daemon.lock, damit der nächste claude agents frisch startet.

Unter Windows, wenn der Supervisor nicht auf die Stoppanforderung antwortet, gibt der Befehl seine Prozess-ID aus. Beenden Sie diesen Prozess mit taskkill /PID <pid>, um die Wiederherstellung abzuschließen. Hintergrund-Sitzungen werden immer noch beibehalten, wenn Sie --keep-workers übergeben haben.

Versand schlägt mit `Could not resolve authentication method` fehl

Wenn ein Hintergrund-Versand mit Could not resolve authentication method fehlschlägt, während interaktive Sitzungen sich normal authentifizieren, hat der Worker, der den Versand erhalten hat, keine Anmeldedaten aufgegriffen. Hintergrund-Sitzungen erhalten ihre Anmeldedaten vom Supervisor, daher bedeutet dieser Fehler, dass dem Supervisor-Prozess selbst keine gespeicherten Anmeldedaten zur Verfügung standen. Bestätigen Sie, dass Sie /login ausgeführt oder einen API-Schlüssel konfiguriert haben, dann stoppen Sie den Supervisor:

claude daemon stop --any --keep-workers

Der nächste claude agents oder claude --bg startet einen neuen Supervisor, der Ihre gespeicherten Anmeldedaten liest. Wenn Sie sich mit einer Umgebungsvariable wie ANTHROPIC_API_KEY authentifizieren, anstatt /login zu verwenden, führen Sie diesen nächsten Befehl aus einer Shell aus, in der die Variable gesetzt ist.

Siehe die Fehlerreferenz für die vollständige Liste der Ursachen und Behebungen.

Hintergrund-Sitzungen können Desktop, Dokumente oder Downloads auf macOS nicht lesen

Unter macOS wird der Hintergrund-Sitzungs-Host als eigener Prozess ausgeführt und fordert Zugriff auf geschützte Ordner separat von Ihrem Terminal an. Wenn eine Hintergrund-Sitzung Operation not permitted meldet, wenn sie ~/Desktop, ~/Documents, ~/Downloads oder einen anderen geschützten Ort liest, gewähren Sie Zugriff in den Systemeinstellungen unter Datenschutz & Sicherheit > Dateien und Ordner, oder aktivieren Sie Vollständigen Festplattenzugriff für den Eintrag.

Mit dem nativen Installer wird der Eintrag als Claude Code angezeigt und die Berechtigung bleibt über Updates hinweg erhalten. Bei anderen Installationsmethoden wie Homebrew oder npm zeigt der Eintrag den Binärpfad an und muss möglicherweise nach dem Update erneut gewährt werden.

Hintergrund-Sitzungen können auf macOS keine lokalen Netzwerk-Hosts erreichen

Unter macOS 15 und später blockiert das System einen Prozess daran, Geräte in Ihrem lokalen Netzwerk zu erreichen, bis Sie die Berechtigung für lokales Netzwerk gewähren, daher kann ein Befehl, der auf eine LAN-Adresse abzielt, in einer Hintergrund-Sitzung mit connect: no route to host fehlschlagen, obwohl er in einem Vordergrund-Terminal funktioniert. Der erste Befehl in einer Hintergrund-Sitzung, der sich mit einer lokalen Netzwerk-Adresse verbindet, löst die macOS-Berechtigung für lokales Netzwerk für Claude Code aus. Gewähren Sie sie einmal und diese Befehle erreichen LAN-Hosts auf die gleiche Weise wie in einem Vordergrund-Terminal.

Eine Sitzung reagiert langsam nach dem Anhängen

Sobald eine Sitzung fertig ist und etwa eine Stunde lang unverbunden sitzt, stoppt der Supervisor seinen Prozess, um Ressourcen freizugeben. Das Anhängen startet einen neuen Prozess von dort, wo er aufgehört hat, und wechselt sofort zur Sitzung, während der Prozess neu startet. Sitzungen, die funktionieren, auf Sie warten oder angeheftet sind, werden auf diese Weise nicht gestoppt, daher heften Sie eine Sitzung mit Ctrl+T an, um sie reaktionsschnell zu halten.

Während der Prozess startet, zeigt Claude Code das Ende des Sitzungstranskripts, formatiert wie die Live-Sitzung es rendert, mit Markdown, hervorgehobenen Code-Blöcken und Tool-Aufrufen als gedimmte Zeilen, über einem gedimmten Eingabebereich mit einer Session is starting-Notiz. Die Live-Sitzung ersetzt ihn, sobald sie bereit ist.

`.claude/worktrees/` füllt sich auf

Das Löschen einer Sitzung in der Agenten-Ansicht entfernt den Worktree, den Claude dafür erstellt hat, aber einige Löschungen behalten den Worktree oder lassen sein Verzeichnis auf der Festplatte, daher können verwaiste Verzeichnisse sich ansammeln. Verzeichnisse, die Git nicht mehr erkennt, erscheinen nicht in git worktree list, daher entfernen Sie diese von Hand.

Listen Sie verbleibende Einträge mit git worktree list im Projektverzeichnis auf und entfernen Sie jeden mit git worktree remove <path>. Siehe Worktrees bereinigen.

Einschränkungen

Die Agenten-Ansicht ist eine Forschungsvorschau mit den folgenden Einschränkungen:

  • Ratenlimits gelten: Hintergrund-Sitzungen verbrauchen Ihre Abonnementnutzung genauso wie interaktive Sitzungen, daher verwendet das Ausführen von zehn Agenten parallel die Quote ungefähr zehnmal schneller.
  • Sitzungen sind lokal: Hintergrund-Sitzungen laufen auf Ihrem Computer. Sie werden über den Ruhezustand hinweg beibehalten, stoppen aber, wenn der Computer heruntergefahren wird.
  • Von Claude erstellte Worktrees werden mit der Sitzung in der Agenten-Ansicht gelöscht: Führen Sie Änderungen zusammen, bevor Sie eine Sitzung löschen, die Dateien in ihrem eigenen Worktree bearbeitet hat. Einige Löschungen behalten den Worktree stattdessen bei.

Weitere Möglichkeiten zum parallelen Ausführen von Claude und zum Weitergeben von Erkenntnissen zwischen den Sitzungen, die Sie ausführen, finden Sie unter:

  • Agenten parallel ausführen: Vergleichen Sie die Agenten-Ansicht mit Subagenten, Agenten-Teams und Worktrees
  • Sitzungsübergreifendes Messaging: Lassen Sie Ihre Sitzungen Erkenntnisse untereinander weitergeben
  • Agenten-Teams: Koordinieren Sie mehrere Sitzungen, die sich gegenseitig Nachrichten senden
  • Claude Code im Web: Führen Sie Sitzungen in einer verwalteten Cloud-Umgebung aus, anstatt lokal
  • Projekte: Lassen Sie Claude mehrere parallele Cloud-Sitzungen aus einem Gespräch koordinieren und teilen Sie mit, welche Sie benötigen

Versionsverlauf

Die Agentenansicht hat sich während der Research Preview schnell weiterentwickelt. Wenn Sie eine ältere Version von Claude Code verwenden, kann sich manches Verhalten auf dieser Seite unterscheiden; insbesondere lehnt claude agents Flags, die es noch nicht unterstützt, mit einem unknown option-Fehler ab. Die folgende Tabelle listet auf, wann welches Flag und welches Verhalten hinzugefügt wurde.

Version Änderung
v2.1.287 Der n:<text>-Filter findet Sitzungen anhand ihres Namens oder ersten Prompts. Solange ein Filter aktiv ist, werden Gruppen, die Sie eingeklappt haben, ausgeklappt, um ihre Treffer anzuzeigen, und der erste Treffer ist ausgewählt, sodass Enter ihn öffnet.
v2.1.287 Ein als Peek-Antwort gesendeter Befehl wird ausgeführt, wenn der aktuelle Turn der Sitzung endet, einschließlich der Befehle, die sofort ausgeführt werden, wenn Sie sie im eigenen Eingabefeld einer Sitzung eingeben. Eine Antwort, die genau /stop lautet, stoppt die Sitzung sofort.
v2.1.281 Eine --setting-sources-Einschränkung wird übernommen für eine Sitzung, die Sie mit ← oder /bg in den Hintergrund verschieben, sowie für die Sitzungen, die Sie aus der Agentenansicht starten. Vor diesem Release lud die gestartete Sitzung jede Einstellungsquelle.
v2.1.281 claude --bg und die Befehle, die eine Sitzung neu starten, prüfen zuerst das Workspace-Vertrauen für das Verzeichnis der Sitzung. In einem Terminal in diesem Verzeichnis erscheint der Vertrauensdialog, falls Sie ihn noch nicht akzeptiert haben; wo kein Dialog erscheinen kann, etwa in einem Skript, beendet sich der Befehl mit einem Workspace not trusted-Fehler.
v2.1.274 Nach einem automatischen Update kann sich eine Agentenansicht, die Sie etwa eine Stunde lang nicht genutzt haben, mit dem neuen Build neu starten. Dabei behält sie die Dispatch-Standardwerte bei, mit denen Sie sie geöffnet haben: --model, --effort, --permission-mode, --allow-dangerously-skip-permissions und --agent. Vor diesem Release behielt die neu gestartete Ansicht nur --cwd und Konfigurations-Flags wie --settings und --mcp-config, sodass danach gestartete Sitzungen ohne diese Standardwerte begannen.
v2.1.274 Wenn ein Löschen abgelehnt wird, weil Git oder Ihr WorktreeRemove-Hook den Worktree nicht entfernen konnte, blockiert ein ausgechecktes Submodul, für das Claude Code überprüft, dass es keine nicht committeten Änderungen an getrackten Dateien hat, nicht das Angebot, erneut zu löschen und das Verzeichnis trotzdem zu entfernen. Nicht committete Arbeit in einem ausgecheckten Submodul zählt als nicht committete Änderungen, und die Meldung nennt das Submodul. Vor diesem Release blockierte jeder Submodul-Checkout im Worktree das Angebot, mit einer Meldung, dass der Worktree ein verschachteltes Repository enthält.
v2.1.268 Wenn ein Löschen abgelehnt wird, weil Git oder Ihr WorktreeRemove-Hook den Worktree nicht entfernen konnte, nennt die Meldung die Ursache, einschließlich der Art, wie ein Hook beendet wurde, und des Anfangs seiner stderr-Ausgabe. Bei einem verknüpften Worktree unter .claude/worktrees/ des Repositorys ohne nicht committete Änderungen an getrackten Dateien, ohne verschachteltes Repository darin und ohne einen Eintrag einer anderen Sitzung, der ihn nennt, entfernt erneutes Löschen der Sitzung das Verzeichnis trotzdem, aus der Agentenansicht oder mit claude rm <id> --force-remove-worktree <worktree-id>. Vor diesem Release zeigte die Zeile nur worktree could not be removed (WorktreeRemove hook failed) oder den Fehler von Git, die stderr-Ausgabe des Hooks ging nur in das Debug-Log, und erneutes Löschen wurde auf dieselbe Weise abgelehnt.
v2.1.268 Nachdem das erste ← Press ← again to open agents anzeigt, oder Press ← again to go back to agents in einer verbundenen Sitzung, wechselt der erste Tastendruck, der mindestens eine Sekunde später erfolgt, auch wenn schnellere Tastendrücke dazwischen ignoriert wurden. Vor diesem Release startete jeder ignorierte Tastendruck die Wartezeit neu, sodass erneutes Drücken von ← in gleichmäßigem Tempo erst wechselte, wenn Sie länger als eine Sekunde pausierten.
v2.1.260 Wenn Sie eine Sitzung in den Hintergrund verschieben, zeigt die Agentenliste Ihrer anderen Sitzungen die Konversation einmal an, als ihre Hintergrundsitzung, und deren Nachrichten an sie erreichen nicht mehr das Terminal, aus dem Sie sie verschoben haben. Vor diesem Release konnte dieses Terminal als zweite interaktive Sitzung unter dem Namen der Konversation aufgeführt bleiben, und eine Sitzung, die der Konversation vor dem Verschieben Nachrichten gesendet hatte, stellte weiterhin an dieses Terminal zu.
v2.1.260 Wenn ein Löschen wegen nicht gepushter Commits abgelehnt wird, nennt die Meldung den Branch des Worktrees und wie viele Commits nicht gepusht sind, und erneutes Löschen der Sitzung verwirft den Worktree und seine Commits. Vor diesem Release sagte die Ablehnung nur worktree has commits that are not pushed anywhere, erneutes Löschen wurde auf dieselbe Weise abgelehnt, und zum Löschen der Sitzung mussten die Commits gepusht oder der Worktree von Hand entfernt werden.
v2.1.257 ← trennt die Verbindung zu einer verbundenen Sitzung, während das /btw-Overlay geöffnet ist, auch mitten in einer Antwort, und das Overlay öffnet sich wieder, wenn Sie sich das nächste Mal verbinden. Vor diesem Release trennte ← nicht, während das Overlay geöffnet war.
v2.1.257 Wenn Sie claude --resume <session-id> --bg ausführen, setzt Claude Code diese Sitzung unter ihrer eigenen ID fort oder startet eine Kopie unter einer neuen ID und gibt eine note:-Zeile aus, die den Grund erklärt. --continue, ein alleinstehendes --resume und --resume mit einem Namen oder Pfad starten eine Kopie mit demselben Hinweis. Vor diesem Release startete --resume mit --bg immer eine Kopie unter einer neuen ID, ohne etwas mitzuteilen.
v2.1.257 Wenn Sie eine Sitzung aus einer Agentenansicht starten, die Sie mit ← geöffnet haben, startet Claude Code sie in dem Berechtigungsmodus, den das Zielverzeichnis konfiguriert, festgelegt über permissions.defaultMode. Wenn das Verzeichnis keinen festlegt, gilt der Berechtigungsmodus der Sitzung, aus der Sie gekommen sind. Vor diesem Release startete die gestartete Sitzung immer im Berechtigungsmodus der Sitzung, aus der Sie gekommen waren, und überschrieb damit die Einstellung des Verzeichnisses.
v2.1.257 Ctrl+S, Ctrl+T und Ctrl+G in der Agentenansicht folgen Ihrer keybindings.json: Ctrl+S und Ctrl+T über die Aktionen agents:switchView und agents:togglePin des Kontexts Agents, und Ctrl+G über die Tastenkombination chat:externalEditor des Kontexts Chat. Vor diesem Release ignorierte die Agentenansicht keybindings.json, und diese Tasten waren fest belegt.
v2.1.257 Das Starten des Hintergrunddienstes erholt sich von zwei Fehlerursachen. Bei einer macOS-npm-Installation wartet ein Start während eines Selbst-Updates auf die Installation, statt den Platzhalter auszuführen, den npm beim Ersetzen der Binärdatei ablegt. Unter Windows wird eine veraltete daemon.lock ersetzt, die vor dem letzten Systemstart geschrieben wurde oder deren gespeicherte Prozess-ID inzwischen zu einem anderen Prozess gehört. Vor diesem Release schlug der macOS-Start während des Installationsfensters mit Error: claude native binary not installed. fehl, und die Windows-Sperre ließ jeden Start mit exited before it became reachable fehlschlagen, bis Sie ~/.claude/daemon.lock löschten.
v2.1.257 Wenn Sie eine Hintergrundsitzung öffnen oder starten, während ein anderer Claude-Code-Prozess ein npm-Update herunterlädt, wartet Claude Code bis zu zwei Minuten, während die Installation läuft, und schlägt dann mit der Meldung Claude Code is being updated by npm on this machine fehl. Vor diesem Release endete das Warten nach zehn Sekunden, sodass das Öffnen mit Couldn't start the background service fehlschlug, während der Download noch lief.
v2.1.257 Eine Hintergrundsitzung, die eine sitzungsübergreifende Nachricht zu Ihrer Genehmigung zurückhält, zeigt approve message from in ihrer Needs input-Zeile an, mit der Adresse des Absenders und dem Namen, den der Absender angibt. Vor diesem Release wechselte die Zeile zu Needs input, behielt aber ihren vorherigen Text, sodass nichts in claude agents die wartende Nachricht oder ihren Absender nannte.
v2.1.257 Ein mit Ctrl+S in einer geöffneten Hintergrundsitzung zwischengespeicherter Prompt wird mit der Sitzung aufbewahrt, sodass Ctrl+S ihn wiederherstellt, nachdem der Prozess der Sitzung gestoppt und wieder gestartet wurde. Vor diesem Release existierte der zwischengespeicherte Prompt nur im laufenden Prozess und ging verloren, wenn die Sitzung lange genug inaktiv war, dass ihr Prozess stoppte, oder wenn sie gestoppt und dann wieder geöffnet wurde.
v2.1.251 In einer Hintergrundsitzung, die nicht in einen Worktree gewechselt ist, können Claude und die von ihm gestarteten Subagenten Dateien innerhalb eines verknüpften Git-Worktrees bearbeiten.
v2.1.251 Claude Code leitet ein Cloud-Anbieter-Gateway, das in der Shell exportiert ist, aus der Sie starten, etwa ANTHROPIC_VERTEX_BASE_URL oder ANTHROPIC_BEDROCK_BASE_URL mit dem zugehörigen Flag zur Umgehung der Authentifizierung, unter denselben Bedingungen wie ANTHROPIC_BASE_URL an den Worker der Sitzung weiter. Vor diesem Release schlug jede Anfrage der Sitzung fehl, wenn Sie aus einer Shell, die nur über ein solches Gateway authentifiziert war, in den Hintergrund verschoben oder gestartet haben, weil der Endpunkt und das Flag aus ihrer Umgebung entfernt wurden.
v2.1.251 Wenn eine Hintergrundsitzung startet, während ein anderer Claude-Code-Prozess einen Plugin-Marketplace aktualisiert, etwa eine parallele Sitzung, die das automatische Marketplace-Update ausführt, hält Claude Code die Plugins dieses Marketplace verfügbar. Vor diesem Release konnte eine solche Sitzung ohne die Skills, Agenten, Hooks und MCP-Server dieses Marketplace starten und für ihre gesamte Laufzeit so bleiben.
v2.1.248 Shift+Enter in der Dispatch-Eingabe fügt wie im Haupt-Prompt einen Zeilenumbruch ein, und Ctrl+Enter startet die Sitzung und verbindet sich sofort mit ihr, in Terminals, in denen das ?-Overlay ctrl+enter to start and open auflistet. Vor diesem Release startete Shift+Enter die Sitzung und verband sich mit ihr.
v2.1.248 Das Löschen einer Sitzung gelingt, wenn die Commits des Worktrees bereits in der lokalen Kopie des Standard-Branches Ihres origin-Remotes enthalten sind und in Ihrem Haupt-Checkout dieser Branch ausgecheckt ist; vor diesem Release wurde das Löschen mit has commits that are not pushed anywhere abgelehnt.
v2.1.248 Eine mit ← oder /background in den Hintergrund verschobene Sitzung hält die git worktree lock-Sperre für ihren Worktree, solange sie läuft; vor diesem Release gab das Verschieben in den Hintergrund die Sperre frei, und die Bereinigung oder git worktree remove konnte den Worktree unter der laufenden Sitzung entfernen.
v2.1.248 Eine Hintergrundsitzung, die nicht auf Ihre Eingabe gewartet hat und mehr als 48 Stunden nach ihrer letzten Aktivität als beendet erkannt wird, etwa nachdem der Rechner tagelang ausgeschaltet war, wird als gestoppt angezeigt mit ended while the background service was off, und Enter darauf fragt nach, bevor die gespeicherte Konversation fortgesetzt wird. Vor diesem Release erschien eine solche Sitzung erneut als frischer Fehler, an den Anfang der Liste sortiert, und ein einziges Enter holte die Wochen alte Konversation in den Vordergrund.
v2.1.248 Das Öffnen einer gestoppten Zeile, deren Konversation Sie in einem anderen Terminal fortgesetzt haben, wird mit Can't open — this session is running in another terminal abgelehnt, und die Zeile zeigt Open in a terminal an, statt unter Working zu erscheinen. Vor diesem Release startete das Öffnen der Zeile einen zweiten Prozess, der in dieselbe Konversation schrieb.
v2.1.248 Eine Hintergrundsitzung, die auf eine Berechtigungsentscheidung wartet, während ein PermissionRequest- oder PreToolUse-Hook eine ungültige Antwort ausgegeben hat, nennt das Hook-Event und den Schemafehler in ihrer Zeile. Vor diesem Release zeigte die Zeile nur die ausstehende Anfrage.
v2.1.248 Unter Windows reagiert claude agents auf die Tastatur, wenn es in einem Terminal-Tab gestartet wird, den ein früheres Programm im win32-input-mode hinterlassen hat. Vor diesem Release dekodierte Claude Code die Tastendatensätze nicht, die ein solcher Tab sendet.
v2.1.247 Unter Linux und WSL schlägt eine Sitzung, deren Terminal-Host-Prozess beendet wurde, innerhalb von Sekunden mit dem Grund fehl. Ein Öffnen, das keine Ausgabe erzeugt, endet nach etwa zehn Sekunden mit einem Angebot zum Neustart, und Enter auf der Zeile startet die Sitzung mit ihrer Konversation neu; claude attach <id> meldet die Ursache und beendet sich. Vor diesem Release zeigte das Öffnen einer solchen Sitzung unbegrenzt opening… · esc to cancel an, und claude attach <id> wartete, ohne einen Fehler zu melden.
v2.1.246 Bei einer npm-Installation wartet Claude Code, wenn der Hintergrunddienst nicht startet, während npm install -g @anthropic-ai/claude-code die Binärdatei ersetzt, bis zu zehn Sekunden auf den Abschluss der Installation und versucht es erneut, bevor es EACCES: permission denied meldet.
v2.1.246 Wenn der Prozess des Hintergrunddienstes nach der Ausgabe eines Fehlers beendet wird, meldet Claude Code den Fehlschlag und zitiert die erste Fehlerzeile des Dienstes.
v2.1.246 Wenn Ihr Rechner in den Ruhezustand wechselt, während der Hintergrunddienst startet, versucht Claude Code den Start einmal erneut, statt fehlzuschlagen.
v2.1.246 Claude Code wartet etwa zwei Minuten statt 45 Sekunden auf einen neu gestarteten Hintergrunddienst, der läuft, aber Verbindungen nur langsam annimmt.
v2.1.246 Der Hintergrunddienst startet aus Ihrem Home-Verzeichnis, sodass unter macOS und Linux ein Startverzeichnis, das gelöscht oder verschoben wurde, den Start nicht mehr blockiert.
v2.1.246 /fork kopiert die vollständige Konversation aus einer Sitzung, die selbst als Kopie gestartet wurde und seitdem keinen neuen Prompt aufgezeichnet hat: eine /fork-Kopie, mit der Sie sich verbunden haben, eine Sitzung, mit der Sie sich erneut verbunden haben, nachdem ← oder /background sie in den Hintergrund verschoben hat, oder eine mit claude --resume <id> --fork-session gestartete Sitzung. Vor diesem Release gab Claude Code, wenn Sie /fork in einer solchen Sitzung ausgeführt haben, bevor Sie ihr einen neuen Prompt gesendet haben, die normale Bestätigung aus, startete die Kopie aber mit einer leeren Konversation. Das Verschieben einer solchen Sitzung in den Hintergrund mit ← oder /background verlor die Konversation auf dieselbe Weise.
v2.1.246 Wenn Sie eine gerade gestartete Sitzung öffnen, während ihr Worker-Prozess noch startet, etwa durch Drücken von Enter auf ihrer Zeile, wartet Claude Code auf den Prozess und verbindet sich dann. Vor diesem Release konnte Claude Code, wenn Sie Enter drückten, während der Prozess noch startete, die Sitzung mit Session <id> was stopped while the respawn was in flight stoppen.
v2.1.246 Wenn Sie eine benannte Sitzung in den Hintergrund verschieben, listet Claude Code sie einmal auf, und wenn Sie dieselbe Konversation erneut in den Hintergrund verschieben, nummeriert es den Namen der neuen Zeile, etwa my-session (2), während die bestehende Zeile ihren Namen behält. Vor diesem Release konnte das Terminal, in dem Sie ← gedrückt haben, in claude agents --json als zweite Sitzung unter demselben Namen erscheinen, und wenn Sie dieselbe Konversation erneut in den Hintergrund verschoben, fügte Claude Code eine weitere Zeile unter dem identischen Namen hinzu.
v2.1.239 Bei aktiviertem Vim-Editormodus wechselt das Drücken von Esc in der Eingabe der Agentenansicht vom INSERT- in den NORMAL-Modus und behält Ihren Text bei, wie im Haupt-Prompt; im NORMAL-Modus mit noch vorhandenem Text in der Eingabe löscht Esc diesen, und Esc bei leerer Eingabe beendet die Ansicht, wie die Esc-Tastenkombination beschreibt. Vor diesem Release löschte Esc die Eingabe.
v2.1.233 Bei einer Sitzung, die mit einem GitLab-Merge-Request verknüpft ist, schreibt Claude Code die Beschriftung der Zeile in der GitLab-Referenzsyntax !1234. Sie können auch die URL des Merge Requests in die Dispatch-Eingabe einfügen, um diese Sitzung auszuwählen. Vor diesem Release wurde die Beschriftung als #1234 dargestellt, und eine eingefügte Merge-Request-URL passte nur dann zu einer Sitzung, wenn deren erster Prompt die URL enthielt.
v2.1.227 Das Löschen einer Sitzung behält die Sitzung und ihren Worktree bei, solange eine andere aktive Claude-Code-Sitzung in diesem Worktree-Verzeichnis läuft. Die Agentenansicht zeigt not deleted in der Zeile und den Grund in der Fußzeile an, und claude rm gibt kept <id> mit dem Grund aus, der die Prozess-ID der anderen Sitzung nennt. Vor diesem Release entfernte das Löschen der Sitzung den Worktree, während die andere Sitzung noch darin arbeitete.
v2.1.225 claude agents zeigt in einem Verzeichnis, dem Sie nicht vertraut haben, denselben Workspace-Vertrauensdialog, den claude beim Start anzeigt, bevor sich die Agentenansicht öffnet. Akzeptieren speichert das Vertrauen für diesen Workspace; Ablehnen beendet das Programm, ohne die Agentenansicht zu öffnen. Vor diesem Release öffnete sich claude agents ohne Nachfrage, sodass daraus gestartete Sitzungen in einem Verzeichnis liefen, für das Sie nie um Vertrauen gebeten worden waren.

Wenn die Liste nach Verzeichnis gruppiert ist, hebt das Bewegen der Maus über eine Zeile diese hervor, ohne das Dispatch-Ziel zu ändern; das Auswählen einer Zeile mit den Pfeiltasten oder per Klick ändert das Ziel weiterhin. Vor diesem Release änderte das Bewegen der Maus über eine Sitzung in einem anderen Projekt unbemerkt das Verzeichnis, in dem die nächste gestartete Sitzung begann.
v2.1.221 /status zeigt eine Session kind-Zeile: background job · attached oder background job · unattended in einer Hintergrundsitzung, je nachdem, ob ein Terminal verbunden ist, und interactive in jeder anderen Sitzung. Vor diesem Release meldete /status die Sitzungsart nicht.

/fork: Claude Code weist die Kopie an, ihre Arbeit von der der ursprünglichen Sitzung zu isolieren: Die Kopie erstellt einen eigenen Worktree, bevor sie Codeänderungen vornimmt, hält sich aus dem Worktree der ursprünglichen Sitzung heraus und basiert einen neuen Branch auf dem Branch des Originals, wenn ihre Aufgabe auf dieser Arbeit aufbaut. Die genauen Bedingungen finden Sie im verlinkten Abschnitt. Vor diesem Release erhielt die Kopie keine Isolationsanweisung und konnte am Ende den Worktree oder Checkout bearbeiten, in dem die ursprüngliche Sitzung noch arbeitete.

Bei aktiviertem Vim-Editormodus fragt das Drücken von ← direkt nachdem der Prompt mit u bis zum leeren Zustand rückgängig gemacht wurde, nach derselben Bestätigung wie das Löschen des Textes oder das Blättern durch den Prompt-Verlauf, und wechselt erst beim zweiten Drücken; vor diesem Release wechselte das Drücken sofort.
v2.1.219 Bei aktiviertem Vim-Editormodus öffnet das Drücken von ← bei leerem Prompt die Agentenansicht sowohl aus dem NORMAL- als auch aus dem INSERT-Modus, und der ←-Hinweis in der Fußzeile wird im NORMAL-Modus angezeigt; vor diesem Release funktionierten Geste und Hinweis nur im INSERT-Modus, und im NORMAL-Modus bewirkte ← bei leerem Prompt nichts. Eine Eingabe ins Eingabefeld, während Claude Code darauf wartet, die Sitzung in den Hintergrund zu verschieben, bricht den Wechsel mit Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again. ab, sodass ein eingegebener Entwurf nicht verloren geht.
v2.1.218 Das Drücken von ← innerhalb von zwei Sekunden nach einer Löschung, die den Prompt geleert hat, oder nach dem Blättern durch den Prompt-Verlauf zeigt Press ← again to open agents an, oder Press ← again to go back to agents in einer verbundenen Sitzung, und wechselt erst bei einem zweiten Drücken mindestens eine Sekunde später; vor diesem Release wechselte das Drücken sofort. Ein ←, das innerhalb eingefügter oder per Skript erzeugter Eingabe ankommt, löst den Wechsel nicht mehr aus. Das Verschieben einer Vordergrundsitzung in den Hintergrund mit ← zeigt Your conversation moved to the background über der Liste an, und Esc auf der obersten Ebene der Agentenansicht kehrt zu dieser Konversation zurück, statt zur Shell zu beenden, wobei doppeltes Ctrl+C weiterhin zum Beenden dient; wenn die Konversation nicht wieder geöffnet werden kann, beendet sich Claude Code und gibt einen claude --resume-Befehl dafür aus. Unter Windows zeigt ein ←, das innerhalb von etwa einer halben Sekunde nach dem Verbinden gedrückt wird, Ambiguous ←, press again to detach an und trennt beim zweiten Drücken.
v2.1.217 Das Pull-Request-Badge in der Zeile einer Sitzung wird als Hyperlink dargestellt, auch wenn Claude Code keine Hyperlink-Unterstützung des Terminals erkennen kann, zum Beispiel über SSH oder tmux; setzen Sie FORCE_HYPERLINK=0, um es als reinen Text darzustellen. Vor diesem Release wurde das Badge als reiner Text dargestellt, wenn keine Unterstützung erkannt wurde.
v2.1.216 /fork: Die Bestätigung ist eine Zeile, die den Zustand der Kopie, den Namen ihrer Zeile in der Agentenansicht und ihre Sitzungs-ID für claude attach zeigt und nur dann mit runs in the origin tree oder edits this checkout endet, wenn die Kopie im Haupt-Arbeitsverzeichnis läuft oder den Checkout bearbeitet, den Sie geöffnet haben. Ein Klick auf den Namen verschiebt diese Sitzung in den Hintergrund und öffnet die Agentenansicht in der Sitzung der Kopie. Die Bestätigung wiederholt nicht mehr den geerbten Berechtigungsmodus der Kopie; frühere Versionen gaben eine mehrzeilige Bestätigung ohne anklickbaren Namen aus.

Needs input: /install-github-app und die /mcp-Einstellungsliste zeigen, wenn sie ausgeführt werden, während niemand verbunden ist, die Sitzung unter Needs input mit einer Zeile an, die den Befehl nennt, und Verbinden und erneutes Ausführen des Befehls setzt fort; von v2.1.208 bis v2.1.215 wurden sie in diesem Zustand direkt abgelehnt.

--agent-Wiederherstellung: Das Fortsetzen oder Neustarten einer in den Hintergrund verschobenen --agent-Sitzung stellt den System-Prompt und die Tool-Einschränkungen des Agenten wieder her, wobei zuerst das eigene Verzeichnis der Sitzung nach dem Agenten durchsucht wird, sofern ihr Workspace vertrauenswürdig ist; eine Sitzung, deren Agent nicht mehr existiert, läuft mit den Standard-Tools und dem Standard-System-Prompt weiter und öffnet sich mit einer sichtbaren Warnung, statt unbemerkt auf den Standard-Agenten zurückzufallen.

Ctrl+X: Zweimaliges Drücken löscht eine Sitzung auch dann, wenn der Stoppversuch fehlschlägt, statt dass ein fehlgeschlagenes Stoppen das ausstehende Löschen abbricht, und eine gelöschte Sitzung, deren Worker-Prozess beendet war, erscheint beim nächsten Aktualisieren nicht mehr erneut.

Worktree-Löschung: Eine Sitzung, deren Worktree-Verzeichnis zu keinem Git-Repository gehört, kann gelöscht werden; vor diesem Release wurde jeder Versuch, eine solche Sitzung zu löschen, abgelehnt. Ein bereits nicht mehr vorhandenes Verzeichnis wird sofort bereinigt. Das doppelte Drücken in der Agentenansicht entfernt ein Verzeichnis, das noch Dateien enthält, und führt bei einem von einem Hook erstellten Verzeichnis Ihren WorktreeRemove-Hook aus, es sei denn, die Einträge einer anderen Sitzung nennen es ebenfalls. claude rm behält ein solches Verzeichnis, solange noch Dateien vorhanden sind.
v2.1.214 Bei einer mit ← oder /background in den Hintergrund verschobenen Sitzung, die inaktiv ist und in der nichts läuft, wird der Prozess wie bei jeder anderen inaktiven Sitzung gestoppt, statt dass ihr Prozess und der Hintergrunddienst unbegrenzt weiterlaufen. Eine abgeschlossene Sitzung kann mit claude rm oder aus der Agentenansicht entfernt werden, nachdem der Hintergrunddienst in den Ruhezustand gegangen ist, und eine Sitzung, die in einen Worktree gewechselt ist, nachdem sie aus einem Verzeichnis gestartet wurde, das kein Git-Repository ist, etwa einem Workspace-Ordner mit mehreren Repositorys, kann aus der Agentenansicht gelöscht werden, wenn der Worktree selbst zu einem Git-Repository gehört, weil die Bereinigung anhand des Worktrees statt des Verzeichnisses aufgelöst wird, aus dem die Sitzung gestartet wurde; beide Entfernungen wurden zuvor bei jedem Versuch abgelehnt. Das erneute Öffnen einer gestoppten Sitzung stellt ihre gespeicherte Konversation auch dann wieder her, wenn ein Ordner im Transkriptspeicher nicht gelesen werden kann.
v2.1.213 /install-github-app, die /mcp-Einstellungsliste und MCP-Authentifizierungsaktionen funktionieren in einer Hintergrundsitzung, während ein Terminal verbunden ist, und werden nur abgelehnt, wenn niemand verbunden ist, mit einer Meldung, die Sie auffordert, sich zu verbinden und den Befehl erneut auszuführen; von v2.1.208 bis v2.1.212 wurden sie selbst bei verbundenem Terminal abgelehnt.
v2.1.212 /fork in einer interaktiven Sitzung kopiert die Konversation in eine neue Hintergrundsitzung, die als eigene Zeile erscheint, benannt nach der Sitzung, aus der sie stammt, oder bei einem Fork mit Prompt aus einer unbenannten Sitzung nach dem Fork-Prompt, während das Original weiterläuft; das frühere Verhalten von /fork als geforkter Subagent wurde zu /subtask verschoben. Wenn die Agentenansicht deaktiviert ist, behält /fork das Verhalten als geforkter Subagent bei. Eine fokussierte Zeile, die auf ihren ersten Prompt wartet, zeigt space to send it a prompt an. Ctrl+J fügt in der Dispatch-Eingabe einen Zeilenumbruch ein, auf Terminals mit erweiterter Tastenmeldung, wo der Tastendruck zuvor ignoriert wurde, und das ?-Overlay listet die Tastenkombination auf. Der ←-Hinweis in der Fußzeile einer interaktiven Sitzung zeigt kurz N done an, wenn eine Hintergrundsitzung fertig wird, während keine Ihre Eingabe benötigt. Die Eingabe eines alleinstehenden /resume in der Agentenansicht öffnet eine Auswahl vergangener Sitzungen des Repositorys, aus dem Sie die Agentenansicht geöffnet haben, einschließlich aus der Liste gelöschter Sitzungen, und die Auswahl einer Sitzung setzt sie als Hintergrundsitzung fort; vor diesem Release war /resume in der Agentenansicht nicht verfügbar, und gelöschte Sitzungen waren nur mit claude --resume oder /resume aus einer interaktiven Sitzung erreichbar. Gezielte, beschränkte und eingeschränkte Formen behalten den Hinweis attach to a session to run it, den frühere Versionen für jede Form anzeigten. Sitzungen, die auf eine Sandbox-Netzwerk-Host-Abfrage, eine MCP-Eingabeanfrage oder eine Abfrage der verwalteten Einstellungen warten, werden als Needs input statt Working angezeigt, in der Agentenansicht und in claude agents --json, und eine Frage von Claude meldet waitingFor: input needed statt permission prompt. Das Verbinden mit einer Sitzung, deren Prozess gestoppt wurde, zeigt ihr Transkript so formatiert an, wie die laufende Sitzung es darstellt, statt als Rohtext. Eine gestoppte Sitzung, deren Transkript sich an einem unerwarteten Ort befindet, wird über eine letzte Suche in Ihren gespeicherten Transkripten daraus fortgesetzt, und das Öffnen einer Zeile ohne gespeichertes Transkript zeigt Press enter again to restart this session fresh an und startet sie beim zweiten Drücken neu; v2.1.211 zeigte die Ablehnung ohne Möglichkeit, aus der Agentenansicht neu zu starten.
v2.1.211 Das Aufwecken einer gestoppten Sitzung durch Verbinden oder Antworten aus dem Verzeichnis, in dem sie läuft, leitet die Gateway-ANTHROPIC_BASE_URL Ihrer Shell wieder weiter, unter denselben Bedingungen wie ein neuer Start, sodass eine über ein Gateway-ANTHROPIC_AUTH_TOKEN authentifizierte Sitzung auf dem Gateway fortgesetzt wird, statt Not logged in zu melden. Das Verbinden mit einer gestoppten Sitzung, die aus einer anderen Konversation in den Hintergrund verschoben wurde, bevor ihre erste Antwort fertig war, wird mit This session has no saved transcript abgelehnt, statt unbemerkt eine leere Konversation unter derselben Sitzungs-ID zu starten; das Öffnen derselben Zeile aus der Agentenansicht zeigte die Ablehnung in der Fußzeile. Das Beenden des Prozesses einer ←- oder /background-Sitzung von außerhalb von Claude Code markiert sie als gestoppt, statt dass der Supervisor sie neu startet, ein bereits auf der Festplatte aufgezeichneter Stopp wird beachtet, es sei denn, eine von Ihnen gesendete Antwort wartet noch auf Zustellung, einer nach einem Absturz neu gestarteten Sitzung wird mitgeteilt, dass sie neu gestartet wurde, und eine neu gestartete ←- oder /background-Sitzung setzt keine unterbrochene Antwort fort, die älter als etwa eine Stunde ist. Eine Antwort zur Sitzungsbenennung, die den Prompt beantwortet oder ablehnt, statt ihn zu beschriften, etwa bei einem Prompt, der größtenteils aus einem Link besteht, wird verworfen, und die Zeile behält einen aus dem Prompt-Text übernommenen Namen. Das Löschen einer Sitzung, deren Worktree Git nicht mehr erkennt, gelingt, wobei das Worktree-Verzeichnis auf der Festplatte verbleibt und sein Pfad genannt wird, statt dass jeder Versuch abgelehnt wird. Ein abgelehntes Löschen zeigt den Grund in der Zeile der Sitzung an, einschließlich des zugrunde liegenden Git-Fehlers, wenn der Worktree nicht entfernt werden konnte, statt dass die Zeile unbemerkt wieder erscheint.
v2.1.210 claude attach wartet, während der Hintergrunddienst startet oder sich neu verbindet, statt mit einem job not found- oder still starting-Fehler fehlzuschlagen, meldet eine Sitzung, die während des Verbindens beendet wurde, als beendet, und wendet eine während eines langsamen Verbindens vorgenommene Größenänderung des Terminals an, wenn das Verbinden abgeschlossen ist. Die ←-Anzahl der auf Eingabe wartenden Sitzungen in der Prompt-Fußzeile erscheint bei jedem Anbieter, einschließlich Drittanbietern, die zuvor die einfache Form ← for agents zeigten. Das Verschieben einer Sitzung in den Hintergrund mit ← überträgt Claudes Aufgabenliste in die Hintergrundsitzung, statt sie zu verwerfen. Die Zeile, aus der Sie ← gedrückt haben, behält einen fetten, nicht abgeblendeten Namen, nachdem die Auswahl weiterbewegt wurde. claude agents --effort akzeptiert ultracode, statt es unbemerkt zu verwerfen.
v2.1.208 Das Verbinden mit einer Sitzung, deren Prozess gestoppt wurde, zeigt den letzten Bildschirminhalt ihres Transkripts an, während der Prozess startet, statt nur eines Session is starting-Hinweises. Eine Antwort, die nicht zugestellt werden kann, weil der Hintergrunddienst nicht erreichbar ist oder das Senden fehlschlägt, wird gespeichert und als nächster Prompt der Sitzung gesendet, wenn ihr Prozess wieder startet; vor diesem Release wurde eine Antwort, die verloren ging, während der Hintergrunddienst nicht erreichbar war, verworfen. Ein Prozess, dessen eigene Binärdatei durch ein Update ersetzt wurde, kann den Supervisor weiterhin starten, über den installierten claude-Launcher oder die neueste Version auf der Festplatte, statt fehlzuschlagen, bis Claude Code neu gestartet wurde. Ein Supervisor, der eine ältere Version ausführt, startet eine inaktive, von einer neueren Version gestartete Sitzung nie mit seiner eigenen älteren Binärdatei neu. Das Löschen einer Sitzung entfernt ihren Worktree auch dann, wenn die Sitzung den Worktree auf einen anderen Branch umgestellt hat, und behält den Worktree zusammen mit der Sitzungszeile bei, wenn der Worktree Commits hat, die nirgendwohin gepusht wurden, oder eine andere Sitzung ihn beansprucht, statt die Commits zu vernichten oder den Worktree verwaist zurückzulassen. /install-github-app sowie die /mcp-Einstellungsliste und deren Authentifizierungsaktionen werden in einer Hintergrundsitzung mit einer Meldung abgelehnt, die die Alternative nennt; nur in v2.1.208 wurde die /model-Auswahl auf dieselbe Weise abgelehnt, und ein eingegebenes /model <name> wechselte nur das Modell dieser Sitzung, statt auch Ihr Standardmodell zu speichern.
v2.1.207 Das Peek-Panel öffnet sich mit dem Satz, den die Zeile abschneidet, etwa der genauen Frage bei einer Sitzung, die auf Sie wartet, und zeigt in einer einzigen waiting 3m-Zeile an, wie lange eine blockierte Sitzung bereits wartet, statt denselben Zeitstempel dem Statussatz und der Frage voranzustellen. Erneutes Einfügen desselben Textes in die Dispatch-Eingabe erweitert den eingeklappten [Pasted text #N]-Platzhalter, statt einen zweiten hinzuzufügen. Eine Hintergrundsitzung, die durch das Annehmen eines Plans benannt wurde, zeigt diesen Namen in ihrer Zeile. Eine Hintergrundsitzung, die in einen Worktree gewechselt ist, behält ihre Konversation, wenn ihr Prozess aus der Agentenansicht neu gestartet wird.
v2.1.206 Zeilenzusammenfassungen füllen die verbleibende Breite der Zeile und werden erst am rechten Rand des Terminals abgeschnitten statt bei 64 Spalten. Nachdem der Supervisor in eine neue Claude-Code-Version neu gestartet ist, startet er die verbleibenden inaktiven Hintergrundsitzungen im Hintergrund mit dieser Version neu, statt einige pro Minute. Das Löschen einer Sitzung mit Ctrl+X oder claude rm entfernt sie auch aus der Sitzungsliste des Supervisors, sodass die Zeile nach einem Neustart des Supervisors nicht mehr erneut erscheint. Eine in der startenden Shell exportierte CLAUDE_CODE_EXTRA_BODY-Überschreibung des Anfrage-Bodys erreicht Hintergrundsitzungen, statt ignoriert zu werden.
v2.1.205 Der ←-Hinweis in der Prompt-Fußzeile einer regulären claude-Sitzung zählt die Hintergrundagenten, die auf Sie warten, etwa ← 2 agents. Zeilenzusammenfassungen zeigen den eigenen einzeiligen Bericht der Sitzung, abgeschnitten bei 64 Spalten, statt eines rohen Tool-Aufrufs oder einer done/total-Anzahl; nach Verzeichnis gruppierte Zeilen beginnen mit einem farbigen Zustandswort. Das Peek-Panel öffnet sich mit dem vollständigen Statussatz und bei einer Sitzung, die auf Sie wartet, mit ihrer genauen Frage über dem Antwort-Eingabefeld. Sitzungen, die mit gh einen Pull Request bearbeiten, kommentieren, schließen oder als bereit markieren, werden mit ihm verknüpft, nicht nur solche, die einen Pull Request erstellen oder auschecken; ein Push verknüpft einen Pull Request auch dann, wenn der lokale Branch-Name nicht übereinstimmt, und ein Pull Request, bei dem die Ausgabe des Erstellungsbefehls das Inline-Limit überschritten hat, wird ebenfalls verknüpft. Ein Turn ohne lesbaren Text behält den vorherigen Zustand der Sitzung bei, statt ihn auf Working zurückzusetzen. claude attach wartet bis zu etwa 60 Sekunden auf eine Sitzung, die neu startet, mit einer Statuszeile, die den Grund nennt, statt fehlzuschlagen.
v2.1.203 Eine in der startenden Shell exportierte Gateway-ANTHROPIC_BASE_URL erreicht die daraus in dasselbe Verzeichnis gestarteten Sitzungen, wenn der Supervisor diese Gateway-Umgebung teilt, statt verworfen zu werden, während der zusammen damit exportierte API-Schlüssel beibehalten wurde. Der PATH der startenden Shell wird auf den Worker jeder Sitzung angewendet. Das Drücken von ←, während Subagenten laufen, wartet auf diese, statt sie nach zehn Sekunden neu zu starten. Die leere Liste zeigt immer die Abschnittsüberschriften mit einer Beschreibung unter jeder an. Die Eingabe von @ in der Dispatch-Eingabe listet auch die registrierten Git-Worktrees des Start-Repositorys auf, die sich in dessen Verzeichnisbaum befinden. Ein aus der Einstellung effortLevel geerbter Effort folgt späteren Änderungen an dieser Einstellung, statt beim Start festgelegt zu sein. Das Öffnen einer gestoppten Sitzung, deren Konversation bereits in einer anderen laufenden Sitzung geöffnet ist, wird mit einer Meldung abgelehnt, statt die Zeile fehlschlagen zu lassen. Ein Befehl, der in der Agentenansicht nicht verfügbar ist, belässt den eingegebenen Text in der Eingabe. Ein WorktreeCreate-Hook, der außerhalb eines Git-Repositorys fehlschlägt, hindert die Sitzung nicht mehr daran, Dateien zu bearbeiten.
v2.1.202 Ein mit /rename oder Ctrl+R für eine Hintergrundsitzung festgelegter Name bleibt erhalten, wenn der Supervisor ihren Prozess stoppt und neu startet, statt auf den Namen zurückzufallen, mit dem die Sitzung gestartet wurde.
v2.1.200 Eine ältere Claude-Code-Version, die die Sitzungsliste in roster.json neu schreibt, bewahrt die von einer neueren Version geschriebenen Felder, entsprechend der bestehenden Garantie für state.json, sodass von der neueren Version gestartete Sitzungen nach einem Neustart des Supervisors weiterhin Eingaben annehmen. Wenn Sie eine Sitzung öffnen, die nicht mehr reagiert, startet der Supervisor ihren Prozess neu, und die Sitzung setzt die unterbrochene Antwort dort fort, wo sie aufgehört hat. Die Agentenansicht wendet ein nach agents angegebenes --plugin-dir-Flag sowohl auf ihre eigene Autovervollständigung für Subagenten und Skills in der Dispatch-Eingabe als auch auf gestartete Sitzungen an.
v2.1.199 Eine Hintergrundsitzung, deren Prozess auf einem Host mit wenig Arbeitsspeicher beendet wird, bevor er vollständig gestartet ist, zeigt in ihrem Zeilenstatus possibly low memory — free some up and retry an statt nur des reinen Beendigungsgrunds. Das Verschieben einer Sitzung in den Hintergrund mit ← oder /background überträgt ihre /color auf die neue Zeile.
v2.1.198 Die Agentenansicht sendet eine Benachrichtigung über preferredNotifChannel, wenn eine Hintergrundsitzung eine Eingabe benötigt, fertig wird oder fehlschlägt, und löst den Notification-Hook mit dem Typ agent_needs_input oder agent_completed aus. ← und /exit innerhalb von claude attach <id> kehren zur Agentenansicht zurück, statt zur Shell zu beenden; Ctrl+Z kehrt zur Shell zurück. Eine Hintergrundsitzung, die ihre Arbeit in einem Worktree isoliert hat, committet, pusht ihren eigenen isolierten Branch, niemals main oder master, und öffnet einen Draft-Pull-Request, wenn sie fertig ist, statt vorher nachzufragen. /login läuft in der Agentenansicht und öffnet den Anmeldedialog. Der Beenden-Dialog Background work is running bietet Move to background and exit an. Die Übergabe beim Beenden umfasst auch Hintergrund-Subagenten, die beim nächsten Aufwecken aus ihrem Transkript fortgesetzt werden, statt als fehlgeschlagen gemeldet zu werden. claude --bg in Kombination mit -p oder --print wird mit einem Fehler abgelehnt. Der Host für Hintergrundsitzungen fordert beim ersten LAN-Zugriff die macOS-Berechtigung für das lokale Netzwerk an, statt mit connect: no route to host fehlzuschlagen.
v2.1.196 Ein einziges Drücken von ← verschiebt eine Vordergrundsitzung in den Hintergrund; frühere Versionen erforderten zwei Tastendrücke, mit einem Hinweis in der Fußzeile und einer Bestätigung. An claude agents übergebenes --dangerously-skip-permissions zeigt den Bypass-Hinweis an, statt unbemerkt verworfen zu werden. Interaktive Sitzungen, die Sie nie benannt haben, tragen in Sitzungslisten und in claude agents --json einen Standardnamen wie my-app-3f. Hintergrund-Shell-Befehle und dynamische Workflows überstehen das Stoppen, Neustarten oder Aktualisieren des Sitzungsprozesses, auch unter Windows; setzen Sie CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1, um die Übergabe zu deaktivieren. Ein Transkript, das beim Neustart fälschlich als leer gelesen wird, wird mit einem .orphaned--Suffix umbenannt statt gelöscht.
v2.1.195 Laufende Arbeit wird auch unter Windows übernommen, wenn Sie eine Sitzung in den Hintergrund verschieben; setzen Sie CLAUDE_DISABLE_ADOPT=1, um sie stattdessen zu stoppen. Die Gruppe Completed füllt den verbleibenden vertikalen Platz, und die Kopfzeile wird auf kurzen Terminals kompakter. Eine ältere Claude-Code-Version verwirft keine state.json-Felder neuerer Sitzungen mehr und blendet diese Sitzungen nicht mehr in claude agents aus. Das Verbinden mit einer gestoppten Sitzung wechselt sofort, statt bis zu fünf Sekunden lang einen leeren Bildschirm anzuzeigen. Ein Supervisor, der keine Verbindungen annehmen kann, beendet sich und gibt seine Sperre selbstständig frei.
v2.1.191 claude --bg mit einem --agent-Namen, der keinem Ihrer Subagenten entspricht, lässt den Start fehlschlagen: Die Sitzung beendet sich sofort mit einem --agent '<name>' not found-Fehler, statt mit dem Standard-Agenten zu laufen.
v2.1.174 Hintergrundsitzungen erben keine Gateway-Endpunkt-Variablen wie ANTHROPIC_BASE_URL mehr aus der Start-Shell des Supervisors; der Supervisor liefert vorab gestarteten Workern einen frischen Snapshot der Anmeldedaten, wodurch fälschliche Could not resolve authentication method-Fehler behoben werden.
v2.1.172 /model in der Dispatch-Eingabe legt eine sitzungsbezogene Überschreibung des Dispatch-Modells fest.
v2.1.161 Zeilenzusammenfassungen zeigen eine done/total-Anzahl für parallele Arbeitselemente; das Peek-Panel nennt das am längsten laufende parallele Arbeitselement.
v2.1.157 claude agents akzeptiert --agent; gestartete Sitzungen berücksichtigen die Einstellung agent.
v2.1.145 Sprachdiktat wird im Antwort-Eingabefeld des Peek-Panels und in der Dispatch-Eingabe unterstützt.
v2.1.143 Einstellung worktree.bgIsolation hinzugefügt; claude agents akzeptiert --allow-dangerously-skip-permissions.
v2.1.142 claude agents akzeptiert --permission-mode, --model, --effort, --dangerously-skip-permissions, --settings, --add-dir, --plugin-dir, --mcp-config und --strict-mcp-config.
v2.1.141 claude agents akzeptiert --cwd, um die Liste auf ein Projekt zu beschränken.
v2.1.139 Agentenansicht als Research Preview eingeführt.