Mehrere Agenten mit der Agenten-Ansicht verwalten

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

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

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.

Diese Seite behandelt:

• Schnellstart: Geben Sie Claude eine Aufgabe, an der sie im Hintergrund arbeiten kann, überprüfen Sie sie und greifen Sie ein, wenn nötig
• Sitzungen mit der Agenten-Ansicht überwachen, einschließlich Statussymbole, Vorschau und Antwort, Anhängen, Organisieren und Tastaturkürzel
• Neue Agenten versenden aus der Agenten-Ansicht, aus einer Sitzung heraus oder aus Ihrer Shell
• Sitzungen aus der Shell verwalten
• Wie Hintergrund-Sitzungen gehostet werden durch den Supervisor-Prozess

Schnellstart

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

claude agents

Sie können claude agents als Ihren primären Einstiegspunkt anstelle von claude verwenden: versenden Sie jede Aufgabe aus der Agenten-Ansicht, hängen Sie sich an, wenn Sie das vollständige Gespräch möchten, und drücken Sie ←, um zur Tabelle zurückzukehren.

Sitzungen mit der Agenten-Ansicht überwachen

Führen Sie claude agents aus, um die Agenten-Ansicht zu öffnen. Sie übernimmt das gesamte Terminal und listet jede Sitzung nach Status gruppiert auf, mit angehefteten Sitzungen und denjenigen, die Sie benötigen, oben. Jede Zeile zeigt den Namen der Sitzung, die aktuelle Aktivität und wie lange die letzte Änderung her ist.

Standardmäßig zeigt die Liste jede Hintergrund-Sitzung, die Sie gestartet haben, über alle Ihre Projekte hinweg. Eine Sitzung, die in einem Repository funktioniert, und eine andere in einem anderen Worktree erscheinen beide hier, unabhängig davon, aus welchem Verzeichnis Sie die Agenten-Ansicht geöffnet haben. Um die Liste auf ein Projekt zu beschränken, übergeben Sie --cwd (erfordert Claude Code v2.1.141 oder später):

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

Dies zeigt nur Sitzungen an, die unter diesem Verzeichnis gestartet wurden. Eine Sitzung, die in einen Worktree verschoben wurde unter ~/projects/my-app/.claude/worktrees/, zählt immer noch als zu ~/projects/my-app gehörend.

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

Angeheftet
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Bereit zur Überprüfung
  ∙ jump physics              Opened PR with collision fix              PR #2048  2h

Benötigt Eingabe
  ✻ power-up design           needs input: double jump or wall climb?       1m

Funktioniert
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

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

Sitzungsstatus lesen

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

Separat zeigt die Form des Symbols, ob der zugrunde liegende Prozess läuft:

Das PR #N-Label, das am rechten Rand einer Zeile erscheinen kann, ist der Pull Request, den die Sitzung geöffnet hat, nicht Teil des Status-Symbols. Wenn eine Sitzung mehr als einen Pull Request geöffnet hat, zeigt das Label eine Anzahl statt, z. B. 3 PRs.

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

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

Der Sitzungsstatus wird auf der Festplatte durch automatische Updates und Supervisor-Neustarts beibehalten. 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 untätig zu behandeln. Das Herunterfahren stoppt immer noch laufende Sitzungen; siehe Sitzungen werden nach dem Herunterfahren als fehlgeschlagen angezeigt, um zu erfahren, wie Sie sie wiederherstellen.

Zeilenzusammenfassungen

Die einzeilige Zusammenfassung in jeder Zeile wird von einem Haiku-Klasse-Modell generiert, sodass die Zeile Ihnen zeigen kann, was die Sitzung tut, was sie benötigt oder was sie produziert hat, ohne das Transkript zu öffnen. Während eine Sitzung aktiv funktioniert, wird die Zusammenfassung höchstens alle 15 Sekunden aktualisiert, plus einmal, wenn jede Runde endet.

Ab v2.1.161 wird, wenn die Sitzung zwei oder mehr parallele Arbeitselemente ausführt, wie z. B. Subagenten, Hintergrund-Shell-Befehle oder Monitore, eine done/total-Anzahl wie 2/5 vor dem Zusammenfassungstext angezeigt.

Jede Aktualisierung ist eine kurze Haiku-Klasse-Anfrage durch Ihren normalen Anbieter, abgerechnet und behandelt unter denselben Datennutzungsbedingungen wie die Sitzung selbst. Bei Drittanbieter-Anbietern wie Bedrock, Vertex AI, Microsoft Foundry und benutzerdefinierten Gateways wird die Anfrage auf das Hauptmodell der Sitzung zurückgeführt, wenn kein Haiku-Modell konfiguriert ist. Legen Sie ANTHROPIC_DEFAULT_HAIKU_MODEL fest, um das Modell für diese Zusammenfassungen bei diesen Anbietern auszuwählen.

Pull-Request-Status

Wenn eine Sitzung einen Pull Request öffnet, wird ein PR #1234-Label am rechten Rand der Zeile angezeigt, verlinkt zum Pull Request in Terminals, die Hyperlinks unterstützen. Das Label bleibt bestehen, wenn Sie eine Nachverfolgung an die Sitzung senden, sodass der Pull Request sichtbar bleibt, während die Zeile zum Live-Fortschritt zurückkehrt.

Wenn eine Sitzung mehr als einen Pull Request geöffnet hat, zeigt das Label eine Anzahl statt, z. B. 3 PRs, farbig gekennzeichnet nach dem offenen Pull Request, der am meisten Aufmerksamkeit benötigt. Öffnen Sie das Vorschau-Panel, um sie alle zu sehen.

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

Für die meisten Aufgaben ist diese Spalte, wo Sie das Ergebnis aufgreifen: überprüfen und führen Sie den Pull Request zusammen, wenn seine Nummer grün wird.

Vorschau und Antwort

Drücken Sie Space auf einer ausgewählten Zeile, um das Vorschau-Panel zu öffnen. Es zeigt, was die Sitzung von Ihnen benötigt, ihre neueste Ausgabe und alle Pull Requests, die sie geöffnet hat. Meistens reicht dies aus, und Sie müssen das vollständige Transkript nie öffnen.

Ab v2.1.161 benennt das Panel auch das am längsten laufende Arbeitselement, wenn die Sitzung parallele Arbeitselemente ausführt, und wie lange es läuft, sodass Sie sehen können, worauf die Sitzung wartet, ohne sich anzuhängen.

Geben Sie eine Antwort im Vorschau-Panel ein und drücken Sie Enter, um sie an diese Sitzung zu senden. Wenn die Sitzung eine Multiple-Choice-Frage stellt, zeigt das Vorschau-Panel die Optionen an und Sie können eine Zahlentaste drücken, um eine auszuwählen. Für andere blockierte Sitzungen drücken Sie Tab, um die Eingabe mit einer vorgeschlagenen Antwort zu füllen, die Sie vor dem Senden bearbeiten können. Präfixieren Sie eine Antwort mit !, um stattdessen einen Bash-Befehl zu senden.

Ab v2.1.145 können Sie mit Sprachdiktat aktiviert Ihre Push-to-Talk-Taste halten oder tippen, 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 Agenten-Ansicht.

Verwenden Sie ↑ und ↓, um benachbarte Sitzungen in der Vorschau anzuzeigen, ohne das Panel zu schließen, oder →, um sich anzuhängen.

An eine Sitzung anhängen

Drücken Sie Enter oder → auf einer ausgewählten Zeile, um sich anzuhängen. Die Agenten-Ansicht wird durch die vollständige interaktive Sitzung ersetzt. Wenn Sie sich 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: jeder Befehl, Tastaturkürzel und jede Funktion funktioniert.

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

Drücken Sie ← auf einer leeren Eingabeaufforderung, um sich abzuhängen und zur Agenten-Ansicht zurückzukehren. Wenn ein Dialog den Fokus hat und nicht auf ← reagiert, drücken Sie Ctrl+Z, um sich sofort abzuhängen.

Ctrl+C behält sein Standardunterbrechungsverhalten bei, während es angehängt ist: Es bricht eine laufende Antwort oder einen !-Shell-Befehl ab, anstatt sich abzuhängen. Das zweimalige Drücken von Ctrl+C auf einer leeren Eingabeaufforderung hängt ab, genau wie in jeder anderen Sitzung.

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

Das Drücken von ← auf einer leeren Eingabeaufforderung funktioniert aus jeder Claude Code-Sitzung, nicht nur aus denjenigen, an denen Sie angehängt sind. Es verschiebt die aktuelle Sitzung in den Hintergrund und öffnet die Agenten-Ansicht mit dieser Zeile ausgewählt, sodass Sie zwischen Sitzungen wechseln können, ohne das Terminal zu verlassen. Die Zeile wird auch aus einer neuen Sitzung ohne Gesprächsverlauf erstellt, sodass → zu ihr zurückkehrt. Wenn diese Zeile die einzige ist, zeigt die Agenten-Ansicht einen Onboarding-Hinweis darunter an. Sie können diesen Tastaturkürzel in /config ausschalten (die leftArrowOpensAgents-Einstellung).

Die Liste organisieren

Die Agenten-Ansicht gruppiert Sitzungen, sodass diejenigen, die Eingabe benötigen, oben sind, mit Bereit zur Überprüfung und Benötigt Eingabe über Funktioniert und Abgeschlossen. Diese Gruppennamen entsprechen nicht eins-zu-eins den Status oben: Eine Sitzung wechselt zu Bereit zur Überprüfung, wenn sie einen offenen Pull Request hat, und Abgeschlossen sammelt beendete, fehlgeschlagene und gestoppte Sitzungen zusammen. Drücken Sie Ctrl+S, um stattdessen nach Verzeichnis zu gruppieren. Ihre Wahl wird über Läufe hinweg gespeichert.

Innerhalb einer Gruppe:

• Drücken Sie Ctrl+T, um eine Sitzung oben anzuheften und ihren Prozess während der Untätigkeit laufen zu lassen
• Drücken Sie Shift+↑ oder Shift+↓, um Sitzungen neu anzuordnen
• Drücken Sie Ctrl+R, um eine Sitzung umzubenennen
• Drücken Sie Enter auf einem Gruppenkopf, um ihn zu reduzieren

Um eine Sitzung aus der Liste zu entfernen, drücken Sie Ctrl+X, um sie zu stoppen, und Ctrl+X erneut innerhalb von zwei Sekunden, um sie zu löschen. Das Drücken von Ctrl+X auf einem Gruppenkopf löscht jede Sitzung in dieser Gruppe nach Bestätigung.

Das Löschen entfernt die Sitzung aus der Agenten-Ansicht. Wenn Claude einen Worktree erstellt hat für die Sitzung, entfernt das Löschen auch diesen Worktree, einschließlich aller nicht committeten Änderungen darin, sodass Sie Arbeit, die Sie behalten möchten, zuerst pushen oder committen sollten. Ein Worktree, den Sie selbst erstellt haben und die Sitzung darin gestartet haben, wird an Ort und Stelle gelassen. Das Gesprächstranskript bleibt auf Ihrem lokalen Computer und bleibt über claude --resume verfügbar.

Ältere abgeschlossene Sitzungen werden in eine Zeile … N more eingeklappt, um die Liste kurz zu halten. Fehler und Sitzungen mit einem offenen Pull Request bleiben immer sichtbar.

Sitzungen filtern

Geben Sie in die Versand-Eingabe ein, um zu filtern, anstatt zu versenden:

Tastaturkürzel

Drücken Sie ? in der Agenten-Ansicht, um jedes Kürzel im Kontext zu sehen. Die folgende Tabelle fasst sie zusammen.

Neue Agenten versenden

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

Aus der Agenten-Ansicht

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

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

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

Ein kleiner Satz von Befehlen wird in der Agenten-Ansicht selbst ausgeführt, anstatt zu versenden: /exit und /quit schließen die Agenten-Ansicht, und /logout meldet Sie ab. Jeder andere Befehl und Skill wird als erste Eingabeaufforderung an eine neue Hintergrund-Sitzung gesendet.

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

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

In ein bestimmtes Verzeichnis versenden

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

• Öffnen Sie claude agents in diesem Verzeichnis.
• Öffnen Sie claude agents in einem übergeordneten Verzeichnis, das mehrere Repositories enthält, und erwähnen Sie eines mit @<repo> in der Eingabeaufforderung, um die Sitzung dort auszuführen.
• Führen Sie in der Shell cd in das Verzeichnis aus und führen Sie claude --bg "<prompt>" aus.

Wenn die Agenten-Ansicht nach Verzeichnis gruppiert ist, wird das Verzeichnis der hervorgehobenen Zeile zum Versand-Ziel, sodass Sie zu einer Gruppe scrollen und darin versenden können, ohne den Pfad erneut einzugeben.

Aus einer Sitzung heraus

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

Das Verschieben aus einer interaktiven Sitzung startet einen neuen Prozess, der aus dem gespeicherten Gespräch fortgesetzt wird, sodass das Ausführen von Subagenten, Monitoren und Hintergrund-Befehlen nicht auf die Sitzung übertragen wird. Claude fordert Sie auf, zu bestätigen, bevor Sie verschieben, wenn einer dieser Befehle ausgeführt wird. Sobald sich die Sitzung im Hintergrund befindet, kann sie neue Subagenten, Monitore und Hintergrund-Befehle starten, und diese werden bei späteren Trennungen und Wiederverbindungen weiterhin ausgeführt.

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

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

Verzeichnisse, die Sie während der Sitzung mit /add-dir hinzugefügt haben, werden ebenfalls übertragen.

Das Übertragen von --allow-dangerously-skip-permissions hält bypassPermissions in der versendeten Sitzung erreichbar, gewährt aber nichts Neues. Der Modus erfordert immer noch die gleiche einmalige interaktive Akzeptanz, die in Berechtigungsmodus, Modell und Aufwand beschrieben ist, bevor eine Sitzung ihn verwenden kann.

Aus der Shell

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

claude --bg "investigate the flaky SettingsChangeDetector test"

Um einen bestimmten Subagenten als Hauptagent der Sitzung auszuführen, kombinieren Sie --bg mit --agent:

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

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

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

Nach dem Versenden druckt Claude die kurze ID der Sitzung und die Befehle zu ihrer Verwaltung. Wenn Sie --name übergeben, wird der Name nach der kurzen ID angezeigt:

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

Einen Shell-Befehl ausführen

Um einen Shell-Befehl als Hintergrund-Job anstelle einer Claude-Sitzung auszuführen, geben Sie ! als erstes Zeichen der Agenten-Ansicht-Versand-Eingabe ein. Das ! wird als Präfix angezeigt und alles, was Sie danach eingeben, ist der Befehl. Das folgende Beispiel versendet pytest -x aus dem Agenten-Ansicht-Eingabefeld:

! pytest -x

Drücken Sie Enter, um den Job zu starten. Der gleiche Job kann auch direkt aus Ihrer Shell mit --exec gestartet werden:

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

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

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

Wie Dateibearbeitungen isoliert werden

Jede Hintergrund-Sitzung, ob aus der Agenten-Ansicht, /bg oder claude --bg gestartet, beginnt in Ihrem Arbeitsverzeichnis. Bevor Dateien bearbeitet werden, verschiebt Claude die Sitzung in einen isolierten Git-Worktree unter .claude/worktrees/, sodass parallele Sitzungen denselben Checkout lesen können, aber jede in ihren eigenen schreibt.

Claude überspringt den Worktree, wenn:

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

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

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

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

Das Löschen einer Sitzung in der Agenten-Ansicht (Ctrl+X zweimal) entfernt einen Worktree, den Claude für sie erstellt hat, einschließlich aller nicht committeten Änderungen, daher führen Sie die Änderungen zusammen oder pushen Sie sie, die Sie behalten möchten, bevor Sie löschen. Das Löschen aus der Shell mit claude rm behält einen Worktree mit nicht committeten Änderungen und druckt seinen Pfad, damit Sie ihn selbst bereinigen können. Ein Worktree, den Sie selbst erstellt haben und in dem Sie die Sitzung gestartet haben, wird in jedem Fall beibehalten.

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

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

Das Modell festlegen

Der im Header der Agenten-Ansicht angezeigte Modellname ist der Versand-Standard. Neue Sitzungen, die Sie aus der Eingabe starten, verwenden dieses Modell, das aus der model-Einstellung in Ihren Benutzereinstellungen stammt. Legen Sie es fest, indem Sie ein Modell in der /model-Auswahl auswählen, oder bearbeiten Sie die Einstellung direkt. Um es für die gesamte Agenten-Ansicht-Sitzung zu überschreiben, übergeben Sie --model beim Öffnen der Agenten-Ansicht. Siehe Berechtigungsmodus, Modell und Aufwand.

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

• Übergeben Sie in der Shell --model mit claude --bg.
• Hängen Sie an eine laufende Sitzung an, öffnen Sie /model, und drücken Sie s auf einem Modell, um nur für diese Sitzung zu wechseln. Die Änderung bleibt bestehen, wenn die Sitzung neu gestartet wird.
• Versenden Sie einen Subagenten, dessen Frontmatter ein model-Feld setzt.

Berechtigungsmodus, Modell und Aufwand

Eine Hintergrund-Sitzung liest ihre Einstellungen aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie claude dort gestartet hätten.

Der Berechtigungsmodus hängt davon ab, wie Sie die Sitzung gestartet haben. Das Verschieben einer vorhandenen Sitzung mit /bg oder ← behält den aktuellen Berechtigungsmodus bei, sodass eine Sitzung, die Sie zu acceptEdits oder auto gewechselt haben, nach dem Trennen in diesem Modus bleibt. Das Versenden aus der Agenten-Ansicht-Eingabe oder das Ausführen von claude --bg aus der Shell verwendet den defaultMode aus den Einstellungen dieses Verzeichnisses oder den permissionMode aus dem Frontmatter des versendeten Subagenten.

Der Berechtigungsmodus, das Modell und der Aufwand, mit dem eine Hintergrund-Sitzung gestartet wurde, sowie die Konfigurationsflags, die sie trägt, bleiben alle bestehen, wenn der Supervisor später die Sitzung stoppt und neu startet. Eine Sitzung, die Sie mit claude --bg --dangerously-skip-permissions oder claude --bg --permission-mode bypassPermissions gestartet haben, bleibt nach diesem Neustart in bypassPermissions, anstatt auf den defaultMode des Verzeichnisses zurückzufallen, und ein Modell oder Aufwand, den Sie während der Sitzung mit /model oder /effort geändert haben, wird beibehalten.

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

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

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

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

Diese Flags wurden über Releases hinweg hinzugefügt. Frühere Versionen lehnen sie mit einem unknown-option-Fehler ab.

Vor v2.1.157 ignoriert die Agenten-Ansicht die agent-Einstellung und versendet den integrierten claude-Agent.

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

Ohne diese Flags verwendet die Sitzung den defaultMode aus den Einstellungen dieses Verzeichnisses oder den permissionMode aus dem Frontmatter des versendeten Subagenten, und das im Header der Agenten-Ansicht angezeigte Modell.

Die Verwendung von bypassPermissions oder auto wird abgelehnt, bis Sie diesen Modus akzeptiert haben, indem Sie claude einmal interaktiv damit ausführen, da diese Modi eine Sitzung, die Sie nicht beobachten, ohne Genehmigung handeln lassen. Dasselbe gilt, ob Sie den Modus an claude agents oder an claude --bg --permission-mode übergeben.

Einstellungen, Plugins und MCP-Server

Die Agenten-Ansicht akzeptiert dieselben Konfigurationsflags wie claude zum Laden von Einstellungen, Plugins, MCP-Servern und zusätzlichen Verzeichnissen. Diese Flags erfordern Claude Code v2.1.142 oder später. Jedes Flag gilt für die Agenten-Ansicht selbst und wird an jede Sitzung weitergeleitet, die Sie daraus versenden, sodass ein Plugin oder MCP-Server, den Sie auf diese Weise laden, auch in diesen Sitzungen verfügbar ist.

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

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

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.

Wie Hintergrund-Sitzungen gehostet werden

Jede Sitzung, die in der Agenten-Ansicht aufgelistet ist, wird als Hintergrund-Sitzung betrachtet, 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.

Der Supervisor-Prozess

Hintergrund-Sitzungen werden von einem Supervisor-Prozess pro Benutzer gehostet, getrennt von Ihrem Terminal und von der Agenten-Ansicht. Der Supervisor startet automatisch, wenn Sie zum ersten Mal eine Sitzung in den Hintergrund verschieben oder die Agenten-Ansicht öffnen, und Sie verwalten ihn nicht direkt.

Der Supervisor und seine Sitzungen authentifizieren sich mit denselben Anmeldedaten wie Ihre interaktiven Sitzungen und stellen keine zusätzlichen Netzwerkverbindungen über die Modell-API hinaus her.

Jede Hintergrund-Sitzung ist ihr eigener Claude Code-Prozess, der vom Supervisor verwaltet wird, anstatt an Ihr Terminal gebunden zu sein. Eine Sitzung, die aktiv funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, behält ihren Prozess am Laufen. Ein laufender Hintergrund-Shell-Befehl, Subagent, dynamischer Workflow oder Monitor zählt als aktive Arbeit, daher hält ein langfristiger Prozess wie ein Dev-Server die Sitzung am Leben.

Sobald eine Sitzung fertig ist und etwa eine Stunde lang unverbunden sitzt, stoppt der Supervisor ihren Prozess, um Ressourcen freizugeben. Eine Sitzung, die Sie mit Ctrl+T angeheftet haben, ist ausgenommen und behält ihren Prozess im Leerlauf bei. Das Transkript und der Status bleiben auf der Festplatte, und das nächste Mal, wenn Sie anhängen, Vorschau anzeigen oder antworten, startet der Supervisor einen frischen Prozess von dort, wo er aufgehört hat. Wenn jede Sitzung fertig ist und kein Terminal verbunden ist, beendet sich der Supervisor selbst und startet erneut, wenn Sie das nächste Mal eine Sitzung benötigen.

Eine leere Zeile, die von Drücken von ← übrig bleibt und der nie eine Eingabeaufforderung gegeben wurde, wird nach etwa fünf Minuten vollständig entfernt, damit sich die Liste von selbst löscht. Sitzungen, die mit claude --bg gestartet wurden, und Sitzungen, die auf eine Setup-Eingabeaufforderung wie einen Vertrauensdialog warten, werden auf diese Weise nicht entfernt.

Wenn der Host wenig Speicher hat, stoppt der Supervisor zuerst untätige nicht angeheftete Sitzungen und stoppt untätige angeheftete Sitzungen nur, wenn dies nichts freigegeben hat.

Der Supervisor beobachtet die installierte Claude Code-Binärdatei auf der Festplatte und startet in die neue Version neu, nachdem der reguläre Auto-Updater sie ersetzt. Dies ist eine lokale Dateiüberwachung, keine Netzwerkprüfung. Hintergrund-Sitzungen sind abgelöste Prozesse, daher laufen sie während des Neustarts weiter und der neue Supervisor verbindet sich wieder mit ihnen. Eine untätige angeheftete Sitzung wird auch an Ort und Stelle in die neue Version neu gestartet, damit sie das Update aufgreift, ohne dass Sie sie erneut anhängen müssen.

Wo der Status gespeichert ist

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

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. /doctor enthält eine Zusammenfassung derselben Überprüfung.

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

Unter Windows zeigt claude daemon status den zugrunde liegenden Dateifehler an, wenn die Pipe-Schlüsseldatei des Daemons gesperrt oder nicht lesbar ist, anstatt einen generischen Verbindungsfehler zu melden.

Agenten-Ansicht ausschalten

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

Fehlerbehebung

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

Wenn claude agents eine Anzahl gefolgt von Ihren konfigurierten Subagenten ausgibt und dann beendet wird, ist die Agenten-Ansicht in Ihrer Umgebung nicht verfügbar. Frühere Versionen öffneten die Agenten-Ansicht nicht in jeder Umgebung, einschließlich bei Verbindung über Bedrock, Vertex AI oder Foundry. 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 einen kurzen Onboarding-Hinweis mit Beispiel-Eingabeaufforderungen anstelle der Sitzungsliste. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie Enter, um Ihre erste Sitzung zu versenden.

Agenten können nicht geöffnet werden, da Hintergrundaufgaben ausgeführt werden

Wenn das Drücken von ← zum Hintergrund der aktuellen Sitzung Cannot open agents — N still running in the background anzeigt, hat die Sitzung laufende Arbeiten wie einen Subagenten, einen dynamischen Workflow oder einen Hintergrund-Shell-Befehl, und die Verknüpfung wird sie nicht stillschweigend aufgeben. Führen Sie /tasks aus, um zu sehen, was ausgeführt wird, dann /bg, um das Aufgeben zu bestätigen. Siehe Aus einer Sitzung heraus, um zu sehen, was übertragen wird und was nicht, wenn Sie in den Hintergrund gehen.

Eingabeaufforderung als zu kurz abgelehnt

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

Sitzungen werden nach dem Herunterfahren als fehlgeschlagen angezeigt

Das Herunterfahren oder Neustarten Ihres Computers stoppt laufende Hintergrund-Sitzungen, sodass sie beim nächsten Öffnen der Agenten-Ansicht als fehlgeschlagen angezeigt werden. Hängen Sie sich an, zeigen Sie Vorschau an oder antworten Sie auf eine beliebige Sitzung und die Sitzung startet von dort neu, wo sie aufgehört hat.

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

Agenten-Ansicht sagt, dass der Hintergrunddienst nicht geantwortet hat

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

claude daemon stop --any --keep-workers

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

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

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.

Eine Sitzung reagiert langsam nach dem Anhängen

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

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

Das Löschen einer Sitzung in der Agenten-Ansicht entfernt den Worktree, den Claude dafür erstellt hat. claude rm behält einen Worktree mit nicht committeten Änderungen und gibt seinen Pfad aus. 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 oder pushen Sie sie, bevor Sie eine Sitzung löschen, die Dateien in ihrem eigenen Worktree bearbeitet hat. claude rm behält einen Worktree bei, der nicht committete Änderungen hat; ein Worktree, den Sie selbst erstellt haben, wird an Ort und Stelle belassen.

Verwandte Ressourcen

Weitere Möglichkeiten zum parallelen Ausführen von Claude finden Sie unter:

• Agenten parallel ausführen: Vergleichen Sie die Agenten-Ansicht mit Subagenten, Agenten-Teams und Worktrees
• Agenten-Teams: Koordinieren Sie mehrere Sitzungen, die sich gegenseitig Nachrichten senden
• Claude Code im Web: Führen Sie Sitzungen in einer verwalteten Cloud-Umgebung aus, anstatt lokal