Claude Code Agent Teams: Wenn Sub-Agents nicht mehr reichen

Sub-Agents sind gut für eine Sache: einen schnellen, isolierten Job, der sich einmal zurückmeldet. Einen starten, er macht die Arbeit, meldet das Ergebnis, fertig. Aber sobald eine Aufgabe wirklich mehrere Perspektiven braucht, die miteinander reden — Ergebnisse gegenseitig hinterfragen, Zuständigkeiten aufteilen, sich selbst koordinieren — trägt dieses Einweg-Melde-Modell nicht mehr.

Genau diese Lücke schließen Agent Teams (aktuell experimentell). Ein Team Lead spawnt Teammitglieder, die sich gegenseitig Nachrichten schicken, eine Aufgabenliste teilen und sich gegenseitig widersprechen können, bevor überhaupt etwas bei dir ankommt.

Wann sich das wirklich lohnt#

Nicht jeder Job braucht ein Team. Es lohnt sich bei:

Paralleler Exploration — mehrere wirklich unterschiedliche Blickwinkel bringen Mehrwert: ein Agent auf UX, einer auf Architektur, einer bewusst als Advocatus Diaboli.
Komplexem Debugging — mehrere Hypothesen gleichzeitig testen, um schneller zur Root Cause zu kommen.
Getrennter Feature-Eigentümerschaft — Agents besitzen jeweils eine eigene Datei oder einen eigenen Ordner, ohne sich in die Quere zu kommen.
Cross-Layer-Koordination — eine Änderung betrifft Frontend, Backend und Tests, und jede Ebene braucht einen dedizierten Owner.
Peer Review — derselbe PR wird gleichzeitig aus unterschiedlichen Blickwinkeln reviewt: Security, Performance, Accessibility.
Echter Inter-Agent-Zusammenarbeit — die Worker müssen sich wirklich gegenseitig Nachrichten schicken und selbst koordinieren.

Für alles Einfachere ist ein normaler Sub-Agent immer noch die richtige Wahl.

Die Architektur#

Team Lead — die Hauptsession. Erstellt das Team, spawnt die Teammitglieder, koordiniert die Arbeit.
Teammitglieder — separate Claude-Code-Instanzen, jede arbeitet an einem zugewiesenen Teil.
Geteilte Aufgabenliste — die Arbeitspakete, die Teammitglieder beanspruchen und abschließen.
Mailbox — das interne Nachrichtensystem, über das sich Teammitglieder untereinander austauschen.

Jedes Teammitglied bekommt sein eigenes Context-Window. Beim Spawnen lädt es denselben Projekt-Kontext wie eine normale Session — CLAUDE.md, MCP-Server, Skills — plus den spezifischen Spawn-Prompt vom Lead.

Im Video#

00:00 — Sub-Agents vs. Agent Teams: wo das Einweg-Melde-Modell nicht mehr trägt
01:51 — Die Architektur: Lead, Teammitglieder, geteilte Aufgabenliste, Mailbox
03:06 — Ein echtes Team aufsetzen: drei Agents greifen ein CLI-Tool aus unterschiedlichen Blickwinkeln an (Developer Experience, Architektur, Packaging-Strategie)
06:32 — Das experimentelle Flag in settings.json aktivieren — das Feature ist standardmäßig aus
07:29 — Live laufen lassen, zwischen Agents navigieren mit Shift+Hoch/Runter

Eins aufsetzen#

Aktivieren braucht ein einziges Flag. In settings.json:

json

{
  "environment": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Danach sagst du Claude einfach, ein Agent Team zu erstellen, und beschreibst die Blickwinkel, die abgedeckt werden sollen. Im Video ist das Ziel ein CLI, das MCP-Dokumentationsserver aus einer Sitemap generiert — und das Team bekommt drei Blickwinkel zugewiesen: Developer Experience, technische Architektur, Packaging-/Publishing-Strategie. Du kannst pro Agent ein bestimmtes Modell festlegen, eine Plan-Freigabe verlangen, bevor ein Teammitglied Änderungen macht — und, besonders erwähnenswert: den Delegate Mode aktivieren, sodass der Team Lead nur orchestriert und auf Ergebnisse reagiert, statt sich selbst auch Aufgaben von der gemeinsamen Liste zu schnappen.

Wie es sich aktuell wirklich anfühlt#

Läuft es, navigierst du mit Shift und Hoch/Runter zwischen den laufenden Agents und schaust jedem bei seinem Blickwinkel zu. Wirklich nützlich, um ein Problem aus Winkeln angreifen zu lassen, an die man selbst nicht gedacht hätte — aber es ist ein experimentelles Feature, und das merkt man: Du babysittest noch jeden Agent-Fortschritt, statt es zu starten und wegzugehen.

Worum es eigentlich geht#

Greif zu einem Sub-Agent, wenn du eine schnelle, fokussierte Antwort brauchst und nichts weiter. Greif zu einem Agent Team nur, wenn der Job wirklich Teammitglieder braucht, die miteinander reden — parallele Blickwinkel auf ein hartes Problem, oder sauber getrennte Zuständigkeit über Ebenen hinweg. Alles darunter, und du zahlst nur den Koordinationsaufwand, ohne einen echten Grund dafür.