Inhaltsverzeichnis
Wenn Sie in Claude Code mehrere KIs die Arbeit aufteilen lassen wollen, gibt es zwei ähnliche, aber grundverschiedene Mechanismen — Subagents und Agent Teams. Die Namen sind verwirrend, doch ihre Rollen und Arten der Koordination unterscheiden sich grundlegend. Dieser Artikel klärt auf Basis der offiziellen Dokumentation, was beides ist, worin der entscheidende Unterschied liegt, welches Sie wann verwenden und wie.
Vorab drei zentrale Punkte. (1) Subagents sind eine eingebaute Funktion — der Hauptagent delegiert eine fokussierte Teilaufgabe an einen „Helfer mit frischem Kontext" und erhält nur eine Zusammenfassung zurück (hierarchisch, kurzlebig). (2) Agent Teams sind eine experimentelle Opt-in-Funktion, die standardmäßig deaktiviert ist. Sie funktionieren erst, wenn Sie CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 setzen — mehrere eigenständige Sessions koordinieren sich als gleichberechtigte Partner über eine geteilte Aufgabenliste (Peer-to-Peer, dauerhaft). (3) „5 Ebenen tief verschachtelt" ist eine Subagents-Eigenschaft; Agent Teams können nicht verschachtelt werden (sie sind flach) — verwechseln Sie die beiden nicht.
Hierarchie oder gleichberechtigt?
— delegieren und eine Zusammenfassung erhalten, oder als Gleiche koordinieren
Subagents: Der Hauptagent übergibt einem Helfer eine Aufgabe und erhält das Ergebnis. Agent Teams: Gleichberechtigte Partner koordinieren sich über eine geteilte Aufgabenliste.
Teams sind eine standardmäßig deaktivierte experimentelle Funktion — CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 ist erforderlich.
1. Was Subagents sind
Subagents sind spezialisierte Agenten, die bestimmte Arten von Arbeit innerhalb einer einzigen Session übernehmen. Laut offizieller Dokumentation gilt: „Jeder Subagent läuft in seinem eigenen Kontextfenster, mit einem eigenen System-Prompt und spezifischen Tool-Berechtigungen." Der Hauptagent delegiert automatisch anhand der description jedes Subagents, und der Subagent arbeitet eigenständig und gibt nur eine Zusammenfassung an die Hauptkonversation zurück.
Entscheidend ist, dass „jeder Subagent in einem frischen, separaten Kontext läuft" — er sieht weder Ihren Gesprächsverlauf noch Dateien, die Sie bereits gelesen haben. So können Sie aufwändige Recherchen „außerhalb" erledigen lassen und nur das Fazit erhalten, ohne Ihren Hauptkontext mit Logs oder Testausgaben zu fluten. Verwaltet werden sie über /agents (Tabs Running / Library). Definiert werden sie in .claude/agents/<name>.md mit YAML-Frontmatter (name / description / tools / model). Eingebaut sind unter anderem Explore (Haiku, schreibgeschützt), Plan und general-purpose. Subagents lassen sich verschachteln, bis zu 5 Ebenen tief (auf Ebene 5 wird das Agent tool nicht weitergereicht, sodass sie keine weiteren erzeugen können). Den größeren Zusammenhang finden Sie unter Was ist ein Multi-Agenten-System.
2. Was Agent Teams sind (experimentell, per Flag)
Mit Agent Teams können Sie mehrere Claude-Code-Sessions als „Team" koordinieren. Eine davon ist der team lead (koordiniert, weist zu, fasst zusammen); die anderen sind teammates — jeweils eine eigene, unabhängige Session und ein eigener Kontext — die direkt miteinander über eine geteilte Aufgabenliste (shared task list) und eine Mailbox kommunizieren. Anders als bei Subagents können Sie mit einzelnen teammates direkt sprechen.
Wichtig: Agent Teams ist eine experimentelle Funktion, standardmäßig deaktiviert
Die offizielle Dokumentation stellt unmissverständlich fest: „Agent Teams sind experimentell und standardmäßig deaktiviert." Um sie zu nutzen, setzen Sie die Umgebungsvariable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 (oder über env in der settings.json). Ohne sie wird beim Start kein Team erstellt, und Claude schlägt weder teammates vor noch erzeugt es welche.
Beachten Sie, dass die Änderung in v2.1.178 lediglich „den Einrichtungsschritt TeamCreate/TeamDelete entfernt hat, sodass bei gesetztem Flag jede Session ein implizites Team besitzt" — sie hat Teams nicht „standardmäßig aktiviert." Das Flag ist weiterhin erforderlich.
3. Der entscheidende Unterschied
Im direkten Vergleich koordinieren sich die beiden auf völlig unterschiedliche Weise.
| Subagents | Agent Teams | |
|---|---|---|
| Koordination | Hierarchisch (Haupt delegiert, aggregiert Ergebnisse) | Peer-to-Peer (Selbstkoordination über eine geteilte Aufgabenliste) |
| Kommunikation | Berichten nur an den Aufrufer (sprechen nie miteinander) | teammates schreiben einander direkt über die Mailbox |
| Beständigkeit | Kurzlebig (geben nach der Aufgabe eine Zusammenfassung zurück) | Dauerhafte unabhängige Sessions (direkt steuerbar) |
| Kontext | Eigener frischer Kontext; Zusammenfassung geht an Haupt zurück | Vollständig unabhängig (nichts wird automatisch zurückgefasst) |
| Token-Kosten | Relativ niedrig | Hoch (jeder teammate ist eine separate Claude-Instanz) |
| Status | Eingebaut, immer verfügbar | Experimentell, per Flag, standardmäßig aus |
| Verschachtelung | Subagents verschachteln sich bis zu 5 Ebenen | Keine Verschachtelung (teammates können keine teammates erzeugen) |
In einem Satz: Subagents = „Der Hauptagent übergibt einem Helfer mit frischem Kontext eine fokussierte Aufgabe und erhält das Fazit zurück (hierarchisch, kurzlebig, nur Zusammenfassung)." Agent Teams = „Mehrere dauerhafte Sessions koordinieren sich über eine geteilte Aufgabenliste und Nachrichten, und Sie können jede einzeln steuern (gleichberechtigt, unabhängig)." Ein häufiger Irrtum: „5 Ebenen Verschachtelung" ist eine Subagents-Eigenschaft, während Teams flach sind (keine Verschachtelung).
4. Welches Sie verwenden sollten
Wählen Sie nach Zweck, dann grübeln Sie nicht lange. Die meiste tägliche Arbeit ist mit Subagents (oder einer einzigen Session) gut bedient.
Nach Zweck wählen
· die Arbeit in sich abgeschlossen ist und nur das Ergebnis zählt
· Sie Tool-Beschränkungen oder ein günstigeres Modell wollen
· die Arbeiter nicht miteinander sprechen müssen
· paralleles Erkunden sich lohnt (paralleler Review / Debugging konkurrierender Hypothesen / mehrere Module)
· Sie jeden Arbeiter steuern wollen
(höhere Kosten + Flag akzeptieren)
· Sie häufiges Hin und Her brauchen
· sie dieselben Dateien betrifft
· es eine schnelle lokale Änderung ist
Greifen Sie standardmäßig zu „im Zweifel eine einzige Session oder Subagents."
Zu Agent Teams greifen Sie nur bei paralleler Arbeit, die echte Peer-Koordination braucht.
5. Spickzettel zur Nutzung
Eine Kurzreferenz für Befehle und Konfiguration.
# --- Subagents (eingebaut) ---
/agents # Verwaltung (Running / Library)
.claude/agents/<name>.md # Projektdefinition (name/description/tools/model)
~/.claude/agents/<name>.md # Benutzerdefinition (alle Projekte)
claude --agent code-reviewer # die ganze Session als bestimmten Subagent ausführen
@agent-<name> # per @-Mention explizit aufrufen
# --- Agent Teams (experimentell, per Flag) ---
# Per env aktivieren (oder env in settings.json); standardmäßig AUS
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
# Dann in normaler Sprache beschreiben, z. B.: "Erzeuge drei teammates fuer den Review von PR #142:
# einen fuer Sicherheit, einen fuer Performance, einen fuer Testabdeckung."
# Anzeige ueber teammateMode (Standard in-process; geteilte Panes brauchen tmux/iTerm2)In einer Subagent-Definitionsdatei können Sie mit tools die Tools einschränken oder mit model auf ein leichteres Modell wie haiku umleiten. Zum Erstellen und Entwerfen von Agenten siehe Wie man ein Multi-Agenten-System baut und Wie man einen KI-Agenten baut.
6. Hinweise zu Agent Teams
Agent Teams sind mächtig, bringen aber die Grenzen und Kosten eines experimentellen Stadiums mit sich. Diese sollten Sie vor dem Einsatz kennen.
(1) Ein Team pro Session, keine Verschachtelung — teammates können keine teammates erzeugen, und der Lead ist fest. (2) Hoher Token-Verbrauch (jeder teammate ist eine separate Claude-Instanz); empfohlen werden 3 bis 5 teammates. (3) teammates sind nicht in worktrees isoliert, sodass sie sich gegenseitig überschreiben, wenn sie dieselben Dateien anfassen — teilen Sie die Dateien manuell auf. (4) Als experimentelle Funktion gibt es Einschränkungen, etwa dass /resume und /rewind in-process teammates nicht wiederherstellen. (5) Geteilte Panes brauchen tmux oder iTerm2 (manche Terminals wie das von VS Code werden nicht unterstützt). Kurz gesagt: Setzen Sie es nur ein, wenn der Nutzen paralleler Koordination die Kosten und den Aufwand überwiegt.
Fazit
Die Subagents und Agent Teams von Claude Code „teilen beide Arbeit auf mehrere KIs auf", doch ihre Koordinationsmodelle unterscheiden sich. Subagents sind eingebaut — der Hauptagent delegiert eine fokussierte Aufgabe an einen Helfer mit frischem Kontext und erhält nur eine Zusammenfassung zurück (hierarchisch, kurzlebig, sprechen nicht miteinander, verschachteln bis zu 5 Ebenen). Agent Teams sind ein experimentelles Opt-in, standardmäßig aus (benötigt CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1) — mehrere unabhängige Sessions koordinieren sich als gleichberechtigte Partner über eine geteilte Aufgabenliste und Nachrichten (dauerhaft, jede einzeln steuerbar, keine Verschachtelung).
So wählen Sie: „nur das Ergebnis gewollt / Kontext nicht verschmutzen wollen → Subagents," „parallele Arbeit, bei der Arbeiter teilen und koordinieren müssen → Agent Teams," „sequenziell / dieselben Dateien / schneller Fix → eine einzige Session." Eine häufige Verwechslung: „5 Ebenen Verschachtelung" ist eine Subagents-Eigenschaft; Teams sind flach. Und beachten Sie, dass v2.1.178 den Team-Start gestrafft hat — es hat ihn nicht „standardmäßig aktiviert." Teams sind kostspielig und experimentell, beschränken Sie sie also auf Fälle, in denen sich die Koordination auszahlt. Verwandt: Was ist ein Multi-Agenten-System, wie man eines baut, KI-Observability.
FAQ
Q. Worin unterscheiden sich Subagents und Agent Teams?
A. Ihre Koordination ist grundlegend verschieden. Subagents sind hierarchisch — der Hauptagent delegiert eine fokussierte Aufgabe an einen Helfer mit frischem Kontext und erhält nur eine Zusammenfassung zurück (Helfer sprechen nicht miteinander; kurzlebig). Agent Teams sind Peer-to-Peer — mehrere unabhängige Sessions koordinieren sich über eine geteilte Aufgabenliste und eine Mailbox, und Sie können jede einzeln steuern (dauerhaft). Subagents sind eingebaut; Agent Teams sind experimentell und benötigen ein Flag.
Q. Kann ich Agent Teams sofort verwenden?
A. Nein — sie sind standardmäßig deaktiviert. Sie müssen CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in env setzen (oder über env in der settings.json). v2.1.178 hat nur den Start gestrafft (es hat „den Einrichtungsschritt TeamCreate entfernt, sodass bei gesetztem Flag jede Session ein implizites Team besitzt") — es hat Teams nicht „standardmäßig aktiviert." Das Flag ist weiterhin erforderlich.
Q. Worauf bezieht sich „verschachtelt bis zu 5 Ebenen"?
A. Auf Subagents. Ein Subagent kann eigene Subagents erzeugen, bis zu 5 Ebenen tief (auf Ebene 5 geht es nicht weiter). Agent Teams können nicht verschachtelt werden — teammates können keine teammates erzeugen, und nur der Lead verwaltet das Team. Verwechseln Sie die beiden nicht.
Q. Ich kann nicht entscheiden, welches ich verwenden soll.
A. Meistens reicht eine einzige Session oder Subagents. Wenn Sie nur das Ergebnis wollen und keine umfangreiche Ausgabe Ihren Hauptkontext fluten soll, verwenden Sie Subagents. Wenn Arbeiter Erkenntnisse teilen, gegenprüfen und sich selbst koordinieren müssen bei paralleler Arbeit (paralleler Review, Debugging konkurrierender Hypothesen, Entwicklung mehrerer Module) und Sie jeden steuern wollen, verwenden Sie Agent Teams. Für sequenzielle Arbeit, häufiges Hin und Her oder das Anfassen derselben Dateien passt eine einzige Session.
Q. Worauf sollte ich bei Agent Teams achten?
A. Hoher Token-Verbrauch (jeder teammate ist eine separate Instanz; 3 bis 5 empfohlen), ein Team pro Session ohne Verschachtelung, teammates sind nicht in worktrees isoliert, sodass sie bei denselben Dateien in Konflikt geraten (manuell aufteilen), experimentelle Einschränkungen bei /resume und /rewind, und geteilte Panes brauchen tmux/iTerm2. Setzen Sie es nur bei paralleler Arbeit ein, bei der die Koordination die Kosten überwiegt.
