Skip to main content
Agent-Teams sind experimentell und standardmäßig deaktiviert. Aktivieren Sie sie, indem Sie CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS zu Ihrer settings.json oder Umgebung hinzufügen. Ohne diese Variable wird kein Team beim Sitzungsstart eingerichtet, keine Team-Verzeichnisse werden geschrieben, und Claude spawnt oder schlägt keine Teammates vor. Agent-Teams haben bekannte Einschränkungen bezüglich Sitzungswiederaufnahme, Aufgabenkoordination und Abschaltungsverhalten.
Agent-Teams ermöglichen es Ihnen, mehrere Claude Code-Instanzen zu koordinieren, die zusammenarbeiten. Eine Sitzung fungiert als Team-Lead und koordiniert die Arbeit, weist Aufgaben zu und synthetisiert Ergebnisse. Teammates arbeiten unabhängig, jeder in seinem eigenen Kontextfenster, und kommunizieren direkt miteinander. Im Gegensatz zu subagents, die innerhalb einer einzelnen Sitzung ausgeführt werden und nur an den Hauptagenten berichten können, können Sie auch direkt mit einzelnen Teammates interagieren, ohne den Lead einzubeziehen.
Diese Seite beschreibt Agent-Teams ab v2.1.178. Mit CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS gesetzt, benötigt das Spawnen eines Teammates keinen Setup-Schritt mehr, und die Bereinigung erfolgt automatisch, wenn die Sitzung beendet wird. Vor v2.1.178 haben Sie Claude gebeten, ein Team zu erstellen und zu benennen, und Claude hat die Tools TeamCreate und TeamDelete verwendet, um es einzurichten und zu entfernen. Beide Tools existieren nicht mehr. Die team_name-Eingabe im Agent-Tool wird akzeptiert, aber ignoriert, und das team_name-Feld in TaskCreated, TaskCompleted und TeammateIdle Hook-Payloads trägt den sitzungsabgeleiteten Namen und ist veraltet.

​
Wann Agent-Teams verwendet werden

Agent-Teams sind am effektivsten für Aufgaben, bei denen parallele Exploration echten Wert bietet. Siehe Anwendungsbeispiele für vollständige Szenarien. Die stärksten Anwendungsfälle sind:
  • Recherche und Überprüfung: mehrere Teammates können verschiedene Aspekte eines Problems gleichzeitig untersuchen und dann ihre Erkenntnisse austauschen und in Frage stellen
  • Neue Module oder Features: Teammates können jeweils ein separates Stück besitzen, ohne sich gegenseitig zu behindern
  • Debugging mit konkurrierenden Hypothesen: Teammates testen verschiedene Theorien parallel und konvergieren schneller zur Antwort
  • Schichtenübergreifende Koordination: Änderungen, die Frontend, Backend und Tests umfassen, jeweils von einem anderen Teammate verwaltet
Agent-Teams fügen Koordinationsaufwand hinzu und verwenden deutlich mehr Tokens als eine einzelne Sitzung. Sie funktionieren am besten, wenn Teammates unabhängig arbeiten können. Für sequenzielle Aufgaben, Bearbeitungen in derselben Datei oder Arbeit mit vielen Abhängigkeiten sind eine einzelne Sitzung oder subagents effektiver.

​
Vergleich mit subagents

Sowohl Agent-Teams als auch subagents ermöglichen es Ihnen, Arbeit zu parallelisieren, aber sie funktionieren unterschiedlich. Wählen Sie basierend darauf, ob Ihre Worker miteinander kommunizieren müssen:
Diagramm zum Vergleich von Subagent- und Agent-Team-Architekturen. Subagents werden vom Hauptagenten erzeugt, führen Arbeit aus und berichten Ergebnisse zurück. Agent-Teams koordinieren sich über eine gemeinsame Aufgabenliste, wobei Teammates direkt miteinander kommunizieren.

Subagents berichten Ergebnisse nur an den Hauptagenten zurück und sprechen nie miteinander. Bei Agent-Teams teilen sich Teammates eine Aufgabenliste, beanspruchen Arbeit und kommunizieren direkt miteinander.