Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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. Sitzungen laufen im Hintergrund weiter, ohne dass ein Terminal angeschlossen ist. Verwenden Sie die Agenten-Ansicht, wenn Sie mehrere unabhängige Aufgaben haben, an denen Claude gleichzeitig arbeiten kann, z. B. das Beheben eines Fehlers, das Überprüfen eines Pull Requests oder das Untersuchen eines Protokolls. Wenn Sie ein Problem zusammen durcharbeiten möchten, hängen Sie sich an eine Sitzung an und verwenden Sie Claude Code interaktiv wie gewohnt. Sitzungen in der Agenten-Ansicht laufen unabhängig und berichten nur an Sie. Um mit Subagenten, Agent-Teams und Worktrees zu vergleichen, siehe Agenten parallel ausführen.
Die Agenten-Ansicht ist eine Forschungsvorschau und erfordert Claude Code v2.1.139 oder später. Überprüfen Sie Ihre Version mit claude --version. Die Benutzeroberfläche und Tastaturkürzel können sich ändern, wenn sich die Funktion weiterentwickelt, und Administratoren können die Agenten-Ansicht für eine Organisation mit der verwalteten Einstellung disableAgentView deaktivieren.
Diese Seite behandelt:

​
Schnellstart

Diese Anleitung öffnet die Agenten-Ansicht, versendet eine Sitzung, antwortet aus dem Vorschau-Panel und hängt sich für das vollständige Gespräch an.
1

Agenten-Ansicht öffnen

Führen Sie in Ihrer Shell aus:
claude agents
Die Agenten-Ansicht öffnet sich mit einer Eingabe am unteren Rand und einer Tabelle, die sich füllt, wenn Sitzungen starten. Drücken Sie jederzeit Esc, um zu beenden. Ihre Sitzungen laufen weiter.
2

Eine Sitzung versenden

Geben Sie eine Eingabeaufforderung in die Eingabe ein und drücken Sie Enter. Eine neue Sitzung startet und wird als Zeile angezeigt, die zeigt, ob sie funktioniert, auf Sie wartet oder erledigt ist. Wiederholen Sie dies, um mehrere Sitzungen parallel auszuführen. Jede nutzt Ihr Abonnementkontingent unabhängig, daher lesen Sie Einschränkungen, bevor Sie viele auf einmal versenden.
3

Vorschau und Antwort

Wählen Sie eine Zeile mit den Pfeiltasten aus und drücken Sie Space, um zu sehen, was die Sitzung tut oder was sie von Ihnen benötigt. Geben Sie eine Antwort ein und drücken Sie Enter, um sie zu senden, ohne die Agenten-Ansicht zu verlassen.
4

Anhängen und Abhängen

Drücken Sie Enter oder → auf einer Zeile, um sich anzuhängen, wenn Sie das vollständige Gespräch möchten. Die Sitzung übernimmt das Terminal genau so, als hätten Sie claude ausgeführt. Drücken Sie ← auf einer leeren Eingabeaufforderung, um sich abzuhängen und zur Tabelle zurückzukehren.
Um eine vorhandene interaktive Sitzung in die Agenten-Ansicht zu bringen, führen Sie /bg darin aus, oder drücken Sie ← auf einer leeren Eingabeaufforderung, um die Sitzung in den Hintergrund zu verschieben und die Agenten-Ansicht in einem Schritt zu öffnen. Die Sitzung läuft im Hintergrund weiter und wird als Zeile angezeigt. Um eine neue Hintergrund-Sitzung direkt aus der Shell zu starten, führen Sie claude --bg "<prompt>" aus. 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. Die Liste umfasst jede Hintergrund-Sitzung unter Ihrem Konfigurationsverzeichnis, unabhängig davon, in welchem Projekt oder Worktree sie funktioniert, sodass eine Sitzung, die in einem Repository gestartet wurde, und eine andere, die in einem anderen Worktree gestartet wurde, zusammen angezeigt werden. Interaktive Sitzungen, die Sie in anderen Terminals offen haben, werden nicht angezeigt, bis Sie sie in den Hintergrund verschieben, und Subagenten, die in einer Sitzung laufen, werden nicht als separate Zeilen aufgelistet. 
Angeheftet
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Bereit zur Überprüfung
  ∙ jump physics              github.com/anthropics/example/pull/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
Das Symbol jeder Zeile trägt zwei Signale. Der Indikator zeigt Ihnen den Status der Sitzung, und die Form des Symbols zeigt Ihnen, ob der zugrunde liegende Prozess noch läuft. Die Status sind:
IndikatorStatusWas es bedeutet
AnimiertFunktioniertClaude führt aktiv Tools aus oder generiert eine Antwort
GelbBenötigt EingabeClaude wartet auf Ihre Eingabe, normalerweise eine Genehmigungsentscheidung oder eine Antwort
GedimmtUntätigDie Sitzung wartet auf Eingabe, ist aber nicht an einer bestimmten Frage blockiert
GrünAbgeschlossenDie Aufgabe wurde erfolgreich abgeschlossen
RotFehlgeschlagenDie Aufgabe endete mit einem Fehler
GrauGestopptDie Sitzung wurde mit Ctrl+X oder claude stop gestoppt
Die Form des Symbols zeigt, ob der zugrunde liegende Prozess noch läuft. Ein ✻ oder ein animiertes ✽, während Claude funktioniert, bedeutet, dass die Sitzung aktiv ist und Sie sofort darauf antworten können. Ein ∙ bedeutet, dass der Prozess beendet wurde, aber Sie können immer noch Vorschau anzeigen, antworten oder anhängen: Claude startet die Sitzung von dort neu, wo sie aufgehört hat. Ein ✢ ist eine /loop-Sitzung, die zwischen Iterationen schläft, wobei die Zeile ihre Laufzahl und einen Countdown zur nächsten Iteration anzeigt. 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. Sitzungen werden auf der Festplatte beibehalten: Das Schließen Ihres Terminals oder ein automatisches Update verliert sie nicht, und das erneute Öffnen von claude agents zeigt sie alle. Wenn Ihr Computer in den Ruhezustand wechselt oder heruntergefahren wird, werden laufende Sitzungen gestoppt; starten Sie sie mit claude respawn --all neu. Die einzeilige Zusammenfassung in jeder Zeile wird von Ihrem konfigurierten 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. Jede Aktualisierung ist eine kurze Haiku-Klasse-Anfrage durch Ihren normalen Anbieter, abgerechnet und behandelt unter denselben Datennutzungsbedingungen wie die Sitzung selbst. Wenn eine Sitzung einen Pull Request öffnet, wird ein Statusindikator am rechten Rand der Zeile angezeigt, verlinkt zum Pull Request in Terminals, die Hyperlinks unterstützen. Wenn die Sitzung mehr als einen Pull Request geöffnet hat, wird die Anzahl vor dem Indikator angezeigt und die Farbe spiegelt denjenigen wider, der am meisten Aufmerksamkeit benötigt.
Indikator-FarbePull-Request-Status
GelbWartet auf Überprüfungen oder Überprüfung, oder Überprüfungen fehlgeschlagen
GrünÜberprüfungen bestanden und keine Überprüfung blockiert
LilaZusammengeführt
GrauEntwurf oder geschlossen
Für die meisten Aufgaben ist diese Zeile, wo Sie das Ergebnis aufgreifen: überprüfen und führen Sie den Pull Request zusammen, wenn der Indikator 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. 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. 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, oder drücken Sie Alt+1 bis Alt+9, um sich direkt an die N-te Sitzung in der fokussierten Gruppe anzuhängen. Die Agenten-Ansicht wird durch die vollständige interaktive Sitzung ersetzt, genau so, als hätten Sie claude in diesem Verzeichnis ausgeführt. 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. 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. Das Abhängen stoppt niemals eine Hintergrund-Sitzung: ←, Ctrl+C, Ctrl+D, Ctrl+Z und /exit lassen sie alle laufen. Um eine Sitzung von innen zu beenden, führen Sie /stop aus. Nachdem Sie eine Sitzung versandt oder in den Hintergrund verschoben haben, funktioniert das Drücken von ← auf einer leeren Eingabeaufforderung 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 Sitzung vorausgewählt, sodass Sie zwischen Sitzungen wechseln können, ohne das Terminal zu verlassen. Sie können diesen Tastaturkürzel in /config ausschalten.

​
Die Liste organisieren

Die Agenten-Ansicht gruppiert Sitzungen nach Status, mit Sitzungen, die Eingabe benötigen, über Sitzungen, die funktionieren oder erledigt sind. Drücken Sie Ctrl+S, um stattdessen nach Verzeichnis zu gruppieren. Ihre Wahl wird über Läufe hinweg gespeichert. Heften Sie innerhalb einer Gruppe eine Sitzung mit Ctrl+T oben an, ordnen Sie mit Shift+↑ und Shift+↓ neu an, oder drücken Sie Enter auf einem Gruppenkopf, um ihn zu reduzieren. Um eine Sitzung 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. Ä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.

​
Die Liste filtern

Geben Sie in die Versand-Eingabe ein, um zu filtern, anstatt zu versenden:
FilterZeigt
a:<name>Sitzungen, die den benannten Agenten ausführen
s:<state>Sitzungen im angegebenen Status, z. B. s:blocked für Sitzungen, die Sie benötigen
#<number> oder eine PR-URLDie Sitzung, die an diesem Pull Request funktioniert

​
Tastaturkürzel

Drücken Sie ? in der Agenten-Ansicht, um jedes Kürzel zu sehen. Die häufigsten:
KürzelAktion
↑ / ↓Zwischen Zeilen verschieben
EnterAn die ausgewählte Sitzung anhängen oder versenden, wenn Text in der Eingabe vorhanden ist
SpaceVorschau-Panel für die ausgewählte Sitzung öffnen oder schließen
Shift+EnterVersenden und sofort anhängen
→An die ausgewählte Sitzung anhängen
Alt+1..Alt+9An die N-te Sitzung in der fokussierten Gruppe anhängen
TabAlle Subagenten durchsuchen oder den hervorgehobenen Vorschlag anwenden
Ctrl+SGruppierung zwischen Status und Verzeichnis wechseln
Ctrl+TAusgewählte Sitzung anheften oder abheften
Ctrl+RAusgewählte Sitzung umbenennen
Ctrl+GVersand-Eingabeaufforderung in Ihrem $EDITOR öffnen
Ctrl+XSitzung stoppen; drücken Sie erneut innerhalb von zwei Sekunden, um sie zu löschen
Shift+↑ / Shift+↓Ausgewählte Sitzung neu anordnen
EscVorschau-Panel schließen, Eingabe löschen oder beenden
Ctrl+CEingabe löschen; zweimal drücken, um zu beenden
?Alle Kürzel anzeigen

​
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:
EingabeEffekt
<agent-name> <prompt>Wenn das erste Wort einem benutzerdefinierten Subagenten-Namen entspricht, wird dieser Subagent als Hauptagent der Sitzung mit der Konfiguration aus seinem Frontmatter ausgeführt
@<agent-name>Erwähnen Sie einen benutzerdefinierten Subagenten überall in der Eingabeaufforderung, um ihn als Hauptagent auszuführen
@<repo>Erwähnen Sie ein Repository unter dem Verzeichnis, in dem Sie die Agenten-Ansicht geöffnet haben, um die Sitzung dort auszuführen
/<skill>Schlagen Sie Skills vor, um als Eingabeaufforderung zu versenden
#<number> oder eine Pull Request-URLWenn eine Sitzung bereits an diesem PR funktioniert, wählen Sie sie aus, anstatt zu versenden
Shift+EnterVersenden und sofort an die neue Sitzung anhängen
Geben Sie / ein, um einen Skill zu versenden. Das Verpacken einer wiederkehrenden Aufgabe als Skill ermöglicht es Ihnen, denselben Workflow viele Male aus der Agenten-Ansicht zu starten, ohne die Eingabeaufforderung erneut einzugeben. Drücken Sie Tab auf einer leeren Eingabe, um jeden versandbaren Subagenten zu durchsuchen, oder um den hervorgehobenen Vorschlag anzuwenden, wenn Vorschläge angezeigt werden. Wenn derselbe @name sowohl einem Subagenten als auch einem gleichgeordneten Repository entspricht, hat der Subagent Vorrang. Die Form ohne @ am Anfang gilt auch für jeden Subagenten-Namen, sodass eine Eingabeaufforderung, die mit einem Wort beginnt, das einem Ihrer Subagenten-Namen entspricht, diesen Subagenten versendet. Verwenden Sie die @-Form, wenn Sie explizit sein möchten.

​
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 zu trennen und es weiter laufen zu lassen. Übergeben Sie eine Eingabeaufforderung wie /bg run the test suite and fix any failures, um eine weitere Anweisung zu senden, bevor Sie sich trennen.

​
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"
Nach dem Versenden druckt Claude die kurze ID der Sitzung und die Befehle zu ihrer Verwaltung: 
backgrounded · 7c5dcf5d
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

​
Wie Dateibearbeitungen isoliert werden

Jede Hintergrund-Sitzung, ob aus der Agenten-Ansicht, /bg oder claude --bg gestartet, beginnt in Ihrem Arbeitsverzeichnis, wird aber vom Schreiben von Dateien dort blockiert. Wenn die Sitzung Dateien bearbeiten muss, verschiebt Claude sie automatisch in einen isolierten Git-Worktree unter .claude/worktrees/, sodass parallele Sitzungen denselben Checkout lesen können, aber jede in ihren eigenen schreibt. Die Blockade gilt nicht, wenn sich die Sitzung bereits in einem Worktree befindet, wenn das Arbeitsverzeichnis kein Git-Repository ist, oder für Schreibvorgänge außerhalb des Arbeitsverzeichnisses. Der Worktree wird entfernt, wenn Sie die Sitzung löschen, daher führen Sie die Änderungen zusammen oder pushen Sie sie, die Sie behalten möchten, bevor Sie die Sitzung löschen. 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. Um einen Subagenten immer in seinem eigenen Worktree auszuführen, unabhängig davon, wie er gestartet wurde, setzen Sie isolation: worktree in seinem Frontmatter.

​
Berechtigungsmodus und Einstellungen

Eine versendete Sitzung liest ihre Einstellungen und ihren Berechtigungsmodus aus dem Verzeichnis, in dem sie läuft, genauso wie wenn Sie claude dort gestartet hätten. Das Versenden aus der Agenten-Ansicht-Eingabe übergibt keinen Berechtigungsmodus, daher verwendet die Sitzung den defaultMode aus den Einstellungen dieses Verzeichnisses oder den permissionMode aus dem Frontmatter des versendeten Subagenten. Um den Modus aus der Shell zu setzen, übergeben Sie --permission-mode mit claude --bg. Die Verwendung von bypassPermissions oder auto auf diese Weise 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.

​
Sitzungen aus der Shell verwalten

Jede Hintergrund-Sitzung hat eine kurze ID, die Sie aus der Shell verwenden können. Diese Befehle sind nützlich zum Scripting oder wenn Sie die Agenten-Ansicht nicht öffnen möchten.
BefehlZweck
claude agentsAgenten-Ansicht öffnen
claude attach <id>An eine Sitzung in diesem Terminal anhängen
claude logs <id>Neueste Ausgabe der Sitzung drucken
claude stop <id>Eine Sitzung stoppen. Akzeptiert auch claude kill
claude respawn <id>Eine gestoppte Sitzung mit ihrem Gespräch intakt neu starten
claude respawn --allJede gestoppte Sitzung neu starten
claude rm <id>Eine Sitzung aus der Liste entfernen

​
Wie Hintergrund-Sitzungen gehostet werden

Hintergrund-Sitzungen werden von einem Supervisor-Prozess pro Benutzer gehostet, getrennt von Ihrem Terminal und von der Agenten-Ansicht. Es startet automatisch, wenn Sie zum ersten Mal eine Sitzung in den Hintergrund verschieben oder die Agenten-Ansicht öffnen, und Sie verwalten es 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, übergeordnet zum Supervisor anstelle zu Ihrem Terminal. Eine Sitzung, die aktiv funktioniert, auf Ihre Eingabe wartet oder ein Terminal angehängt hat, behält ihren Prozess am Laufen. Sobald eine Sitzung fertig ist und etwa eine Stunde lang unverbunden sitzt, stoppt der Supervisor seinen Prozess, um Ressourcen freizugeben. 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 in den Hintergrund verschieben oder die Agenten-Ansicht öffnen. 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. 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.
PfadInhalt
~/.claude/daemon.logSupervisor-Protokoll
~/.claude/daemon/roster.jsonListe der laufenden Hintergrund-Sitzungen, verwendet zum Wiederherstellen der Verbindung nach einem Neustart
~/.claude/jobs/<id>/state.jsonPro-Sitzungs-Status in der Agenten-Ansicht angezeigt
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

​
Agenten-Ansicht öffnet sich ohne Sitzungen

Die Agenten-Ansicht ist leer, bis Sie Ihre erste Sitzung versenden. Geben Sie eine Eingabeaufforderung in die Eingabe am unteren Rand ein und drücken Sie Enter.

​
Sitzungen werden nach dem Aufwachen Ihres Computers als gestoppt angezeigt

Hintergrund-Sitzungen überstehen Ruhezustand oder Herunterfahren nicht. Hängen Sie sich an, zeigen Sie Vorschau an oder antworten Sie auf eine gestoppte Sitzung und sie startet von dort neu, wo sie aufgehört hat. Um alle auf einmal neu zu starten, führen Sie claude respawn --all aus.

​
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 oder auf Sie warten, werden auf diese Weise nie gestoppt.

​
.claude/worktrees/ füllt sich auf

Worktrees werden entfernt, wenn Sie die Sitzung löschen, die sie erstellt hat. Wenn eine Sitzung endete, ohne aufzuräumen, 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. Aktuelle Einschränkungen, die Sie beachten sollten:
  • Ratenlimits gelten: Hintergrund-Sitzungen verbrauchen Ihre Abonnementnutzung genauso wie interaktive Sitzungen, daher verwendet das Ausführen von zehn Agenten parallel die Quote zehnmal schneller.
  • Sitzungen sind lokal: Hintergrund-Sitzungen laufen auf Ihrem Computer und stoppen, wenn er in den Ruhezustand wechselt oder heruntergefahren wird.
  • Worktrees werden mit der Sitzung 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.

​
Nächste Schritte

Nachdem Sie die Agenten-Ansicht verstanden haben, erkunden Sie diese verwandten Funktionen:
  • Agenten parallel ausführen: Vergleichen Sie die Agenten-Ansicht mit Subagenten, Agenten-Teams und Worktrees
  • Subagenten: Definieren Sie wiederverwendbare Agentenkonfigurationen mit benutzerdefinierten Eingabeaufforderungen, Tools und Isolation
  • 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