Mehrere Agenten mit der Agenten-Ansicht verwalten

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.

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.

Die Agenten-Ansicht ist eine Forschungsvorschau. Die Benutzeroberfläche und Tastaturkürzel können sich ändern, wenn sich die Funktion weiterentwickelt.

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 die vollständige Konversation 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.

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 einem Eingabefeld 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 geöffnet haben, indem Sie eine Sitzung mit ← in den Hintergrund verschoben haben, kehrt Esc stattdessen zu dieser Konversation zurück. Ihre Sitzungen laufen weiter, während Sie weg sind, und erscheinen erneut, wenn Sie die Agenten-Ansicht das nächste Mal öffnen.

Eine Sitzung versenden

Geben Sie einen Prompt ein, der eine Aufgabe beschreibt, und drücken Sie Enter. Eine neue Hintergrund-Sitzung startet mit dieser Aufgabe und wird als Zeile angezeigt, die zeigt, ob sie arbeitet, auf Sie wartet oder erledigt ist. Die neue Sitzung verwendet das Modell, das in der Kopfzeile der Agenten-Ansicht angezeigt wird. In welchem Berechtigungsmodus sie startet, hängt davon ab, wie Sie die Agenten-Ansicht geöffnet haben.Jeder Prompt, den Sie hier eingeben, startet seine eigene neue Sitzung. Wenn Sie einen weiteren Prompt eingeben und Enter drücken, wird eine zweite Sitzung neben der ersten gestartet, anstatt eine Folgenachricht an diese zu senden. Sie können auf diese Weise mehrere parallel ausführen.Jede Sitzung nutzt Ihr Abonnementkontingent unabhängig, lesen Sie daher Einschränkungen, bevor Sie viele auf einmal versenden.

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.

Anhängen und Abhängen

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

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. Öffnen Sie daher 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 ← in einem leeren Eingabefeld, um sie in den Hintergrund zu verschieben und die Agenten-Ansicht in einem Schritt zu öffnen. In einer neuen Sitzung ohne Nachrichten fordert /bg Sie auf, 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.

In einer regulären claude-Sitzung öffnet das Drücken von ← in einem leeren Eingabefeld die Agenten-Ansicht, und ein ←-Hinweis in der Fußzeile informiert über Ihre Hintergrund-Sitzungen:

Hinweis: Die Fußzeile zeigt ← for agents zehn Sekunden lang an, nachdem die Sitzung geöffnet wurde. Das Drücken von ← funktioniert auch weiterhin, nachdem der Hinweis verschwunden ist
Anzahl wartender Sitzungen: Während Hintergrund-Sitzungen auf Ihre Eingabe warten, zählt dieselbe Stelle sie, z. B. ← 2 agents, oder ← 99+ agents, wenn mehr als 99 warten. Die Anzahl wird etwa alle zehn Sekunden aktualisiert, während das Terminal fokussiert ist, und sofort, wenn der Fokus zurückkehrt
Anzahl abgeschlossener Sitzungen: Wenn Hintergrund-Sitzungen erfolgreich abgeschlossen werden, während keine auf Ihre Eingabe wartet, zeigt die Fußzeile kurzzeitig an, wie viele abgeschlossen wurden, z. B. ← 2 done für zwei

Die Anzahl wartender Sitzungen ändert kurzzeitig die Farbe, wenn sie steigt oder sinkt und wenn eine Hintergrund-Sitzung erfolgreich abgeschlossen wird. Wenn Sie prefersReducedMotion aktivieren, sehen Sie weder den Farbwechsel noch die done-Anzahl. Im Bildschirmlesemodus sind der ←-Hinweis und seine Zählungen ausgeblendet.

Agenten-Ansicht standardmäßig öffnen

Damit claude ohne Argumente die Agenten-Ansicht statt einer neuen Konversation öffnet, aktivieren Sie eine /config-Einstellung.

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

Starten Sie Claude Code

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

claude

Die Agenten-Ansicht öffnet sich statt einer neuen Konversation.

Um eine reguläre Sitzung zu starten, während die Einstellung aktiviert ist, übergeben Sie einen Prompt: claude "fix the login test". Um die Einstellung auszuschalten, führen Sie /config defaultToAgentsView=false in einer regulären Sitzung oder in einer Sitzung 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          all checkpoints cleared ×12                in 4m

Completed
  ✻ title screen              menu, options, and credits done               9m
  ∙ sound effects             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 Berechtigungsentscheidung oder eine andere Abfrage, die nur Sie beantworten können, wie z. B. eine Sandbox-Abfrage, um einen Netzwerk-Host zuzulassen, oder die Anfrage nach Eingaben eines MCP-Servers. 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 Ihren nächsten Prompt
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

Davon getrennt hat die Form des Symbols eine eigene Bedeutung:

Form	Was es bedeutet
`✻` oder animiert `✽`	Der Sitzungsprozess läuft, oder die Sitzung benötigt Ihre Eingabe
`∙`	Der Prozess wurde beendet. Sie können die Zeile immer noch einsehen, und wenn Sie antworten oder anhängen, startet Claude ihn aus seiner gespeicherten Konversation neu
`✢`	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 lösen den Notification-Hook mit dem Typ agent_needs_input oder agent_completed aus. 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 ihren 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 jeder Turn endet. Eine arbeitende Zeile zeigt, was die Sitzung nach eigener Aussage tut, und eine blockierte Zeile zeigt die Frage, die sie stellt. Während eines langen Turns schreibt das Modell die Zusammenfassung auch alle paar Minuten neu, damit eine beschäftigte Zeile keine veraltete Zusammenfassung 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 Zusammenfassung am Ende eines Turns und jede Umschreibung während eines Turns sind jeweils 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 Folgenachricht 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 noch 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 Wiederholungsversuch 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 Checks oder Review, oder Checks fehlgeschlagen
Grün	Checks bestanden und kein Review blockiert
Lila	Gemergt
Grau	Entwurf oder geschlossen

Überprüfen Sie für eine Aufgabe, die in einem Pull Request endet, dieses Label auf das Ergebnis: Prüfen und mergen Sie den Pull Request, 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 oder im abgesicherten Modus läuft, erscheint darunter eine weitere Zeile:

Eine Zeile wie waiting 3m: wie lange die Sitzung bereits auf Sie wartet. Das Alter am rechten Rand der Zeile ist eine andere Zahl: Es zählt ab dem Start der Sitzung
safe mode · customizations are off: Diese Sitzung läuft mit deaktivierten Anpassungen, weil Sie sie aus Ihrer Shell mit claude --bg --safe-mode gestartet haben. Sie können sie so belassen. Um die Konversation mit wieder aktivierten Anpassungen fortzusetzen, führen Sie claude stop <id> und dann claude --resume aus, beide in Ihrer Shell

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: /model, /effort, /rename und /usage werden sofort ausgeführt. Andere Antworten werden in die Nachrichtenwarteschlange der Sitzung eingereiht, anstatt die laufende Antwort zu unterbrechen, und werden wirksam, wenn auch Eingaben in der Warteschlange wirksam werden. Andere Befehle warten, bis der Turn endet, selbst solche, die sofort ausgeführt werden, wenn Sie sie 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, um 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. Wenn eine Antwort nicht zugestellt werden kann, gibt die Fehlermeldung an, ob sie gespeichert wurde. Eine Antwort mit dem Präfix ! oder / wird nie gespeichert. Claude Code sendet eine gespeicherte Antwort als nächsten Prompt der Sitzung, wenn Sie die Sitzung das nächste Mal neu starten; senden Sie jede andere Antwort erneut. Wenn Sprachdiktat im Haltemodus aktiviert ist, halten Sie Ihre Push-to-Talk-Taste gedrückt, 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 einzusehen, 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, Tastenkombinationen 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 verschwindet, wenn Sie anhängen. /mcp reconnect <server>, /mcp enable und /mcp disable funktionieren in jedem Fall ohne Anhängen. Angehängte Sitzungen werden immer im Vollbildmodus gerendert, unabhängig von Ihrer tui-Einstellung, da eine Hintergrund-Sitzung keinen Terminal-Scrollback hat, an den angefügt werden kann. Scrollen Sie mit PgUp, PgDn oder dem Mausrad, und drücken Sie Ctrl+O für den Transkript-Modus. Das native Scrollen Ihres Terminals und der tmux-Kopiermodus zeigen nur den aktuellen Viewport, genau wie bei jeder anderen Vollbildanwendung. Eine angehängte Sitzung meldet ihren Status nicht an Ihr Terminal. Drücken Sie ← bei einem leeren Prompt 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 auch, während das /btw-Overlay offen ist. Erfordert Claude Code v2.1.257 oder später. Eine Nebenfrage, die noch beantwortet wird, 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. Wenn Sie unter Windows ← 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 Zeitfenster einen Tastendruck von vor dem Anhängen erneut liefern kann. Drücken Sie ← erneut, um zu trennen. Ctrl+Z trennt ebenfalls, kehrt aber stattdessen dorthin zurück, wo Sie angefangen haben: zur Agent-Ansicht, wenn Sie von dort angehängt haben, oder zu Ihrer 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 im angehängten Zustand sein Standard-Unterbrechungsverhalten bei: Es bricht eine laufende Antwort oder einen !-Shell-Befehl ab, anstatt zu trennen. Zweimaliges Drücken von Ctrl+C bei einem leeren Prompt trennt. Das Trennen stoppt niemals eine Hintergrund-Sitzung: ←, Ctrl+Z, /exit und doppeltes Ctrl+C oder doppeltes Ctrl+D lassen sie alle laufen. Wenn Sie trennen, während ein /loop auf seine nächste Iteration wartet, läuft die Schleife weiter und diese Iteration startet planmäßig ohne Sie. Um die Schleife vor dem Trennen zu stoppen, siehe Schleife stoppen. 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, also einer, die Sie im Terminal gestartet haben, anstatt sie aus der Agent-Ansicht anzuhängen, verschiebt das Drücken von ← bei einem leeren Prompt sie in den Hintergrund und öffnet die Agent-Ansicht mit dieser Zeile ausgewählt, sodass Sie Sitzungen wechseln können, ohne das Terminal zu verlassen. Derselbe einzelne Tastendruck trennt eine angehängte Sitzung. Wenn Sie ← direkt nach dem Löschen des letzten Textes im Prompt oder dem Durchblättern des Prompt-Verlaufs drücken, bittet Claude Code Sie um Bestätigung: Der erste Tastendruck zeigt Press ← again to open agents oder Press ← again to go back to agents in einer angehängten Sitzung, und der zweite Tastendruck wechselt. Wenn ← eine Vordergrund-Sitzung in den Hintergrund verschiebt, zeigt die Agent-Ansicht Your conversation moved to the background über der Liste, mit der Zeile dieser Sitzung 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 fortsetzt. Claudes Aufgabenliste wird mit der Konversation in die Hintergrund-Sitzung verschoben, sodass die Checkliste intakt ist, wenn Sie zu dieser Zeile zurückkehren. Die Zeile, von der aus Sie ← gedrückt haben, 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, während Sie ← drücken, wartet Claude Code, bis es fertig ist, bevor es in den Hintergrund verschiebt, 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 laufende Hintergrundarbeit nicht in die Hintergrund-Sitzung übertragen werden kann, zeigt Claude Code zuerst den Background this session?-Dialog, genau wie bei /background. Nach etwa zehn Sekunden verschiebt Claude Code die Sitzung in den Hintergrund, ohne länger zu warten, außer in Fällen wie diesen:

Subagenten im Vordergrund laufen noch: Claude Code wartet weiter, damit die Arbeit der Subagenten im Vordergrund, die Claude gestartet hat, erhalten bleibt, und zeigt Still backgrounding after the current tool an. Drücken Sie erneut ←, um ohne Warten in den Hintergrund zu wechseln. Dadurch werden diese Subagenten von vorn neu gestartet.
Eine Berechtigungsabfrage oder Frage wartet auf Ihre Antwort: Während eine Berechtigungsabfrage oder eine Frage, die Claude gestellt hat, wartet, wartet Claude Code weiter und zeigt Still backgrounding after the current tool — a question is waiting for your answer. Wenn Ihre Antwort den Turn fortsetzen lässt, z. B. Yes bei einer Berechtigungsabfrage, verschiebt Claude Code die Sitzung in den Hintergrund, sobald das aktuelle Tool fertig ist.
Sie tippen in die Prompt-Eingabe: Claude Code bricht den Wechsel ab, da ungesendeter Text im Eingabefeld Ihres Terminals bleibt und nicht in die Hintergrund-Sitzung verschoben würde. Es zeigt Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again. Claude arbeitet im Vordergrund weiter.
Sie stoppen den Turn: Claude Code bricht den Wechsel ab und zeigt Backgrounding cancelled — the turn was stopped. Der Turn stoppt beispielsweise, wenn Sie Claude mit Esc unterbrechen oder bei einer Berechtigungsabfrage aus der Hauptkonversation No ohne Kommentar auswählen, oder wenn Sie bei einer Frage, die Claude dort stellt, Esc drücken. Drücken Sie ← erneut, um die Sitzung in den Hintergrund zu verschieben.
Eine Nachricht in der Warteschlange kann nicht verschoben werden: Nachrichten, die Sie in die Warteschlange gestellt haben, während Claude gearbeitet hat, werden mit der Konversation in die Hintergrund-Sitzung verschoben. Wenn das bei einer davon nicht möglich ist, bleibt die Sitzung im Vordergrund und Claude Code zeigt einen Hinweis wie Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.

Wenn Claude Code die Sitzung in den Hintergrund verschiebt, entweder nach etwa zehn Sekunden oder nachdem Sie ← erneut gedrückt haben, stoppt es einen Shell-Befehl, den Claude noch im Vordergrund ausführt. Claude Code zeigt für diesen Befehl nicht den Background this session?-Dialog. In der Hintergrund-Sitzung hat Claude keine Aufzeichnung darüber, dass der Befehl gestartet wurde, daher führt Claude den Befehl möglicherweise erneut aus. Damit der Befehl weiterläuft, wenn die Sitzung verschoben wird, drücken Sie Ctrl+B, um ihn in einen Hintergrundbefehl umzuwandeln, solange Claude Code noch wartet. Das Drücken von ← erstellt die Zeile der Sitzung, auch wenn die Konversation noch keine Nachrichten hat, sodass → immer noch zu ihr zurückkehrt. Sie können diese Tastenkombination für Vordergrund-Sitzungen mit der leftArrowOpensAgents-Einstellung in /config ausschalten. Wenn Sie genau in dem Moment, in dem die Sitzung in den Hintergrund wechselt, einen Prompt oder !-Shell-Befehl eingeben, wird er gestoppt oder nicht gesendet:

Gesendet, während sich die Konversation schließt: Die Antwort oder der Befehl stoppt, wenn sich die Konversation schließt und die Agent-Ansicht öffnet
In diesem Moment noch auf Hooks wartend: Der Prompt wird nicht gesendet, und nichts auf dem Bildschirm weist darauf hin. Dies schließt einen Prompt ein, den Sie eingegeben haben, während SessionStart-Hooks noch liefen

In beiden Fällen bleibt der eingegebene Text im Prompt-Verlauf erhalten. Um ihn erneut zu senden, öffnen Sie die in den Hintergrund verschobene Sitzung und drücken Sie ↑ in deren Prompt, um den Text zurückzuholen.

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, der ein Review benötigt oder fehlschlagende Checks 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
Drücken Sie Ctrl+X, um eine Sitzung zu stoppen, und Ctrl+X erneut innerhalb von zwei Sekunden, um sie aus der Liste zu löschen, oder Esc, um die Bestätigung zu schließen, ohne zu löschen. Der zweite Tastendruck löscht die Sitzung auch, wenn der Stoppversuch fehlschlägt, z. B. weil der Hintergrund-Service nicht reagiert. In diesem Fall bleibt die Bestätigung für weitere zwei Sekunden aktiv, und das Löschen beendet den Prozess der Sitzung selbst

Wenn Sie Ctrl+X auf einem Gruppen-Header drücken, werden alle Sitzungen in dieser Gruppe nach Bestätigung gelöscht. 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. 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 auf Ihrem lokalen Computer, verfügbar über claude --resume. Abgeschlossene Sitzungen, die nicht auf den Bildschirm passen, werden in eine … N more-Zeile zusammengefasst. Die Completed-Gruppe füllt den vertikalen Platz, der nach den Live-Gruppen verbleibt. Auf einem kurzen Terminal wird der Header zu einer einzelnen Zusammenfassungszeile komprimiert, sodass Sitzungen, die arbeiten oder Eingaben benötigen, sichtbar bleiben.

Eine vergangene Sitzung zurückholen

Um eine Sitzung zurückzuholen, geben Sie /resume in die Versand-Eingabe ein. Eine Auswahl ö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. Drücken Sie Enter, um die ausgewählte Sitzung als Hintergrund-Sitzung fortzusetzen, damit sie als Zeile wieder in die Liste aufgenommen wird. /resume schlägt mit isn't available in agent view fehl, wenn:

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

Wenn Sie nach /resume etwas eingegeben haben, geben Sie den Befehl ohne diesen Zusatz erneut ein. Wenn Sie eines dieser Flags verwendet haben, führen Sie claude agents in Ihrer Shell ohne das Flag aus und geben Sie dann nur /resume ein.

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 erster Prompt 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 ein Treffer ist ausgewählt, sodass Enter ihn öffnet. Leeren Sie die Eingabe, um den Filter zu entfernen, und diese Gruppen werden wieder eingeklappt.

Tastenkombinationen

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

Tastenkombination	Aktion
`↑` / `↓`	Zwischen Zeilen wechseln
`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 im Haupt-Prompt
`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 Verzeichnis der fokussierten Sitzung 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 lösen
`Ctrl+F`	Sitzungen nach Namen finden, mit dem `n:`-Filter
`Alt+↑` / `Alt+↓`	Zum vorherigen oder nächsten Gruppen-Header springen
`Ctrl+R`	Ausgewählte Sitzung umbenennen
`Ctrl+G`	Versand-Prompt 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 geöffnet haben, indem Sie Ihre Sitzung mit `←` in den Hintergrund verschoben haben, kehrt das letzte `Esc` zu dieser Konversation zurück, anstatt zu beenden. Bei aktiviertem Vim-Editor-Modus wechselt `Esc` in der Eingabe vom INSERT- in den NORMAL-Modus und behält Ihren Text, wie im Haupt-Prompt
`Ctrl+C`	Eingabe löschen; zweimal drücken, um zu beenden. Wenn Text auf dem Bildschirm ausgewählt ist, hebt der Tastendruck stattdessen die Auswahl auf und kopiert sie zuvor, sofern das Auswählen sie nicht bereits kopiert hat
`?`	Tastenkombinationen anzeigen

Die Tastenkombinationen, die eine Aktion im Agents-Kontext haben, folgen Ihrer keybindings.json. Das gilt auch für Ctrl+G, über die Chat-Kontext-Bindung chat:externalEditor.

Neue Agenten versenden

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

Einen Agenten aus der Agenten-Ansicht versenden

Geben Sie einen Prompt in das Eingabefeld am unteren Rand der Agenten-Ansicht ein und drücken Sie Enter, um eine neue Hintergrund-Sitzung zu starten. Die Sitzung wird automatisch anhand des Prompts benannt. Sie können sie später mit Ctrl+R umbenennen. Der automatische Name ist eine kurze Bezeichnung, die von einem Modell der Haiku-Klasse geschrieben wird. Ein Name, den die Sitzung später erhält, wird ebenfalls in ihrer Zeile angezeigt, einschließlich des generierten Titels, den die Sitzung erhält, wenn Sie in dieser Sitzung einen Plan akzeptieren. Fügen Sie ein Bild in den Prompt ein, um der Aufgabe einen Screenshot oder ein Diagramm beizufügen. 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. Stellen Sie Teilen des Prompts ein Präfix voran oder erwähnen Sie sie, um zu steuern, wie die Sitzung startet:

Eingabe	Effekt
`<agent-name> <prompt>`	Wenn das erste Wort dem Namen eines benutzerdefinierten Subagenten entspricht, wird dieser Subagent als Hauptagent der Sitzung mit der Konfiguration aus seinem Frontmatter ausgeführt
`@<agent-name>`	Erwähnen Sie einen benutzerdefinierten Subagenten an beliebiger Stelle im Prompt, um ihn als Hauptagenten auszuführen
`@<repo>`	Erwähnen Sie ein Repository, um die Sitzung dort auszuführen. Siehe In ein bestimmtes Verzeichnis versenden, um zu erfahren, welche Repositorys aufgelistet werden
`/<command>`	Schlägt Skills und Befehle vor, die als Prompt versendet werden können
`! <command>`	Führen Sie einen Shell-Befehl als Hintergrund-Job aus, anstatt eine Claude-Sitzung zu starten. Der Job wird als Zeile angezeigt, an die Sie sich anhängen, die Sie beobachten und von der Sie sich wieder trennen können
`#<number>` oder eine Pull- oder Merge-Request-URL	Wenn bereits eine Sitzung an diesem Pull Request oder Merge Request arbeitet, wählt Claude Code deren Zeile aus, anstatt eine neue Sitzung zu versenden

Einige wenige Befehle werden in der Agenten-Ansicht selbst ausgeführt, anstatt versendet zu werden:

/exit und /quit schließen die Agenten-Ansicht
/logout meldet Sie ab
/model, /effort und /fast legen fest, womit die Sitzungen starten, die Sie als Nächstes versenden. /effort und /fast erfordern Claude Code v2.1.299 oder später.
/login öffnet den Anmeldedialog, damit Sie sich erneut anmelden können, ohne sich an eine Sitzung anzuhängen
Ein einfaches /resume oder sein Alias /continue öffnet eine Auswahl der vergangenen Sitzungen des Repositorys, um eine davon als Hintergrund-Sitzung zurückzuholen

Skills, Ihre eigenen Befehle und Prompt-erweiternde integrierte Befehle wie /init werden als erster Prompt an eine neue Hintergrund-Sitzung gesendet. Der Hinweis isn't available in agent view bedeutet, dass der eingegebene integrierte Befehl nicht ausgeführt wurde. Um ihn auszuführen, hängen Sie sich an eine Sitzung an und geben Sie ihn dort ein. Alles, was Sie eingegeben haben, bleibt neben dem Hinweis im Eingabefeld, damit Sie es bearbeiten können. Wenn Sie eine wiederkehrende Aufgabe als Skill verpacken, können Sie denselben Workflow wiederholt aus der Agenten-Ansicht starten, ohne den Prompt 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 ebenfalls, sodass ein Prompt, der zufällig 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 den Prompt 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 eine der folgenden Möglichkeiten:

Öffnen Sie claude agents in diesem Verzeichnis.
Öffnen Sie claude agents in einem übergeordneten Verzeichnis und erwähnen Sie ein untergeordnetes Repository mit @<repo> im Prompt. Wenn Sie @ eingeben, werden diese Ziele aufgelistet:
- Git-Repositorys eine Ebene unterhalb des Startverzeichnisses
- Die registrierten Git-Worktrees des Repositorys, aus dem Sie gestartet haben, die sich innerhalb seines Verzeichnisbaums befinden, etwa die, die Claude unter .claude/worktrees/ erstellt, gekennzeichnet mit ihrem ausgecheckten Branch. Worktrees, die außerhalb des Repositorys hinzugefügt wurden, etwa 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.
Wechseln Sie in der Shell mit cd in das Verzeichnis und führen Sie claude --bg "<prompt>" aus.

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

Eine Sitzung in den Hintergrund senden oder kopieren

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

Die Sitzung in den Hintergrund senden

Führen Sie /background oder seinen Alias /bg aus, um die aktuelle Konversation in eine Hintergrund-Sitzung zu verschieben. Übergeben Sie einen Prompt wie /bg run the test suite and fix any failures, um zuvor noch eine weitere Anweisung zu geben. Wenn Claude gerade antwortet, während Sie /bg ausführen, wird die Antwort in der Hintergrund-Sitzung fortgesetzt. Das Beenden einer Sitzung, in der noch Hintergrundarbeit läuft, etwa 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 mit /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 in der Liste bereits den Namen der Konversation trägt, 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 die aktuelle Konversation in eine neue Hintergrund-Sitzung zu kopieren, während das Original weiterläuft. Die Kopie beginnt mit allem, was bis zu diesem Zeitpunkt in der Konversation steht; wo die Kopie läuft, erfahren Sie in den Aufzählungspunkten unten. Sie übernimmt außerdem das Modell, den Berechtigungsmodus, die Effort-Stufe sowie alle Verzeichnisse oder „nicht erneut fragen“-Berechtigungen, die Sie während der Sitzung hinzugefügt haben. Die Kopie erscheint als eigene Zeile in der Agenten-Ansicht. Nach dem Fork sind die beiden Konversationen unabhängig: Nichts, was die Kopie tut, gelangt von selbst in die ursprüngliche Konversation, wobei in Sitzungen, in denen sitzungsübergreifendes Messaging aktiviert ist, der Claude jeder Sitzung der anderen explizit Nachrichten senden kann. Wenn die Agenten-Ansicht ausgeschaltet ist, startet /fork einen geforkten Subagenten, anstatt die Sitzung zu kopieren. Übergeben Sie einen Prompt wie /fork open a draft pull request with the work so far, und die Kopie beginnt sofort mit der Arbeit daran. Ohne Prompt 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 an, während sie wartet. Die /fork-Bestätigung ist eine Zeile, die den Zustand der Kopie anzeigt, z. B. session running, den Namen ihrer Zeile in der Agenten-Ansicht 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, genau wie beim 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, einen eigenen Worktree zu erstellen, bevor sie Code-Änderungen vornimmt. Außerhalb eines Git-Repositorys erhält nur eine Kopie, die aus einem von einem Hook erstellten Worktree herausverschoben wurde, diese Anweisung; ohne WorktreeCreate-Hook bearbeitet die Kopie an Ort und Stelle. Eine Kopie, die aus Ihrem Worktree herausverschoben wurde, wird außerdem angewiesen, diesen Worktree niemals zu bearbeiten, darin keine Befehle auszuführen und ihn nicht zu betreten, unabhängig von der Isolationseinstellung. Wo die Kopie startet, hängt davon ab, wo die aktuelle Sitzung läuft:

Wie jede versendete Sitzung wechselt die Kopie in ihren eigenen Worktree, bevor sie Dateien bearbeitet. 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 gewechselt ist, startet die Kopie dort, wo die Sitzung vor dem Wechsel war, und nimmt ihre Code-Änderungen, sofern sie nicht an Ort und Stelle bearbeitet, dort in einem eigenen Worktree vor. Wenn in Ihrem Worktree ein Branch ausgecheckt ist, weist diese Anweisung eine Kopie, deren Aufgabe auf Ihrer Arbeit aufbaut, außerdem an, ihren neuen Branch auf Ihrem aufzubauen, 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 Repositorys gestartet haben, das eine Haupt-Arbeitskopie hat, startet die Kopie in dieser Haupt-Arbeitskopie, mit derselben Regel zum eigenen Worktree, 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 keine Haupt-Arbeitskopie, zu der sie zurückkehren kann, daher bleibt die Kopie, wo sie ist, und die Bestätigung endet mit edits this checkout. Derselbe Hinweis erscheint, wenn die Worktree-Isolation in einer Sitzung, die sich nicht in einem verknüpften Worktree befindet, ausgeschaltet ist, weil die Kopie dann die Dateien bearbeitet, die Sie geöffnet haben.

Sitzungen, die mit Start-Flags gestartet wurden, die die Kopie nicht erben würde, etwa ein ersetzter System-Prompt oder eine --tools-Allowlist, können nicht geforkt werden; Claude Code weist darauf hin, anstatt eine unvollständige Kopie zu erstellen. Eine aus der Agenten-Ansicht versendete Sitzung lässt sich normal forken: Die Kopie wird mit derselben Agenten-Definition und denselben angehängten Anweisungen gestartet wie die Sitzung, aus der sie stammt.

Was beim Verschieben in den Hintergrund übernommen wird

Wenn Sie die Sitzung in den Hintergrund verschieben, wird jede Art laufender Hintergrundarbeit entweder in die Hintergrund-Sitzung übernommen, dort nur fortgesetzt, wenn Claude sie neu startet, oder gestoppt:

Wird übernommen: Laufende Hintergrund-Shell-Befehle, in den Hintergrund verschobene Subagenten, geplante Aufgaben, die Sie mit /loop erstellt haben, und Claudes automatische Antworten auf Artefakt-Kommentare laufen in der Hintergrund-Sitzung weiter. Ein Subagent wird zusammen mit allem übertragen, was er gestartet hat, daher wird er nur übernommen, wenn all diese Arbeit ebenfalls übertragen werden kann.
Wird nur fortgesetzt, wenn Claude sie neu startet: ein laufender dynamischer Workflow. Wenn der Workflow nicht fortgesetzt wurde, wenn Sie nach der Hintergrund-Sitzung sehen, bitten Sie Claude, ihn neu zu starten.
Wird gestoppt: Arbeit, die nicht in die Hintergrund-Sitzung übertragen werden kann, etwa ein laufender Monitor. Wenn solche Arbeit läuft, zeigt Claude Code den Dialog Background this session? an, damit Sie bestätigen können, bevor die Arbeit gestoppt wird. Ein in den Hintergrund verschobener Subagent, dem ein Monitor gehört, wird zusammen mit dem Monitor gestoppt.

Sobald sich die Sitzung im Hintergrund befindet, kann sie neue Subagenten, Monitore und Hintergrund-Befehle starten, und diese laufen über spätere Trennungen und erneutes Anhängen hinweg weiter. Konfigurations-Flags aus dem ursprünglichen Start werden in die Hintergrund-Sitzung übernommen, sodass ihre MCP-Server, Einstellungen und ihr Fallback-Modell wirksam bleiben:

--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 übernommen. Die Übernahme von --allow-dangerously-skip-permissions hält bypassPermissions in der Hintergrund-Sitzung erreichbar, gewährt aber nichts Neues: Der Modus erfordert weiterhin, dass Ihre Akzeptanz des Bypass-Haftungsausschlusses hinterlegt ist. Wenn ein dynamischer Workflow nicht fortgesetzt wurde, nachdem Sie seine Sitzung in den Hintergrund verschoben haben, bitten Sie Claude, den Workflow neu zu starten. Der Lauf wird nur fortgesetzt, wenn Claude ihn in der Hintergrund-Sitzung neu startet, und Claude Code kann Sie bitten, diesen Neustart zuerst zu genehmigen. Die Konversation der Sitzung zeigt einen Hinweis an, dass der Workflow could not be resumed. Wenn Claude den Workflow neu startet, beginnen alle seine Subagenten, die beim Verschieben der Sitzung in den Hintergrund noch liefen, von vorn und verbrauchen ihre Token erneut. Wenn Sie ← drücken oder /background ausführen, während noch welche laufen, gibt der Dialog Background this session? an, wie viele es sind. Um sie zuerst fertig laufen zu lassen, wählen Sie Stay.

Einen Agenten aus Ihrer Shell versenden

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

claude --bg "investigate the flaky SettingsChangeDetector test"

Der Prompt ist das Positionsargument, kein -p-Wert. Claude Code lehnt --bg in Kombination mit -p oder --print ab, bevor eine Sitzung erstellt wird, da --print niemals die interaktive Sitzung startet, an die sich claude agents anhängt. Wenn Sie claude --bg in einem Terminal in einem Verzeichnis ausführen, dem Sie noch nicht vertraut haben, erscheint zuerst der Workspace-Vertrauensdialog, und die Sitzung startet, sobald Sie zustimmen. Wenn Sie ablehnen, wird Claude Code beendet, ohne eine Sitzung zu starten. Wo kein Dialog angezeigt werden kann, etwa in einem Skript, wird der Befehl stattdessen mit einem Workspace not trusted-Fehler beendet. Um einen bestimmten, von Ihnen definierten Subagenten, etwa einen code-reviewer, als Hauptagenten 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 gibt eine Warnung no agent named aus und meldet die Sitzung trotzdem als in den Hintergrund verschoben, aber die Sitzung wird sofort mit einem Fehler --agent '<name>' not found beendet. Wenn die Hintergrund-Sitzung später fortgesetzt oder neu gestartet wird, stellt Claude Code den Agenten und seine Tool-Einschränkungen wieder her; zu seinem System-Prompt siehe System-Prompt-Flags in fortgesetzten Konversationen. Es sucht den Agenten zuerst im eigenen Verzeichnis der Sitzung, sofern Sie diesem Workspace vertraut haben, sodass ein projektbezogener Agent auch dann 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 ihr Transkript beginnt mit einer Warnung, die den Agenten nennt. Um eine vorhandene Konversation im Hintergrund fortzusetzen, übergeben Sie ihre vollständige Sitzungs-ID mit --resume:

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

Ab Claude Code v2.1.257 setzt Claude Code diese Sitzung entweder unter derselben ID fort oder startet eine Kopie unter einer neuen ID und gibt eine note:-Zeile aus, die erklärt, warum die Sitzung 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 einfachen --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 den Hinweis. Übergeben Sie --name, um anstelle des automatisch generierten Namens den Anzeigenamen der Sitzung in der Agenten-Ansicht festzulegen:

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

Nach dem Verschieben in den Hintergrund gibt Claude die kurze ID der Sitzung und die Befehle zu ihrer Verwaltung aus. Wenn der Dienst, der Hintergrund-Sitzungen hostet, noch nicht läuft, gibt --bg möglicherweise zuerst Starting background service… oberhalb dieser Ausgabe aus. Wenn Sie --name übergeben, erscheint der Name nach der kurzen ID:

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

Prompts, die `--bg` enthalten

Ein Prompt, der --bg oder --background erwähnt, wird so zugestellt, wie Sie ihn eingegeben haben, und ebenso eine Antwort --bg, die Sie an eine Hintergrund-Sitzung senden. Beispielsweise startet dieser Befehl eine Hintergrund-Sitzung, und das zweite --bg ist Teil ihres Prompts:

claude --bg "find out why --bg sessions are slow to start on this machine"

Claude Code liest ein ganzes Argument nur dort als Flag, wo ein Flag stehen kann: vor einem einfachen ---Trennzeichen und nicht an einer Stelle, an der ein anderes Flag seinen Wert erwartet. Setzen Sie das Flag an den Anfang, wie in claude --bg "<prompt>". Wo die Position mehrdeutig ist, etwa nach einer Folge kombinierter Kurz-Flags, startet Claude Code nichts. Es wird stattdessen mit Couldn't tell whether --bg is a flag or text here beendet.

Einen Shell-Befehl ausführen

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

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

In der Agenten-Ansicht versenden Sie dieselbe Art von Job, indem Sie ! als erstes Zeichen in das Versand-Eingabefeld eingeben: Das ! wird als Präfix angezeigt, alles danach ist der Befehl, und Enter startet den Job. Der Befehl läuft als PTY-gestützter Job und erscheint als Zeile in der Agenten-Ansicht, mit der jeweils letzten Ausgabezeile als Status. Ein Shell-Job führt den Befehl anstelle von Claude aus, sodass kein Modell aufgerufen wird und die Ausgabe an keine Sitzung gesendet wird. Um die Ausgabe zu sehen, hängen Sie sich an die Zeile an, drücken Sie Space, um einen Blick darauf zu werfen, ohne sich anzuhängen, oder führen Sie claude logs <id> in Ihrer Shell aus. Die erfasste Ausgabe bleibt im Arbeitsspeicher und wird nicht auf die Festplatte geschrieben. Die Zeile und ihre Ausgabe werden etwa fünf Minuten nach Beenden des Befehls automatisch entfernt, lesen Sie sie also vorher, wenn Sie das Ergebnis benötigen.

Wie Dateibearbeitungen isoliert werden

Wenn Sie eine Hintergrund-Sitzung aus der Agenten-Ansicht versenden oder eine mit claude --bg starten, beginnt die Sitzung 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 die Worktree-Isolation für die Sitzung und für alle Subagenten, die sie startet. Claude überspringt den Worktree, wenn:

Sie eine bereits geöffnete Sitzung in den Hintergrund verschoben haben, mit ← oder /background. Diese Sitzung bearbeitet Dateien weiterhin dort, wo sie bereits gearbeitet hat
Die Sitzung sich bereits in einem verknüpften Git-Worktree befindet, unabhängig davon, ob Claude ihn unter .claude/worktrees/ erstellt hat oder Sie ihn mit git worktree add an anderer Stelle erstellt haben
Die Datei, die Claude bearbeitet, sich in einem verknüpften Git-Worktree befindet, etwa einem, 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 in die .claude/settings.json des Projekts ein:

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

Außerhalb eines Git-Repositorys schreiben Sitzungen direkt in das Arbeitsverzeichnis und sind nicht voneinander isoliert, vermeiden Sie daher 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 bei 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-Repositorys kann eine Sitzung, die Claude vor dem Bearbeiten in einen Worktree verschiebt, die Tools Edit, Write oder NotebookEdit im gemeinsamen Checkout nicht verwenden, bis dieser Wechsel erfolgt ist. Um den Worktree-Pfad einer Sitzung zu finden, hängen Sie sich an und prüfen Sie ihr Arbeitsverzeichnis. Ein Subagent, den die Hintergrund-Sitzung startet, erbt das Arbeitsverzeichnis der Sitzung. Sobald sich die Sitzung in einem Worktree befindet, landen die Dateibearbeitungen des Subagenten in diesem Worktree statt in Ihrer Arbeitskopie. Um einem Subagenten stattdessen einen eigenen separaten Worktree zu geben, setzen Sie isolation: worktree in seinem Frontmatter oder übergeben Sie isolation: "worktree" beim Starten. Wenn eine Hintergrund-Sitzung Code-Änderungen in einem Worktree vorgenommen hat, den Claude betreten hat, weist Claude Code Claude an, die Arbeit vor dem Abschluss zu sichern, damit sie erhalten bleibt, wenn Sie die Sitzung und ihren Worktree löschen:

Commit und Push: Claude committet, ohne zu fragen, und pusht den Branch, wenn das Repository ein Remote hat.
Pull Request als Entwurf: Claude öffnet einen, wenn die Aufgabe es erfordert, und das #N-Label erscheint in der Zeile.
Niemals: Pushen nach main oder master, Force-Push und Mergen.
Ihre Git-Anweisungen haben Vorrang: Wenn die Aufgabe, CLAUDE.md oder Memory besagt, dass Sie das Committen oder Pushen selbst übernehmen, überlässt Claude Git Ihnen.

Eine Sitzung, die einen Checkout bearbeitet, den sie nicht selbst isoliert hat, fragt weiterhin nach, bevor sie committet oder Branches wechselt. Das gilt, wenn die Isolation auf "none" gesetzt ist, wenn der Wechsel in den Worktree fehlgeschlagen ist oder wenn die Sitzung in einem bereits vorhandenen Worktree gestartet wurde. Unabhängig von der Aufgabe beendet Claude den Job mit einem Bericht darüber, was es getan hat und wo sich die Arbeit befindet: ein Pfad, ein Branch, ein Pull Request oder die Antwort selbst.

Was das Löschen einer Sitzung entfernt

Löschen Sie eine Sitzung durch zweimaliges Drücken von Ctrl+X in der Agenten-Ansicht oder mit claude rm. Außer in den unten beschriebenen Fällen, in denen sie beibehalten wird, verschwindet die Sitzung aus der Liste. Ihr Transkript bleibt über claude --resume auf Ihrem Rechner verfügbar, und die Entfernung bleibt auch nach Supervisor-Neustarts bestehen. Was mit einem Worktree geschieht, den Claude für die Sitzung erstellt hat:

Die Agenten-Ansicht entfernt ihn, einschließlich nicht committeter Änderungen, committen Sie also zuerst, was Sie behalten möchten.
claude rm behält ihn zusammen mit der Sitzungszeile, wenn er nicht committete Änderungen enthält.
Weder die Agenten-Ansicht noch claude rm entfernen einen Worktree, den eine andere laufende Sitzung verwendet oder gesperrt hat, und erneutes Löschen ändert daran nichts. Claude Code behält den Worktree und die Sitzung und nennt das beibehaltene Verzeichnis und den Grund; in der Agenten-Ansicht zeigt die Zeile der Sitzung not deleted. Schließen Sie die andere Sitzung und löschen Sie dann erneut.
Wenn Sie eine Sitzung löschen, deren Worktree Commits enthält, bei denen Claude Code nicht bestätigen kann, dass sie an anderer Stelle gesichert sind, behält Claude Code den Worktree und die Sitzung, und die Meldung nennt den Branch des Worktrees und die Anzahl der nicht gepushten Commits. Die Meldung bietet außerdem die zwei möglichen Wege an: die Commits pushen oder erneut löschen, um sie zu verwerfen. Commits auf einem Remote blockieren das Löschen nicht. Ebenso wenig Commits auf der lokalen Kopie des Standard-Branches Ihres origin-Remotes, solange dieser Branch in Ihrem Haupt-Checkout ausgecheckt ist, also im Repository-Verzeichnis selbst und nicht in einem Worktree. Nach dieser Ablehnung haben Sie die Wahl:
- Um die Commits zu behalten, pushen Sie sie oder mergen Sie sie in diesen Standard-Branch und löschen Sie die Sitzung dann erneut.
- Um sie zu verwerfen, löschen Sie die Sitzung erneut, ohne zu pushen: Drücken Sie zweimal Ctrl+X auf ihrer Zeile in der Agenten-Ansicht, oder führen Sie den Befehl claude rm <id> --discard-unpushed aus, den die Ablehnung ausgegeben hat. Dadurch werden die Sitzung und der Worktree samt seinem Branch entfernt, wobei die nicht gepushten Commits und alle nicht committeten Änderungen verworfen werden.
Wenn Sie erneut löschen, verwirft Claude Code nur das, was die Ablehnung angezeigt hat: Ist im Worktree seitdem ein Commit hinzugekommen, behält Claude Code ihn erneut und zeigt den aktualisierten Zustand an. Wenn die Datensätze einer anderen abgeschlossenen Sitzung den Worktree ebenfalls nennen, bleibt er beim erneuten Löschen erhalten; pushen Sie die Commits und löschen Sie dann erneut.
Ein Worktree, den Git nicht mehr erkennt, etwa 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 den Worktree nicht entfernen kann, behält Claude Code den Worktree und die Sitzung, und die Meldung nennt die Ursache. Bei einem Hook gibt die Meldung an, wie er endete, etwa exited 1, und zitiert den Anfang seiner stderr-Ausgabe. Die Meldung teilt Ihnen außerdem mit, welche der folgenden Schritte Sie als Nächstes ausführen können:
- Löschen Sie die Sitzung erneut, um das Verzeichnis trotzdem zu entfernen, indem Sie zweimal Ctrl+X auf ihrer Zeile in der Agenten-Ansicht drücken oder den Befehl claude rm <id> --force-remove-worktree <worktree-id> ausführen, den die claude rm-Ablehnung ausgegeben hat. Der Branch des Worktrees bleibt im Repository erhalten. Claude Code bietet dies nur an, wenn es alle folgenden Punkte bestätigen kann:
  - Das Verzeichnis ist einer der verknüpften Worktrees des Repositorys unter .claude/worktrees/
  - Weder der Worktree noch ein ausgechecktes Submodul enthält nicht committete Änderungen an verfolgten Dateien
  - Kein Datensatz einer anderen Sitzung nennt ihn
  Wenn Claude Code den Zustand eines Submodul-Checkouts nicht überprüfen kann, etwa eines, das durch ein separates Git-Repository ersetzt wurde, bietet es dies ebenfalls nicht an.
- Beheben Sie, was im Weg steht, etwa indem Sie die nicht committeten Änderungen committen oder stashen, ein separates Git-Repository aus dem Worktree verschieben, schließen, was das Verzeichnis verwendet, oder den Hook reparieren, und löschen Sie die Sitzung dann erneut.
- Entfernen Sie das Verzeichnis selbst und löschen Sie die Sitzung dann erneut.

Ein Worktree, den Sie selbst erstellt und in dem Sie die Sitzung gestartet haben, bleibt in jedem Fall erhalten. Eine Sitzung, deren Worktree-Verzeichnis zu keinem Git-Repository gehört, weil das Repository gelöscht wurde oder ein WorktreeCreate-Hook das Verzeichnis an anderer Stelle erstellt hat, kann trotzdem gelöscht werden. Solange sich noch Dateien im Verzeichnis befinden:

Die Agenten-Ansicht verlangt dasselbe zweimalige Drücken von Ctrl+X, bevor sie verworfen werden. Bei einem von einem Hook erstellten Verzeichnis führt sie stattdessen Ihren WorktreeRemove-Hook aus; ohne einen solchen lehnt sie das Löschen ab und behält die Sitzung.
claude rm behält die Sitzung und den Worktree und nennt den Grund.

Beide Wege behalten ein Verzeichnis, das in den Datensätzen einer anderen abgeschlossenen Sitzung genannt wird.

Modell, Effort-Stufe und Fast-Modus festlegen

Geben Sie in der Agenten-Ansicht /model, /effort oder /fast in das Versand-Eingabefeld ein und drücken Sie Enter; die Sitzungen, die Sie danach versenden, starten mit dem, was Sie festgelegt haben. Ihre Auswahl gilt für dieses Fenster der Agenten-Ansicht und wird nicht in einer Einstellungsdatei gespeichert. /effort und /fast erfordern Claude Code v2.1.299 oder später, ebenso /model ohne nachfolgende Eingabe. Geben Sie den Wert nach dem Befehl an, oder geben Sie nur den Befehl ein, um einen Wert aus einer Liste auszuwählen:

Modell: /model <name>, zum Beispiel /model opus
Effort-Stufe: /effort mit low, medium, high, xhigh oder max, zum Beispiel /effort high. Um Sitzungen in ultracode zu starten, öffnen Sie die Agenten-Ansicht stattdessen aus Ihrer Shell mit claude agents --effort ultracode; das Versand-Eingabefeld akzeptiert /effort ultracode nicht
Fast-Modus: /fast on oder /fast off. Die Sitzung startet nur dann im Fast-Modus, wenn der Fast-Modus für Sie verfügbar ist und ihr Modell den Fast-Modus unterstützt. Bei einem Modell, das ihn nicht unterstützt, startet die Sitzung mit ausgeschaltetem Fast-Modus; wählen Sie daher zuerst mit /model eines der Modelle, die den Fast-Modus unterstützen. Der Hinweis unter dem Eingabefeld, nicht die Kopfzeile, bestätigt, ob neue Sitzungen den Fast-Modus erhalten.

Um eine Auswahl rückgängig zu machen, geben Sie default als Wert an, zum Beispiel /effort default. Das folgende Beispiel versendet eine Sitzung mit Opus und die nächste mit Sonnet:

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

Jede Hintergrund-Sitzung kann ein anderes Modell verwenden. Um es für eine einzelne Sitzung zu überschreiben:

Übergeben Sie in der Shell --model zusammen mit claude --bg.
Hängen Sie sich an eine laufende Sitzung an und führen Sie /model aus, um zu wechseln. Eine Auswahl in der Auswahlliste oder ein eingegebenes /model <name> wird als Standard für neue Sitzungen gespeichert, es sei denn, Sie drücken s in der Auswahl, um nur für diese Sitzung zu wechseln. Ein Wechsel nur für diese Sitzung bleibt erhalten, wenn die Sitzung neu gestartet wird.
Versenden Sie einen Subagenten, der in seinem Frontmatter model setzt, indem Sie den Prompt mit seinem Namen beginnen oder @name erwähnen. Solange eine /model-Auswahl im Versand-Eingabefeld gilt, wird das model des Subagenten nicht verwendet; geben Sie daher dort /model default ein. Wenn Sie mit claude agents --model gestartet haben, wird das Modell des Subagenten ebenfalls nicht verwendet; führen Sie daher claude agents in Ihrer Shell ohne --model aus.

Berechtigungsmodus, Modell und Aufwand

Eine Hintergrund-Sitzung bezieht ihre Einstellungen, ihren Provider, ihren Berechtigungsmodus, ihr Modell und ihren Aufwand davon, wo und wie Sie sie versendet haben. Die folgenden Unterabschnitte behandeln jede Quelle und was erhalten 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, genau so, als hätten Sie claude dort mit den übernommenen Konfigurations-Flags gestartet. Dazu gehören env-Werte in den Projekteinstellungen, sodass eine dort gesetzte ANTHROPIC_MODEL- oder Provider-Variable für jede Hintergrund-Sitzung in diesem Verzeichnis gilt. Eine Hintergrund-Sitzung läuft außerdem mit dem PATH der Shell, aus der Sie sie versendet haben, sodass die von ihr ausgeführten Befehle dieselben Tools finden wie Ihr Terminal. Sie übernimmt auch die Cloud-Provider-Auswahl dieser Shell, etwa 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 über ein LLM-Gateway leiten, setzen Sie die Gateway-Variablen in den env-Block einer Einstellungsdatei, anstatt sie in Ihrer Shell zu exportieren; Hintergrund-Sitzungen lesen sie dann mit ihren übrigen Einstellungen. In einer Einstellungsdatei setzen zeigt den Block und welche Einstellungsdatei für die Anmeldedaten verwendet werden sollte. Wenn Sie eine Gateway-ANTHROPIC_BASE_URL stattdessen nur in Ihrer Shell exportieren, erreicht sie eine Hintergrund-Sitzung, zusammen mit den ANTHROPIC_CUSTOM_HEADERS und den Anmeldedaten, die Sie damit exportiert haben, nur dann, wenn der Supervisor selbst aus einer Shell gestartet wurde, die dasselbe Gateway exportiert hat, 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 sich an sie anhängen oder ihr antworten
Sie starten eine Sitzung in dem Verzeichnis, in dem Sie sich befinden, mit claude respawn neu

Claude Code leitet ein Gateway vor einem Cloud-Provider weiter. Wenn die Shell, aus der Sie versenden, den Provider auswählt und dessen Gateway-Endpunkt zusammen mit seinem Auth-Bypass-Flag exportiert, leitet Claude Code das Paar aus Endpunkt und Flag unter denselben Bedingungen wie bei ANTHROPIC_BASE_URL 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

Mit /bg oder ← in den Hintergrund verschoben: Claude Code behält den Berechtigungsmodus bei, in dem sich die Sitzung befand, sodass eine Sitzung, die Sie auf acceptEdits oder auto umgestellt haben, nach dem Trennen dabei bleibt
Aus einem in einer Shell gestarteten claude agents oder mit claude --bg versendet: Die neue Sitzung startet so, wie eine neue claude-Sitzung in diesem Verzeichnis starten würde, es sei denn, Sie haben sie aus einer Agenten-Ansicht versendet, die Sie mit Versand-Standardwerten geöffnet haben. In welchem Berechtigungsmodus eine Sitzung startet führt die Reihenfolge auf

Für eine Sitzung, die Sie aus einer mit ← geöffneten Agenten-Ansicht versenden, übernimmt Claude Code den Berechtigungsmodus aus dem ersten zutreffenden der folgenden Punkte:

Der permissions.defaultMode des Zielverzeichnisses. auto und bypassPermissions werden nur aus verwalteten Einstellungen, einer --settings-Datei oder ~/.claude/settings.json wirksam. Claude Code lehnt einen defaultMode aus der .claude/settings.json oder .claude/settings.local.json des Projekts ab, der einen freizügigeren Modus auswählt als den, in dem sich die Sitzung befand, aus der Sie kamen.
Der Berechtigungsmodus der Sitzung, aus der Sie kamen. Wenn sich diese Sitzung im Modus bypassPermissions befand, kann die neue Sitzung stattdessen im Manual-Modus starten, mit dem Hinweis Bypass permissions was requested at launch and ignored. Das passiert, wenn Ihre Akzeptanz des Bypass-Haftungsausschlusses nur in .claude/settings.local.json oder einer --settings-Datei hinterlegt ist. Fahren Sie im Manual-Modus fort, oder fügen Sie diese Akzeptanz zu ~/.claude/settings.json hinzu.

Wenn Claude Code den Modus einer Quelle als zu freizügig ablehnt, entscheidet die nächste Quelle in der Liste. Wenn Sie beispielsweise aus einer Sitzung im Plan-Modus in ein Verzeichnis versenden, dessen eingecheckte Einstellungen acceptEdits verlangen, startet die neue Sitzung im Plan-Modus. Wenn Sie diesen defaultMode in ~/.claude/settings.json verschieben, gilt er unabhängig vom Berechtigungsmodus der Sitzung, aus der Sie kamen. Die Freizügigkeit steigt in dieser Reihenfolge: Plan, dann Manual und dontAsk, dann acceptEdits und auto, die jeweils als freizügiger als der andere gelten, dann bypassPermissions.

Versand-Standardwerte

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

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

--effort akzeptiert hier dieselben Werte wie das Top-Level-Flag --effort, einschließlich ultracode. --agent legt den Subagenten fest, der verwendet wird, wenn ein Versand-Prompt keinen nennt, weder mit @name noch als erstes Wort. Standardmäßig wird die agent-Einstellung verwendet, sofern gesetzt, andernfalls der integrierte Allzweck-Agent claude. Wenn Sie einen Subagenten im Versand-Eingabefeld nennen, überschreibt das beides. claude agents akzeptiert außerdem --dangerously-skip-permissions als Kurzform für --permission-mode bypassPermissions sowie --allow-dangerously-skip-permissions, um bypassPermissions im Shift+Tab-Zyklus jeder versendeten Sitzung 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 wäre jede mit dem Top-Level-Flag --restricted gestartet worden. Erfordert Claude Code v2.1.248 oder später. Die aktiven Standardwerte werden in der Fußzeile unter dem Versand-Eingabefeld angezeigt. Eine Hintergrund-Sitzung, die im Modus bypassPermissions gestartet wird, erfordert, dass Ihre Akzeptanz des Bypass-Haftungsausschlusses hinterlegt ist, da dieser Modus einer Sitzung, die Sie nicht beobachten, erlaubt, ohne Genehmigung zu handeln. Wenn Sie --dangerously-skip-permissions oder --permission-mode bypassPermissions an claude agents übergeben, wird derselbe Haftungsausschluss angezeigt, sofern Sie ihn noch nicht akzeptiert haben, und durch das Akzeptieren wird bypassPermissions auf die Sitzungen angewendet, die Sie aus der Ansicht starten. Auch bei Übergabe von --allow-dangerously-skip-permissions wird derselbe Haftungsausschluss angezeigt, und durch das Akzeptieren wird bypassPermissions im Shift+Tab-Zyklus dieser Sitzungen verfügbar, ohne sie in diesem Modus zu starten.

Was über Neustarts hinweg erhalten bleibt

Der Berechtigungsmodus, das Modell und der Aufwand, die Sie für eine Hintergrund-Sitzung gewählt haben, bleiben zusammen mit den übernommenen Konfigurations-Flags erhalten, wenn der Supervisor ihren Prozess später stoppt und neu startet. Ein Modell oder Aufwand, den Sie während der Sitzung mit /model oder /effort geändert haben, bleibt ebenfalls erhalten. Wenn die Sitzung ihren Aufwand aus Ihren Einstellungen statt aus --effort oder /effort übernommen hat, liest Claude Code Ihre Einstellungen jedes Mal neu, wenn es einen Prozess für die Sitzung startet. Nachdem Sie den gespeicherten Aufwand in settings.json bearbeitet haben, erreicht die Änderung Sitzungen, die Sie mit ← oder /bg in den Hintergrund verschieben, sowie deren spätere Neustarts. Der gespeicherte Aufwand ist der Schlüssel effortLevel oder ein Eintrag in modelSettings. Claude Code behält außerdem einen Namen, den Sie mit /rename oder Ctrl+R festgelegt haben, über diesen Neustart hinweg bei, sodass Sie die Sitzung weiterhin mit claude --resume <name> erreichen können. Ein Prompt, den Sie im angehängten Zustand mit Ctrl+S zurückgestellt haben, bleibt ebenfalls bei der Sitzung erhalten. Öffnen Sie die Sitzung erneut, nachdem ihr Prozess gestoppt oder neu gestartet wurde, und drücken Sie Ctrl+S, um den zurückgestellten Text wiederherzustellen. Eingefügte Inhalte im zurückgestellten Text überstehen den Neustart nicht.

Einstellungen, Plugins und MCP-Server

Die Agenten-Ansicht akzeptiert dieselben Konfigurations-Flags 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 reicht jedes Konfigurations-Flag an die Sitzungen weiter, die Sie aus ihr versenden, sodass ein Plugin oder MCP-Server, den Sie auf diese Weise laden, in diesen Sitzungen verfügbar ist.

Flag	Effekt
`--settings <file-or-json>`	Einstellungen für die Agenten-Ansicht und versendete Sitzungen überschreiben
`--setting-sources <sources>`	Nur die genannten Einstellungsquellen laden, in der Agenten-Ansicht und in 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 einem JSON-String laden
`--strict-mcp-config`	Nur die MCP-Server aus `--mcp-config` verwenden und andere MCP-Konfigurationen ignorieren. Siehe Exklusive Kontrolle mit managed-mcp.json, um zu erfahren, was das Flag bei einer verwalteten MCP-Datei bewirkt

Wiederholen Sie --add-dir, --plugin-dir oder --mcp-config einmal pro Wert. claude agents unterstützt die durch Leerzeichen getrennte Form wie --add-dir a b c nicht. Sie können --settings, --setting-sources und --plugin-dir vor oder nach agents platzieren. Platzieren Sie --add-dir und --mcp-config nach agents: Wenn Sie eines davon vor agents setzen, 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 einen Inline-JSON-String. Ein Dateipfad muss auf eine vorhandene Datei verweisen; andernfalls wird Claude Code mit einem Settings file not found-Fehler beendet.

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\|name>`	An eine Sitzung in diesem Terminal anhängen
`claude logs <id\|name>`	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. Eine Sitzung mit einer gespeicherten Konversation setzt diese fort
`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 logs`	Der Logdatei des Supervisors, `~/.claude/daemon.log`, folgen und neue Zeilen drucken, sobald sie eintreffen, bis Sie `Ctrl+C` drücken
`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 sich der nächste Supervisor mit ihnen verbinden kann. Der nächste `claude agents` oder `claude --bg` startet einen neuen Supervisor

claude attach und claude logs akzeptieren anstelle der ID auch einen Teil des Namens einer Sitzung, wie in claude logs "auth refactor". claude attach öffnet eine Sitzung nur dann über ihren Namen, wenn ihr Prozess läuft; übergeben Sie daher stattdessen die ID, um eine gestoppte Sitzung neu zu starten. Die Angabe eines Namens erfordert Claude Code v2.1.290 oder später.

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:

Arbeitet, wartet auf eine Berechtigungsabfrage oder einen anderen Dialog oder ist angehängt: Der Prozess läuft weiter. Ein laufender Subagent, Workflow oder Monitor zählt als arbeitend, ebenso eine ausstehende sitzungsbezogene geplante Aufgabe, etwa ein /loop-Weckruf.
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 Turn beendet hat, indem sie Ihnen eine Frage gestellt hat, zählt als Warten auf Ihre nächste Nachricht. Die Konversation bleibt auf der Festplatte, und das nächste Mal, wenn Sie anhängen oder antworten, wird die Sitzung dort fortgesetzt, wo sie aufgehört hat. Heften Sie eine Sitzung mit Ctrl+T an, um ihren Prozess 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 arbeiten, auf Sie warten oder angehängt sind, werden nicht unterbrochen.
Der Supervisor selbst stoppt, beispielsweise weil sein Prozess von außerhalb von Claude Code beendet wurde: Unter macOS und Linux stoppen Ihre Sitzungen, sofern sich nicht innerhalb von etwa einer Minute ein neuer Supervisor verbindet. Um einen zu starten, führen Sie claude agents in Ihrer Shell aus. Wenn diese Minute verstrichen ist, siehe Sitzungen nach dem Stoppen des Supervisors am Laufen halten.

Wenn ein Sitzungsprozess stoppt oder neu gestartet wird, werden die Hintergrund-Shell-Befehle und Hintergrund-Subagenten, die Claude darin gestartet hat, in seinen nächsten Prozess übernommen. Ein dynamischer Workflow wird nur fortgesetzt, wenn Claude ihn neu startet. Laufende Monitore und Shell-Befehle, die ein Subagent gestartet hat, stoppen mit dem Prozess. Wenn Sie die Sitzung löschen, stoppt alles, was sie übernommen hat. Um stattdessen all dies mit dem Prozess zu stoppen, 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.

Sitzungen nach dem Stoppen des Supervisors am Laufen halten

Wenn die Agenten-Ansicht beim Beenden diesen Hinweis ausgibt, läuft kein Supervisor:

Background sessions still running will stop in about a minute. Run 'claude agents' to keep them.

Führen Sie innerhalb dieser Minute claude agents in Ihrer Shell aus, um einen neuen Supervisor zu starten und Ihre Sitzungen am Laufen zu halten. Wenn die Minute zuerst verstreicht, stoppen die Sitzungen, aber ihre gespeicherten Konversationen bleiben auf der Festplatte. Um eine Sitzung aus ihrer gespeicherten Konversation neu zu starten, hängen Sie sich an sie an oder antworten Sie ihr, wie unter Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt beschrieben.

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 anstelle von ~/.claude und läuft als separate Instanz mit ihren eigenen Sitzungen.

Pfad	Inhalt
`~/.claude/daemon.log`	Supervisor-Log
`~/.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. Claudes `Write`- und `Edit`-Aufrufe hier fragen nicht nach einer 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, in 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. 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 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 einen Prompt 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 eine Sitzung in den Hintergrund zu verschieben, bedeutet ein Background this session?-Dialog, dass die Sitzung laufende Hintergrundarbeit hat, die gestoppt, unterbrochen oder unbeaufsichtigt weiterlaufen würde:

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 Hintergrundarbeit, 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. Diese Subagenten werden gestoppt, wenn Sie trotzdem in den Hintergrund verschieben, und der Dialog sagt, wie viele. Sie beginnen wieder von vorne, wenn Claude den Workflow in der Hintergrund-Sitzung neu startet.
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 alles 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 laufen zu lassen. Siehe Was beim Verschieben in den Hintergrund übernommen wird, um zu sehen, welche Arten von Arbeit übertragen werden und welche Claude Code stoppt.

Die Konversation meldet, dass ein Hintergrund-Agent `was carried into this session and not resumed`

Dieser Hinweis benennt einen Subagenten im Hintergrund, der in dieser Sitzung nicht läuft. Claude sieht den Hinweis und antwortet von selbst, sodass Sie Claude nicht dazu auffordern müssen. Wenn Sie die Arbeit dieses Subagenten nach dem Lesen von Claudes Antwort weiterhin benötigen, bitten Sie Claude darum.

Prompt als zu kurz abgelehnt

Die Versand-Eingabe erwartet eine Aufgabenbeschreibung, keine Gesprächseröffnung. Ein Prompt, der 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 aus ihrer gespeicherten Konversation neu. Um die unterbrochene Arbeit wieder aufzunehmen, senden Sie ihr eine Antwort mit der Bitte, fortzufahren.
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 diesen Hinweis in der Fußzeile.

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 den ursprünglichen Prompt 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, sofern sie nicht mit ! oder / beginnt, und sendet sie, wenn die Sitzung das nächste Mal startet.

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

Wenn Sie eine Sitzung öffnen, die Sie von einer anderen Konversation aus in den Hintergrund verschoben haben und die gestoppt wurde, bevor sie einen eigenen Turn ausgeführt hat, setzt Claude Code diese Konversation fort. Wenn Claude Code die Konversation nicht finden kann, weigert es sich, die Sitzung zu öffnen:

claude attach gibt This session has no saved transcript aus.
Die Agenten-Ansicht zeigt 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. Siehe die Fehlerreferenz für Details.

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

Der Supervisor führt das Terminal jeder Hintergrund-Sitzung in einem 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, weder über Enter noch über 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 Arbeitsspeicher 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 zu diesem Zeitpunkt wenig Arbeitsspeicher meldete. Wenn der Prozess vor dem Exit einen Fehler geschrieben hat, zeigt die Zeile stattdessen diesen Fehler. Geben Sie Arbeitsspeicher 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 Arbeitsspeicher knapp 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

Führen Sie dann claude agents in Ihrer Shell aus, um einen neuen Supervisor zu starten. Tun Sie dies unter macOS und Linux innerhalb von etwa einer Minute nach dem Beenden des alten, andernfalls stoppen die Sitzungen ohne Supervisor. Wenn Sie stopped gesehen haben, aber derselbe Fehler erneut auftritt, und Sie unter macOS oder Linux eine Claude Code-Version älter als v2.1.300 verwenden, führen Sie claude update aus und anschließend beide Befehle erneut. Wenn der Stopp-Befehl stattdessen eine dieser vier Meldungen ausgegeben hat, wurde der alte Prozess nicht gestoppt. Tun Sie in Ihrer Shell, was die passende Zeile angibt, und führen Sie dann claude agents aus:

Meldung enthält	Plattform	Aktion
`could not be verified as the daemon, so it was not signalled`	Alle	Ermitteln Sie, welches Programm diese Prozess-ID hat. Wenn es Ihr eigener Supervisor ist, stoppen Sie ihn; lassen Sie jedes andere Programm unangetastet. Löschen Sie dann `~/.claude/daemon.lock`.
`is still running after SIGKILL`	macOS, Linux	Warten Sie, bis der Prozess beendet wird. Falls das nie geschieht, starten Sie Ihren Computer neu.
`was not sent SIGKILL`	macOS, Linux	Führen Sie den Stopp-Befehl erneut aus. Wenn der Prozess weiterhin besteht, prüfen Sie ihn mit `ps -ww -o args= -p <pid>`: Ein mit `daemon` gestartetes Claude Code ist ein Supervisor, führen Sie also `kill -9 <pid>` aus. Lassen Sie alles andere unangetastet; wenn `claude agents` dann keinen Supervisor starten kann, löschen Sie `~/.claude/daemon.lock`.
`supervisor (pid=<pid>) is still running`	Windows	Beenden Sie den Prozess mit `taskkill /PID <pid>`

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

Führen Sie innerhalb von etwa einer Minute claude agents oder claude --bg in Ihrer Shell aus, um einen neuen Supervisor zu starten, 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.

Eine Hintergrund-Sitzung zeigt `No LLM gateway`

Wenn eine Hintergrund-Sitzung No LLM gateway anzeigt, hat sie Ihre Gateway-ANTHROPIC_BASE_URL nicht erhalten, sodass ihre Anfragen fehlschlagen. Claude Code hat sie zurückgehalten, weil Sie die Sitzung aus einem anderen Verzeichnis als dem in der Meldung genannten Ordner versendet, aufgeweckt oder neu gestartet haben. Sie sehen die Meldung beispielsweise, nachdem Sie mit @<repo> in ein Repository versendet oder eine gestoppte Sitzung durch Ausführen von claude attach aus einem anderen Verzeichnis aufgeweckt haben. Um der Sitzung Ihr Gateway zu geben, wählen Sie die Lösung, die dazu passt, wo Ihr Gateway festgelegt ist:

Sie haben das Gateway in Ihrem Terminal exportiert: Wechseln Sie in einem Terminal, in dem Sie die Gateway-Variablen exportiert haben, mit cd in den in der Meldung genannten Ordner und führen Sie den claude respawn <id>-Befehl aus der Meldung aus.
- Das Gateway erreicht die Sitzung nur, wenn der Supervisor selbst aus einer Shell gestartet wurde, die dasselbe Gateway exportiert hat. Falls nicht, starten Sie ihn aus dem Terminal neu, in dem Sie den respawn-Befehl ausgeführt haben, wie unter Versand schlägt mit Could not resolve authentication method fehl beschrieben, und führen Sie diesen Befehl dann erneut aus.
Sie haben die Agenten-Ansicht in einem Projekt verwendet, dessen Einstellungen das Gateway festlegen: Legen Sie ANTHROPIC_BASE_URL und die zugehörigen Anmeldedaten im env-Block einer Einstellungsdatei fest. Verwenden Sie ~/.claude/settings.json oder .claude/settings.local.json im eigenen Projekt der Sitzung; beide werden von einer neu gestarteten Sitzung gelesen. Führen Sie dann claude respawn <id> in Ihrer Shell aus einem beliebigen Verzeichnis aus, um diese Sitzung mit dem Gateway neu zu starten.

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 hindert 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-Berechtigungsabfrage 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

Wenn eine Sitzung, die fertig ist oder auf Ihre nächste Nachricht wartet, etwa eine Stunde lang nicht angehängt ist, stoppt der Supervisor ihren 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 arbeiten, bei einer Berechtigungsabfrage oder einem anderen Dialog pausiert sind 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 diese Anzeige, 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 in der Cloud verwenden: 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 Ihnen mitteilen, welche davon auf Sie warten

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.299	`/effort` und `/fast` in der Dispatch-Eingabe legen die Effort-Stufe und den Fast-Modus für die Sitzungen fest, die Sie als Nächstes starten. `/model`, `/effort` oder `/fast` ohne Wert eingegeben öffnet eine Auswahl.
v2.1.299	Claude Code interpretiert `--bg` und `--background` nur dann als Flag, wenn sie vor einem alleinstehenden `--`-Trennzeichen und außerhalb des Werts eines anderen Flags stehen, und lehnt eine mehrdeutige Position ab, statt zu raten. Vor diesem Release konnte ein Prompt oder eine Antwort an eine Hintergrundsitzung, die `--bg` oder `--background` lautete, als das Flag aufgefasst werden. Dadurch konnten immer wieder neue Hintergrundsitzungen gestartet werden, statt den Text zuzustellen.
v2.1.296	Ein Prompt oder `!`-Shell-Befehl, den Sie eingeben, während die Sitzung in den Hintergrund wechselt, wird gestoppt oder nicht gesendet, und sein Text bleibt im Prompt-Verlauf erhalten. Vor diesem Release lief die Antwort oder der Befehl dort weiter, wo Sie sie nicht mehr sehen konnten, und ein direkt nach `←` gesendeter Prompt konnte unbemerkt ein zweites Mal ausgeführt werden. Ein Prompt, der eingegeben wurde, während `SessionStart`-Hooks noch liefen, ging verloren: Er wurde weder gesendet noch im Prompt-Verlauf gespeichert.
v2.1.295	`Ctrl+C` im inaktiven Eingabefeld einer verbundenen Hintergrundsitzung lässt das ausstehende Aufwecken eines selbst getakteten `/loop` unberührt, sodass zweimaliges Drücken die Verbindung trennt und die Schleife weiterläuft. `Esc` in diesem Eingabefeld stoppt die selbst getaktete Schleife und zeigt einen `Pending wakeup cancelled`-Hinweis an. Vor diesem Release konnte das erste `Ctrl+C` eine selbst getaktete Schleife ohne Hinweis beenden, und `Esc` stoppte keine Schleife, die mit der Sitzung in den Hintergrund gewechselt war.
v2.1.295	Unter macOS und Linux startet `claude agents`, wenn es sich beendet, während kein Supervisor läuft, nicht von selbst einen neuen. Laufende Sitzungen stoppen dann etwa eine Minute später, sofern Sie `claude agents` nicht erneut ausführen, und die Agentenansicht kann beim Beenden einen entsprechenden Hinweis ausgeben. Vor diesem Release startete das sich beendende `claude agents` einen neuen Supervisor.
v2.1.295	Unter macOS mit dem nativen Installer laufen Hintergrundsitzungen, die nach einem Update gemeinsam neu starten, unter demselben Claude-Code-Eintrag, der den von Ihnen gewährten Zugriff auf geschützte Ordner besitzt. Vor diesem Release konnten diese Sitzungen stattdessen unter dem eigenen Pfad der Binärdatei laufen. macOS führt diesen Pfad als separaten Eintrag, sodass die Abfragen für den Ordnerzugriff nach einem Update erneut erscheinen konnten.
v2.1.290	`claude attach` und `claude logs` akzeptieren anstelle der ID einen Teil des Namens einer Sitzung.
v2.1.290	`/model`, `/effort`, `/rename` und `/usage` werden sofort ausgeführt, wenn sie als Peek-Antwort an eine arbeitende Sitzung gesendet werden.
v2.1.290	Eine Peek-Antwort, die nicht zugestellt werden kann, wird nicht mehr für den nächsten Neustart gespeichert, wenn sie mit `/` beginnt oder wenn sie eine Frage mit vorgegebenen Auswahlmöglichkeiten beantwortet, während der Prozess der Sitzung läuft.
v2.1.288	`Ctrl+F` findet Sitzungen anhand ihres Namens, und `Alt+↑` / `Alt+↓` springen zwischen Gruppenüberschriften. Beide sowie `Ctrl+R` lassen sich neu belegen.
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, 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.
v2.1.212	Die Eingabe eines alleinstehenden `/resume` in der Agentenansicht öffnet eine Auswahl vergangener Sitzungen des Repositorys, aus dem Sie die Agentenansicht geöffnet haben.
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 ü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 Hintergrundarbeit wird auch unter Windows übernommen, wenn Sie eine Sitzung in den Hintergrund verschieben. 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.

​Schnellstart

​Agenten-Ansicht standardmäßig öffnen

​Sitzungen mit Agent-Ansicht überwachen

​Sitzungsstatus lesen

​Zeilenzusammenfassungen

​Pull-Request-Status

​Peek und Antwort

​An eine Sitzung anhängen

​Sitzungen wechseln, ohne das Terminal zu verlassen

​Liste organisieren

​Eine vergangene Sitzung zurückholen

​Sitzungen filtern

​Tastenkombinationen

​Neue Agenten versenden

​Einen Agenten aus der Agenten-Ansicht versenden

​In ein bestimmtes Verzeichnis versenden

​Eine Sitzung in den Hintergrund senden oder kopieren

​Die Sitzung in den Hintergrund senden

​Die Sitzung mit /fork kopieren

​Was beim Verschieben in den Hintergrund übernommen wird

​Einen Agenten aus Ihrer Shell versenden

​Prompts, die --bg enthalten

​Einen Shell-Befehl ausführen

​Wie Dateibearbeitungen isoliert werden

​Was das Löschen einer Sitzung entfernt

​Modell, Effort-Stufe und Fast-Modus festlegen

​Berechtigungsmodus, Modell und Aufwand

​Einstellungen und Provider

​LLM-Gateway

​Berechtigungsmodus

​Versand-Standardwerte

​Was über Neustarts hinweg erhalten bleibt

​Einstellungen, Plugins und MCP-Server

​Sitzungen aus der Shell verwalten

​Sitzungen als JSON auflisten

​Sitzungsstatus aus einem Skript lesen

​Wie Hintergrund-Sitzungen gehostet werden

​Der Supervisor-Prozess

​Sitzungen nach dem Stoppen des Supervisors am Laufen halten

​Wo der Status gespeichert ist

​Agenten-Ansicht ausschalten

​Fehlerbehebung

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

​Agenten-Ansicht öffnet sich ohne Sitzungen

​Backgrounding zeigt einen Background this session?-Dialog

​Die Konversation meldet, dass ein Hintergrund-Agent was carried into this session and not resumed

​Prompt als zu kurz abgelehnt

​Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt

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

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

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

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

​Agenten-Ansicht sagt, dass der Hintergrunddienst nicht geantwortet hat

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

​Eine Hintergrund-Sitzung zeigt No LLM gateway

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

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

​Eine Sitzung reagiert langsam nach dem Anhängen

​.claude/worktrees/ füllt sich auf

​Einschränkungen

​Verwandte Ressourcen

​Versionsverlauf

Schnellstart

Agenten-Ansicht standardmäßig öffnen

Sitzungen mit Agent-Ansicht überwachen

Sitzungsstatus lesen

Zeilenzusammenfassungen

Pull-Request-Status

Peek und Antwort

An eine Sitzung anhängen

Sitzungen wechseln, ohne das Terminal zu verlassen

Liste organisieren

Eine vergangene Sitzung zurückholen

Sitzungen filtern

Tastenkombinationen

Neue Agenten versenden

Einen Agenten aus der Agenten-Ansicht versenden

In ein bestimmtes Verzeichnis versenden

Eine Sitzung in den Hintergrund senden oder kopieren

Die Sitzung in den Hintergrund senden

Die Sitzung mit /fork kopieren

Was beim Verschieben in den Hintergrund übernommen wird

Einen Agenten aus Ihrer Shell versenden

Prompts, die `--bg` enthalten

Einen Shell-Befehl ausführen

Wie Dateibearbeitungen isoliert werden

Was das Löschen einer Sitzung entfernt

Modell, Effort-Stufe und Fast-Modus festlegen

Berechtigungsmodus, Modell und Aufwand

Einstellungen und Provider

LLM-Gateway

Berechtigungsmodus

Versand-Standardwerte

Was über Neustarts hinweg erhalten bleibt

Einstellungen, Plugins und MCP-Server

Sitzungen aus der Shell verwalten

Sitzungen als JSON auflisten

Sitzungsstatus aus einem Skript lesen

Wie Hintergrund-Sitzungen gehostet werden

Der Supervisor-Prozess

Sitzungen nach dem Stoppen des Supervisors am Laufen halten

Wo der Status gespeichert ist

Agenten-Ansicht ausschalten

Fehlerbehebung

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

Agenten-Ansicht öffnet sich ohne Sitzungen

Backgrounding zeigt einen `Background this session?`-Dialog

Die Konversation meldet, dass ein Hintergrund-Agent `was carried into this session and not resumed`

Prompt als zu kurz abgelehnt

Sitzungen werden nach dem Herunterfahren als fehlgeschlagen oder gestoppt angezeigt

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

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

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

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

Agenten-Ansicht sagt, dass der Hintergrunddienst nicht geantwortet hat

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

Eine Hintergrund-Sitzung zeigt `No LLM gateway`

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

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

Eine Sitzung reagiert langsam nach dem Anhängen

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

Einschränkungen

Verwandte Ressourcen

Versionsverlauf