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, pro Aufgabe gestartet). (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) Nur Subagents lassen sich verschachteln (standardmäßig bis zu 3 Ebenen unterhalb der Hauptunterhaltung); 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. Zum Anlegen oder Bearbeiten bitten Sie Claude darum oder bearbeiten die Definitionsdatei direkt (seit v2.1.198 öffnet /agents keinen interaktiven Erstellungsassistenten mehr). Definiert werden sie in .claude/agents/<name>.md mit YAML-Frontmatter (name / description / tools / model). Eingebaut sind unter anderem Explore (schreibgeschützt; seit v2.1.198 übernimmt es das Modell der Hauptunterhaltung, in der Claude API höchstens Opus), Plan und general-purpose. Subagents lassen sich verschachteln, standardmäßig bis zu 3 Ebenen unterhalb der Hauptunterhaltung (ab v2.1.219; an der Tiefengrenze wird das Agent tool nicht weitergereicht, sodass sie keine weiteren erzeugen können. Die Grenze ändern Sie mit CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH; 1 schaltet die Verschachtelung ab). 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 | Geben vor allem ein Ergebnis an den Aufrufer zurück (benannte Subagenten können sich auch gegenseitig Nachrichten schicken) | teammates schreiben einander direkt über die Mailbox |
| Beständigkeit | Pro Aufgabe gestartet (geben eine Zusammenfassung zurück; fortsetzbar) | 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 | Standardmäßig bis zu 3 Ebenen tiefer (Grenze einstellbar) | 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, pro Aufgabe, 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: 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 # seit v2.1.198 ohne Assistent (Claude bitten oder Dateien unten bearbeiten)
.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 für den Review von PR #142:
# einen für Sicherheit, einen für Performance, einen für Testabdeckung."
# Anzeige über 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. Wie das Modell bestimmt wird und was ein Praxistest mit anderen Modellen ergibt, zeigt Claude Code: Subagenten mit anderem Modell ausführen. 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, pro Aufgabe gestartet, berichten vor allem an den Aufrufer, verschachteln standardmäßig bis zu 3 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: 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. Beachten Sie zudem, dass die beiden hier verglichenen Wege beide auf Ihrem eigenen Rechner laufen. Als Option in der Cloud, die weiterläuft, auch wenn Sie das Terminal schließen, kam im September 2026 Projects hinzu, wo Claude selbst Threads startet und im Blick behält. 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 berichten vor allem an den Aufrufer, benannte können sich aber gegenseitig Nachrichten schicken; pro Aufgabe gestartet und fortsetzbar). 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. Welches von beiden lässt sich verschachteln?
A. Subagents. Ein Subagent kann eigene Subagenten erzeugen, standardmäßig bis zu 3 Ebenen unterhalb der Hauptunterhaltung (ab v2.1.219; die Grenze ändern Sie mit CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH, und 1 schaltet die Verschachtelung ab). 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. Gibt es außer diesen beiden noch andere Wege zu parallelisieren?
A. Ja. Die offizielle Dokumentation ordnet die Parallelisierung in fünf Ansätze: neben den beiden aus diesem Artikel gibt es agent view (dispatch), dynamische Workflows und das im September 2026 hinzugekommene Projects. Agent view ist der Bildschirm, den Sie mit claude agents öffnen und auf dem Sie unabhängige Aufgaben abgeben und die Ergebnisse später einsammeln (Research Preview). Subagents heißen „Claude delegiert innerhalb eines Gesprächs“ und Agent Teams heißen „Claude führt Regie“, während bei agent view Sie selbst Regie führen. Das Isolationsmodell und die Punkte, auf die man achten muss, behandelt ein eigener Artikel.
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.
