Anmerkung des Autors: Diese Schritt-für-Schritt-Anleitung zeigt dir, wie du die Multi-Agenten-Kollaborationsfunktion „Claude 4.6 Agent Teams“ aktivierst und nutzt. Du lernst die Lead + Teammate-Architektur, Aufgabenverteilung, Nachrichtenkommunikation und praktische Tipps für den Einsatz kennen.
Mit der Veröffentlichung von Claude Opus 4.6 wurde zeitgleich das Feature Agent Teams (Multi-Agenten-Teams) eingeführt. Damit können mehrere Claude-Instanzen wie ein echtes Entwicklerteam parallel zusammenarbeiten. Viele Entwickler sind neugierig: Wie aktiviert man Agent Teams überhaupt? Wie wird es ausgelöst? Was ist der Unterschied zu Subagents? Und für welche Szenarien ist es geeignet?
Kernwert: Nach der Lektüre dieses Artikels wirst du den kompletten Workflow von Agent Teams beherrschen – von der Konfiguration über die Befehlsauslösung bis hin zur Aufgabenverteilung und Teamkollaboration. So startest du sofort mit der Multi-Agenten-Programmierung durch.
Was ist Claude Agent Teams?
Agent Teams ist ein experimentelles Feature von Claude Code (befindet sich in der Research Preview Phase). Es ermöglicht dir, innerhalb eines Projekts mehrere unabhängige Claude-Code-Instanzen gleichzeitig laufen zu lassen, die über eine gemeinsame Aufgabenliste und ein Nachrichtensystem zusammenarbeiten.
Kurz gesagt: Agent Teams = ein Lead (Teamleiter) + mehrere Teammates (Teammitglieder), die jeweils eigenständig arbeiten, miteinander kommunizieren und gemeinsam komplexe Aufgaben lösen.
| Vergleichsaspekt | Subagent | Agent Teams |
|---|---|---|
| Kommunikation | Meldet Ergebnisse nur an den Haupt-Agenten | Teammitglieder können direkt miteinander kommunizieren |
| Koordination | Haupt-Agent verwaltet alles | Gemeinsame Aufgabenliste + eigenständige Übernahme |
| Kontext | Unabhängiger Kontext, Ergebnis geht an Aufrufer zurück | Unabhängiger Kontext, völlig autonom |
| Bestes Szenario | Fokussierte Aufgaben, bei denen nur das Ergebnis zählt | Komplexe Aufgaben, die Diskussion und Kollaboration erfordern |
| Token-Verbrauch | Niedriger (Ergebnisse werden im Hauptkontext zusammengefasst) | Höher (jedes Teammitglied ist eine eigene Claude-Instanz) |
Kernarchitektur von Claude Agent Teams
Agent Teams besteht aus vier Kernkomponenten:
| Komponente | Verantwortung | Beschreibung |
|---|---|---|
| Lead Agent | Teamleiter | Deine Haupt-Claude-Code-Session. Verantwortlich für Teamerstellung, Aufgabenverteilung und Ergebniszusammenführung. |
| Teammate | Teammitglied | Unabhängige Claude-Code-Instanzen, die jeweils zugewiesene Aufgaben ausführen. |
| Task List | Gemeinsame Aufgabenliste | Ein für alle sichtbares Aufgaben-Board, das Übernahme, Abhängigkeiten und Status-Tracking unterstützt. |
| Mailbox | Nachrichtensystem | Kommunikationskanal zwischen Teammitgliedern, unterstützt private Nachrichten und Broadcasts. |
💡 Wichtiger Unterschied: Ein Subagent folgt dem Modell „Untergebener berichtet an Vorgesetzten“, während Agent Teams auf „Teamkollaboration“ setzt. Wenn deine Aufgabe Diskussionen zwischen mehreren Personen erfordert, Standpunkte hinterfragt werden müssen oder verschiedene Module parallel bearbeitet werden sollen, ist Agent Teams die bessere Wahl.
Wie man Claude Agent Teams aktiviert
Agent Teams sind standardmäßig deaktiviert und müssen manuell aktiviert werden. Hier sind 3 Möglichkeiten zur Aktivierung:
Schritt 1: Experimentelle Funktionen aktivieren
Methode A — Konfigurationsdatei (empfohlen)
Fügen Sie in der settings.json von Claude Code Folgendes hinzu:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Methode B — Umgebungsvariable
# Zu .bashrc oder .zshrc hinzufügen
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Methode C — Einzelsitzung
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
Schritt 2: Agent Teams mit natürlicher Sprache triggern
Es gibt keinen Slash-Befehl wie /agent-teams. Sobald die Funktion aktiviert ist, müssen Sie Ihr gewünschtes Team lediglich in natürlicher Sprache beschreiben:
Erstelle ein Agent-Team, um PR #142 zu prüfen. Generiere drei Reviewer:
- Einer konzentriert sich auf Sicherheitsrisiken
- Einer prüft die Auswirkungen auf die Performance
- Einer validiert die Testabdeckung
Lass sie jeweils einzeln prüfen und anschließend über ihre Ergebnisse berichten.
Oder noch einfacher:
Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.
Claude erstellt automatisch das Team, generiert die Teammitglieder und weist die Aufgaben zu. Claude kann auch proaktiv vorschlagen, ein Team zu erstellen – falls es entscheidet, dass Ihre Aufgabe für eine parallele Verarbeitung geeignet ist. In diesem Fall wird es jedoch zuerst um Ihre Bestätigung bitten.
Schritt 3: Anzeigemodus wählen
| Anzeigemodus | Beschreibung | Geeignete Umgebung |
|---|---|---|
| in-process (Standard) | Alle Teammitglieder laufen im Hauptterminal | Jedes Terminal, einschließlich VS Code |
| tmux | Jedes Teammitglied in einem eigenen Panel | Erfordert tmux oder iTerm2 |
| auto | Automatische Erkennung | Splitscreen, falls bereits in tmux, sonst in-process |
# Über die Befehlszeile festlegen
claude --teammate-mode tmux
# Oder in der settings.json einstellen
{
"teammateMode": "tmux"
}
Empfehlung: Für den ersten Gebrauch wird der
in-process-Modus empfohlen. Sobald Sie damit vertraut sind, können Sie dentmux-Splitscreen-Modus ausprobieren. Über APIYI (apiyi.com) erhalten Sie Claude API-Guthaben, um verschiedene Konfigurationen von Agent Teams lokal ausgiebig zu testen.
Claude Agent Teams Bedienungsanleitung
Tastaturkürzel-Referenz
Während Agent Teams ausgeführt wird, können Sie die folgenden Tastenkombinationen verwenden:
| Tastenkürzel | Funktion |
|---|---|
| Shift+Auf/Ab | Zwischen Teammitgliedern wechseln/auswählen |
| Enter | Sitzungsdetails des ausgewählten Teammitglieds anzeigen |
| Escape | Aktuelle Aktion des Teammitglieds abbrechen |
| Ctrl+T | Aufgabenlisten-Ansicht umschalten |
| Shift+Tab | Delegationsmodus umschalten (Lead koordiniert nur, programmiert nicht) |
Aufgabenzuweisung und -übernahme
Das Aufgabensystem von Agent Teams unterstützt 3 Status und Abhängigkeiten:
Aufgabenstatus: pending (ausstehend) → in_progress (in Bearbeitung) → completed (abgeschlossen)
Abhängigkeitsmechanismus: Aufgaben können eine blockedBy-Abhängigkeit haben. Sobald die abhängige Aufgabe abgeschlossen ist, wird die nachfolgende Aufgabe automatisch freigeschaltet, ohne dass ein manuelles Eingreifen erforderlich ist.
Übernahmemethoden:
- Zuweisung durch den Lead: Sagen Sie dem Lead explizit, dass er eine bestimmte Aufgabe einem bestimmten Teammitglied zuweisen soll.
- Eigenständige Übernahme: Nach Abschluss der aktuellen Aufgabe übernimmt das Teammitglied automatisch die nächste verfügbare, nicht zugewiesene Aufgabe.
- Dateisperren zur Vermeidung von Race Conditions: Wenn mehrere Teammitglieder gleichzeitig versuchen, dieselbe Aufgabe zu übernehmen, verwendet das System Dateisperren, um Konflikte zu vermeiden.
Empfohlene Aufgabengröße: Es hat sich bewährt, jedem Teammitglied 5-6 Aufgaben zuzuweisen. Zu kleine Aufgaben führen dazu, dass der Koordinationsaufwand den Nutzen übersteigt; bei zu großen Aufgaben berichten die Teammitglieder zu lange nicht über ihren Fortschritt.
Kommunikation zwischen Teammitgliedern
| Kommunikationstyp | Beschreibung | Einsatzszenario |
|---|---|---|
| write (Direktnachricht) | Nachricht an ein bestimmtes Teammitglied senden | Koordination spezifischer Probleme |
| broadcast (Rundsendung) | Nachricht an alle Teammitglieder senden | Wichtige Ankündigungen (Vorsicht: Kosten steigen mit der Teamgröße) |
Die Kommunikation erfolgt Peer-to-Peer und muss nicht über den Lead laufen. Jedes Teammitglied kann anderen Teammitgliedern direkt Nachrichten senden.
Git-Zusammenarbeit und Vermeidung von Dateikonflikten
Die wichtigste Regel in Agent Teams: Wenn zwei Teammitglieder dieselbe Datei bearbeiten, führt dies zu Überschreibungen.
Empfohlene Strategie zur Aufgabenteilung:
# Beispiel für Full-Stack-Feature-Entwicklung
Backend-Kollege → Zuständig für src/api/ und src/migrations/
Frontend-Kollege → Zuständig für src/components/
Test-Kollege → Zuständig für tests/
⚠️ Wichtig: Die Teammitglieder von Agent Teams teilen sich dasselbe Arbeitsverzeichnis und verwenden nicht automatisch
git worktree. Sicherzustellen, dass jedes Teammitglied für unterschiedliche Dateisets zuständig ist, ist der Schlüssel zur Vermeidung von Konflikten.
5 Praxis-Szenarien für Claude Agent Teams
Szenario 1: Code-Review aus mehreren Perspektiven
Erstelle ein Agent Team, um diesen PR zu prüfen:
- Sicherheits-Reviewer: Prüft auf Injektionen, XSS, Berechtigungen usw.
- Performance-Reviewer: Analysiert N+1-Abfragen, Speicherlecks, Caching-Strategien.
- Test-Reviewer: Validiert Testabdeckung und Grenzfälle.
Lass sie jeweils einzeln prüfen und anschließend über ihre Ergebnisse berichten.
Warum es für Agent Teams geeignet ist: Die drei Review-Dimensionen sind völlig unabhängig voneinander, verursachen keine Dateikonflikte und können parallel ausgeführt werden.
Szenario 2: Parallele Entwicklung neuer Funktionsmodule
Erstelle ein Team, um ein Benachrichtigungssystem für Benutzer zu bauen:
- Mitglied 1: Entwickelt die Backend-API (src/api/notifications/)
- Mitglied 2: Erstellt die Frontend-Komponenten (src/components/notifications/)
- Mitglied 3: Schreibt Integrationstests (tests/notifications/)
Warum es geeignet ist: Jedes Teammitglied ist für ein anderes Verzeichnis zuständig. Die natürliche Isolierung ermöglicht es, die Arbeit am Ende einfach zusammenzuführen.
Szenario 3: Debugging konkurrierender Hypothesen
Es gibt einen sporadisch auftretenden Bug. Erstelle ein Team, um verschiedene Hypothesen zu untersuchen:
- Mitglied A: Untersucht, ob es eine Race Condition ist.
- Mitglied B: Untersucht, ob ein Speicherleck vorliegt.
- Mitglied C: Untersucht, ob es an Timeouts einer Drittanbieter-API liegt.
Jeder soll seine Hypothese unabhängig validieren und Bericht erstatten.
Warum es geeignet ist: Adversariales Debugging – mehrere Spuren werden parallel verfolgt. Wer die Ursache zuerst findet, gewinnt.
Szenario 4: Koordination schichtübergreifender Änderungen
Wenn eine Änderung Frontend, Backend und Datenbank gleichzeitig betrifft, ermöglicht Agent Teams den Experten jeder Schicht, ihre Aufgaben wahrzunehmen und die Schnittstellendefinitionen über das Nachrichtensystem zu koordinieren.
Szenario 5: Explorative Forschung
Ich entwerfe ein CLI-Tool, um TODO-Kommentare im Code zu verfolgen.
Erstelle ein Team, um dies aus verschiedenen Blickwinkeln zu untersuchen:
- Ein Mitglied ist für das UX-Design zuständig.
- Ein Mitglied ist für die technische Architektur zuständig.
- Ein Mitglied spielt den "Advocatus Diaboli" (Kritiker).
Warum es geeignet ist: Das Aufeinandertreffen verschiedener Perspektiven hilft dabei, die Annahmen und Schlussfolgerungen der anderen gegenseitig herauszufordern.
Claude Agent Teams vs. Subagent: Ein Leitfaden zur Auswahl
| Entscheidungskriterium | Subagent wählen | Agent Teams wählen |
|---|---|---|
| Müssen Teammitglieder untereinander kommunizieren? | ❌ Nein | ✅ Ja |
| Sind Aufgaben parallelisierbar? | Teilweise | ✅ Hochgradig parallel |
| Geht es um die Bearbeitung mehrerer Dateien? | ✅ Sicher bei derselben Datei | ⚠️ Arbeitsteilung nötig, um Konflikte zu vermeiden |
| Komplexität der Aufgabe? | Fokus auf ein einzelnes Ziel | Mehrere Perspektiven, mehrere Module |
| Token-Budget? | 💰 Sparsamer | 💸 Ca. 3- bis 7-facher Verbrauch |
| Sind Diskussionen/Rückfragen erforderlich? | ❌ | ✅ |
Kostenreferenz: Ein Team aus 3 Agenten, das 30 Minuten lang läuft, verbraucht etwa das 3- bis 4-fache an Tokens im Vergleich zu einem einzelnen Chat-Verlauf. Im Plan-Modus liegt der Verbrauch etwa beim 7-fachen. Wir empfehlen die flexible Verwaltung Ihres Token-Budgets über APIYI (apiyi.com).
Fortgeschrittene Techniken für Claude Agent Teams
Tipp 1: Mischmodelle zur Kostensenkung
Erstelle ein Team, bei dem der Lead Opus verwendet und 4 Teammitglieder Sonnet nutzen.
Der Lead übernimmt mit Opus 4.6 die strategischen Entscheidungen, um die Qualität zu sichern, während die Teammitglieder die spezifischen Aufgaben mit Sonnet ausführen, um die Kosten zu kontrollieren.
Tipp 2: Plan-Genehmigungs-Workflow
Erstelle ein Architekten-Teammitglied, um das Authentifizierungsmodul umzustrukturieren.
Verlange, dass vor den Änderungen ein Entwurf zur Genehmigung vorgelegt wird.
Das Teammitglied wechselt zunächst in den schreibgeschützten Plan-Modus. Nach Fertigstellung des Entwurfs wird eine Genehmigungsanfrage an den Lead gesendet. Erst wenn der Lead zustimmt, beginnt das Teammitglied mit der Umsetzung.
Tipp 3: Delegationsmodus, um den Lead aus der Umsetzung herauszuhalten
Drücken Sie Shift+Tab, um den Delegationsmodus zu aktivieren. In diesem Modus ist der Lead ausschließlich für die Koordination und Aufgabenverteilung zuständig und schreibt selbst keinen Code. Dies verhindert, dass der Lead „die Arbeit an sich reißt“.
Tipp 4: Quality Gate Hooks
Nutzen Sie Hook-Mechanismen zur automatischen Qualitätskontrolle:
TeammateIdle: Wird ausgelöst, wenn ein Teammitglied kurz davor ist, in den Leerlauf zu gehen. Mit dem Exit-Code 2 kann Feedback gesendet werden, damit das Teammitglied die Arbeit fortsetzt.TaskCompleted: Wird ausgelöst, wenn eine Aufgabe als abgeschlossen markiert wird. Der Exit-Code 2 kann den Abschluss verhindern und Nachbesserungen fordern.
Claude Agent Teams: Wichtige Hinweise
Bekannte Einschränkungen
- Keine Sitzungswiederherstellung:
/resumeund/rewindstellen bereits geschlossene Teammitglieder nicht wieder her. - Ein Team pro Sitzung: Ein Lead kann zur gleichen Zeit nur ein einziges Team verwalten.
- Keine verschachtelten Teams: Teammitglieder können keine eigenen Unter-Teams erstellen.
- Vererbung von Berechtigungen: Teammitglieder erben den Berechtigungsmodus des Leads. Nach der Erstellung können die Berechtigungen jedoch individuell angepasst werden.
- Einschränkungen im Split-Screen-Modus: Der tmux Split-Screen-Modus wird vom integrierten VS Code Terminal, Windows Terminal und Ghostty nicht unterstützt.
- Absturz von Teammitgliedern: Wenn ein Teammitglied abstürzt, wird ein 5-minütiger Heartbeat-Timeout ausgelöst. Danach können dessen Aufgaben von anderen Teammitgliedern übernommen werden.
Best Practices
- Teamgröße: Empfohlen werden 2–5 Teammitglieder. Ein Team aus 3 Mitgliedern liefert oft bessere Ergebnisse als eines mit 6.
- Aufgabenverteilung ist wichtiger als die Anzahl: Ein schlecht strukturiertes 6-Personen-Team ist weniger effizient als ein gut aufgeteiltes 3-Personen-Team.
- Leseintensive Aufgaben (wie Code-Reviews oder Recherchen) sind das ideale Einsatzgebiet für Agent Teams.
- Schreibintensive, gleichzeitige Bearbeitung bleibt eine Herausforderung und erfordert eine strikte Aufteilung der Zuständigkeiten für einzelne Dateien.
Häufig gestellte Fragen (FAQ)
F1: Welches Abonnement ist für die Nutzung von Agent Teams erforderlich?
Agent Teams ist eine experimentelle Funktion von Claude Code. Sie erfordert ein Claude Max-Abonnement (100–200 $/Monat), um über ausreichend Kontingent für Opus 4.6 zu verfügen. API-Nutzer werden nach den Standardtarifen für Opus 4.6 abgerechnet (5 $/25 $ pro Million Token). Alternativ können über die Plattform APIYI (apiyi.com) flexiblere Abrechnungsmodelle bezogen werden.
F2: Können Agent Teams nur mit Opus 4.6 genutzt werden?
Nein. Obwohl Agent Teams zusammen mit Opus 4.6 veröffentlicht wurde, können Sie verschiedene Modelle mischen. Ein empfohlenes Szenario ist, Opus 4.6 als Lead für strategische Entscheidungen einzusetzen und Sonnet für die Teammitglieder zur Ausführung spezifischer Aufgaben zu nutzen. So lässt sich die Qualität der Koordination sicherstellen und gleichzeitig die Kosten kontrollieren.
F3: Können Agent Teams in VS Code verwendet werden?
Ja, aber mit Einschränkungen. Das integrierte Terminal von VS Code unterstützt den In-Process-Modus (alle Teammitglieder laufen im selben Terminal). Der tmux Split-Screen-Modus ist in VS Code jedoch nicht verfügbar; hierfür müssen Sie ein externes Terminal verwenden.
Zusammenfassung
Die Kernpunkte von Claude 4.6 Agent Teams:
- Aktivierung: Die Umgebungsvariable
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1setzen und das Team anschließend in natürlicher Sprache beschreiben. - Architekturmuster: Ein Lead Agent koordiniert, während Teammate Agents parallel arbeiten. Die Zusammenarbeit erfolgt über eine gemeinsame Aufgabenliste und ein Nachrichtensystem.
- Beste Einsatzszenarien: Code-Reviews, parallele Entwicklung neuer Module, Debugging konkurrierender Hypothesen, schichtübergreifende Koordination und explorative Forschung.
- Kernprinzip: Die Aufteilung der Aufgaben ist wichtiger als die Anzahl der Personen; 3 Teammitglieder sind oft effektiver als 6.
- Kostenkontrolle: Ein Hybrid-Modell (Opus für den Lead + Sonnet für die Teammitglieder) bietet das beste Preis-Leistungs-Verhältnis.
Agent Teams führen die KI-Programmierung vom „Einzelkampf“ in die Ära der „Teamarbeit“. Obwohl sie sich noch in der Research-Preview-Phase befinden, zeigen sie bereits beeindruckende Fähigkeiten bei der parallelen Entwicklung.
Wir empfehlen, Claude-API-Guthaben über APIYI (apiyi.com) zu beziehen. Die Plattform bietet eine flexible Abrechnung und Unterstützung für mehrere Modelle, was ideal ist, um verschiedene Konfigurationen von Agent Teams zu testen.
📚 Referenzen
⚠️ Hinweis zum Linkformat: Alle externen Links verwenden das Format
Name der Quelle: domain.com. Dies erleichtert das Kopieren, verhindert jedoch die direkte Weiterleitung, um den SEO-Wert zu erhalten.
-
Offizielle Dokumentation zu Claude Code Agent Teams: Vollständiger Leitfaden zur Nutzung von Agent Teams
- Link:
code.claude.com/docs/en/agent-teams - Beschreibung: Offizielle Dokumentation mit Aktivierungsmethoden, Architekturdetails und Best Practices.
- Link:
-
Anthropic Engineering Blog — C-Compiler-Fallstudie: 16 Claude-Instanzen bauen parallel einen C-Compiler
- Link:
anthropic.com/engineering/building-c-compiler - Beschreibung: Ein Praxisbeispiel für Agent Teams im großen Maßstab; über 2000 Sitzungen erzeugten 100.000 Zeilen Code.
- Link:
-
Addy Osmani — Claude Code Swarms: Tiefgehende Analyse von Agent Teams durch den Google Engineering Lead
- Link:
addyosmani.com/blog/claude-code-agent-teams - Beschreibung: Architekturanalyse und Empfehlungen für Best Practices.
- Link:
-
Claude Opus 4.6 Release-Ankündigung: Offizielle Veröffentlichungshinweise
- Link:
anthropic.com/news/claude-opus-4-6 - Beschreibung: Offizielle Vorstellung der Agent-Teams-Funktion.
- Link:
Autor: APIYI Team
Technischer Austausch: Diskutieren Sie gerne in den Kommentaren über Ihre Erfahrungen mit Claude Agent Teams. Weitere Materialien finden Sie in der APIYI (apiyi.com) Tech-Community.
