Agent Teams Steuerung

Problem: Du hast Claude Code Agent Teams aktiviert und dein erstes Team läuft. Aber der Lead erledigt die Arbeit selbst statt zu delegieren. Teammitglieder bearbeiten dieselben Dateien. Du siehst nicht, woran jemand tatsächlich arbeitet. Die Steuerungsmöglichkeiten, um all das zu lösen, gibt es. Sie sind nur nicht von Anfang an offensichtlich.

Quick Win: Drücke Shift+Tab direkt nach dem Start eines Teams, um in den Delegate-Modus zu wechseln. Der Lead hört auf, Code anzufassen und konzentriert sich auf Koordination.

Hinweis: Das ist ein Schwester-Guide zum Agent Teams-Überblick. Fang dort an, wenn du noch kein Team eingerichtet hast.

Anzeigemodi

Agent Teams bietet dir zwei Anzeigemodi, die verändern, wie du Teammitglieder beobachtest und mit ihnen interagierst.

In-Process-Modus (Standard)

Alle Teammitglieder laufen in deinem Haupt-Terminal. Du wechselst zwischen ihnen mit Tastaturkürzeln:

Das funktioniert in jedem Terminal. Kein Extra-Setup, keine Abhängigkeiten. Du siehst die Ausgabe eines Teammitglieds nach dem anderen und wechselst bei Bedarf. Für die meisten Workflows reicht der In-Process-Modus völlig aus.

Split-Pane-Modus

Jedes Teammitglied bekommt sein eigenes Terminal-Pane. Du siehst alle Ausgaben nebeneinander und kannst in jedes Pane direkt klicken. Nützlich, wenn du mehrere Teammitglieder gleichzeitig bei einem schwierigen Problem beobachten willst.

Split-Pane-Modus braucht tmux oder iTerm2. Auf macOS ist tmux -CC in iTerm2 der empfohlene Einstieg. Wichtig: Split-Pane-Modus wird NICHT im integrierten Terminal von VS Code, Windows Terminal oder Ghostty unterstützt. tmux hat bekannte Kompatibilitätslücken auf manchen Betriebssystemen und läuft am besten auf macOS.

Konfiguriere deinen bevorzugten Modus über settings.json:

Drei Optionen:

• "auto" (Standard) nutzt Split-Panes, wenn du bereits in tmux läufst, und fällt sonst auf In-Process zurück
• "tmux" aktiviert Split-Panes und erkennt automatisch, ob du in tmux oder iTerm2 bist
• "in-process" zwingt alles in dein Haupt-Terminal

Überschreibe pro Session mit dem CLI-Flag:

Delegate-Modus

Ohne Delegate-Modus fängt der Lead manchmal an, Aufgaben selbst zu implementieren, statt auf Teammitglieder zu warten. Das verfehlt den Sinn. Du hast gesagt, er soll koordinieren. Er hat einen Schraubenschlüssel gegriffen und angefangen zu bauen.

Drücke Shift+Tab, um nach dem Starten eines Teams in den Delegate-Modus zu wechseln. Das beschränkt den Lead auf Koordinations-Tools: Teammitglieder spawnen, Nachrichten schicken, sie herunterfahren und Aufgaben verwalten. Der Lead darf keinen Code direkt anfassen. Er bleibt vollständig auf Orchestrierung.

Nutze den Delegate-Modus, wenn du den Lead als Projektmanager und nicht als einzelnen Ausführenden haben willst. Das ist besonders wichtig bei größeren Teams, wo die gesamte Aufgabe des Leads die Koordination ist. In der Praxis reduziert das Aktivieren des Delegate-Modus für Sessions mit 4+ Teammitgliedern spürbar verschwendeten Lead-Kontext und verhindert, dass der Lead mit seinen eigenen Teammitgliedern um Arbeit konkurriert.

Wenn der Lead vorauseilt, während Teammitglieder noch arbeiten, kannst du ihm direkt sagen: "Warte, bis deine Teammitglieder ihre Aufgaben abgeschlossen haben, bevor du weitermachst." Manchmal reicht ein natürlichsprachlicher Schubs. Aber für konsistentes Verhalten über Sessions hinweg setzt der Delegate-Modus die Einschränkung automatisch durch.

Plan-Genehmigungsworkflow

Bei komplexen oder riskanten Aufgaben verlange, dass Teammitglieder planen, bevor sie irgendetwas implementieren. Das Teammitglied arbeitet im read-only Planungsmodus, bis der Lead den Ansatz überprüft und genehmigt hat.

Der Workflow:

1. Teammitglied empfängt die Aufgabe und tritt in den read-only Modus ein
2. Teammitglied erstellt einen Plan und sendet eine Plan-Genehmigungsanfrage an den Lead
3. Lead überprüft den Plan und genehmigt ihn oder lehnt ihn mit Feedback ab
4. Bei Ablehnung bleibt das Teammitglied im Planungsmodus, überarbeitet und reicht erneut ein
5. Nach Genehmigung verlässt das Teammitglied den Planungsmodus und beginnt mit der Implementierung

Der Lead trifft Genehmigungsentscheidungen autonom. Du formst sein Urteil durch den ersten Prompt. Sag ihm "genehmige nur Pläne, die Testabdeckung enthalten" oder "lehne Pläne ab, die das Datenbankschema ohne Migration ändern." Der Lead wendet diese Regeln als Filter auf jeden erhaltenen Plan an.

Der Planungsmodus ist besonders wertvoll, wenn Teammitglieder an gemeinsamer Infrastruktur arbeiten, Datenbankschemas anfassen oder Änderungen machen, die teuer rückgängig zu machen sind. Die Kosten der Planung sind ein Bruchteil der Kosten, eine schlechte Implementierung über mehrere Dateien zurückzurollen. Für einen tieferen Einblick, wie die Plan-Genehmigung in eine strukturierte Planungsphase passt, sieh dir den End-to-End-Workflow an.

Hooks für Quality Gates

Agent Teams bindet sich in Claude Codes Hook-System für automatisierte Qualitätsprüfungen ein. Zwei Hooks sind speziell für Team-Workflows gebaut:

TeammateIdle: Läuft, wenn ein Teammitglied kurz vor dem Idle-Zustand ist. Mit Exit-Code 2 beenden, um Feedback zu senden und das Teammitglied weiterarbeiten zu lassen. Nutze das, um Follow-up-Aufgaben automatisch zuzuweisen oder ein Teammitglied umzuleiten, das früh fertig geworden ist. Wenn ein Teammitglied seine primäre Aufgabe abschließt, während andere noch arbeiten, kann ein TeammateIdle-Hook Review-Arbeit oder Aufräumaufgaben ohne manuellen Schritt weiterleiten.

TaskCompleted: Läuft, wenn eine Aufgabe als abgeschlossen markiert wird. Mit Exit-Code 2 beenden, um den Abschluss zu blockieren und Feedback zu senden. Nutze das, um Quality Gates durchzusetzen: verlange, dass Tests bestehen, Lint-Prüfungen erfolgreich sind oder spezifische Akzeptanzkriterien erfüllt sind, bevor eine Aufgabe geschlossen werden kann.

Diese Hooks ermöglichen strukturierte Quality Gates, ohne jeden Teammitglied manuell zu überwachen. Ein TaskCompleted-Hook, der deine Test-Suite ausführt, bedeutet, dass keine Aufgabe mit kaputten Tests schließt, egal welches Teammitglied den Code geschrieben hat. Für eine vollständige Erklärung des Hook-Systems und der Konfiguration, sieh dir den Hooks-Guide an.

Direkte Nachrichten an Teammitglieder

Jedes Teammitglied ist eine vollständige, unabhängige Claude Code-Session. Du kannst jedem Teammitglied direkt schreiben, ohne über den Lead zu gehen.

Im In-Process-Modus: Nutze Shift+Up/Down, um ein Teammitglied auszuwählen, dann tippe, um eine Nachricht zu senden. Drücke Enter, um die vollständige Session eines Teammitglieds zu sehen und alles zu sehen, was es getan hat. Drücke Escape, um den aktuellen Turn zu unterbrechen, wenn es in die falsche Richtung geht.

Im Split-Pane-Modus: Klicke in das Pane eines Teammitglieds, um direkt mit seiner Session zu interagieren. Jedes Pane verhält sich genau wie eine eigenständige Claude Code-Session.

Das ist nützlich, wenn du ein bestimmtes Teammitglied umleiten willst, zusätzlichen Kontext geben möchtest, den der Lead nicht hat, oder eine gezielte Nachfrage stellst. Manchmal ist der schnellste Weg, direkt mit dem Ausführenden zu sprechen, statt über einen Koordinator zu gehen.

Aufgabenverwaltung

Die gemeinsame Aufgabenliste koordiniert jede Arbeit im Team. Der Lead erstellt Aufgaben und Teammitglieder arbeiten sie ab. Aufgaben haben drei Zustände: ausstehend, in Bearbeitung und abgeschlossen. Aufgaben können von anderen Aufgaben abhängen. Eine ausstehende Aufgabe mit ungelösten Abhängigkeiten kann nicht beansprucht werden, bis diese Abhängigkeiten abgeschlossen sind. Das spiegelt die Abhängigkeitskettenmuster aus der Team-Orchestrierung wider.

Der Lead kann Aufgaben explizit bestimmten Teammitgliedern zuweisen, oder Teammitglieder können sich selbst beanspruchen, was verfügbar ist. Nach dem Beenden einer Aufgabe nimmt sich ein Teammitglied selbst die nächste unzugewiesene, unblockierte Aufgabe. Dieses Selbstbeanspruchen-Verhalten hält das Team ohne ständige Lead-Eingriffe am Laufen.

Das Beanspruchen von Aufgaben verwendet File-Locking, um Race Conditions zu verhindern, bei denen zwei Teammitglieder gleichzeitig dieselbe Aufgabe greifen. Das System verwaltet Aufgabenabhängigkeiten automatisch: wenn ein Teammitglied eine Aufgabe abschließt, von der andere abhängen, werden blockierte Aufgaben ohne manuellen Eingriff entsperrt. Ein Teammitglied, das auf eine Abhängigkeit wartet, beginnt zu arbeiten, sobald diese Abhängigkeit aufgelöst ist.

Für mehr zu Aufgabenkoordinationsmustern, sieh dir task distribution und todo workflows an.

Teamgröße und Modellauswahl

Claude wählt die Anzahl der Teammitglieder basierend auf deiner Aufgabenkomplexität, oder du kannst genau angeben, was du willst:

Du kannst auch Modelle innerhalb eines Teams mischen. Führe den Lead auf Opus für strategische Koordination und Teammitglieder auf Sonnet für fokussierte Implementierung. Das balanciert Kosten mit Fähigkeiten. Der Lead braucht starkes Reasoning für Aufgabenzerlegung und Plan-Genehmigung. Teammitglieder, die fokussierte Implementierungsarbeit machen, landen oft gut auf Sonnet zu einem Bruchteil der Kosten.

Für noch schnellere Lead-Antworten bei koordinationsintensiven Phasen kombiniere Agent Teams mit Fast Mode.

Token-Kostenmanagement

Agent Teams verbrennt deutlich mehr Tokens als eine einzelne Session. Jedes Teammitglied führt sein eigenes Kontextfenster aus, und die Token-Nutzung skaliert mit aktiven Teammitgliedern. Wenn Teammitglieder im Planungsmodus vor der Implementierung laufen, rechne mit etwa 7x den Tokens einer Standard-Session für diese Phase.

Wo die Tokens hingehen:

• Jedes Teammitglied lädt Projektkontext unabhängig (CLAUDE.md, Skills, Projektdateien)
• Kommunikation kostet: jede Nachricht zwischen Agenten verbraucht Tokens in beiden Kontexten, Sender und Empfänger
• Broadcasting multipliziert die Kosten mit der Anzahl der Teammitglieder, die die Nachricht empfangen
• Der Lead verbraucht Tokens für Koordination, Aufgabenverwaltung und Ergebnissynthese

Wann die Kosten es wert sind:

• Recherche- und Review-Aufgaben, wo mehrere Perspektiven Probleme finden, die ein einziger Durchgang verpassen würde
• Debugging-Sessions, wo paralleles Hypothesentesten Probleme schneller löst als sequentielles Raten
• Große Feature-Implementierungen, wo Zeitersparnisse den Token-Aufwand rechtfertigen
• Architekturentscheidungen, wo gründliche Bewertung teure Fehler später verhindert

Wann du Kosten niedrig hältst:

• Nutze Sonnet für Teammitglieder, die fokussierte Implementierungsarbeit machen, und behalte Opus für den Lead
• Bevorzuge direkte Nachrichten gegenüber Broadcasts, wenn möglich
• Begrenze die Teamgröße auf das, was die Aufgabe wirklich braucht (3 Teammitglieder sind oft besser als 6)
• Nutze Subagents oder einzelne Sessions für Routineaufgaben, die keine Inter-Agenten-Kommunikation brauchen
• Setze klaren Umfang für jedes Teammitglied, um unnötige Erkundung zu verhindern

Grobe Richtlinie: Ein 3-Teammitglieder-Team, das 30 Minuten läuft, verbrennt etwa 3-4x die Tokens einer einzelnen Session, die dieselbe Arbeit sequentiell macht. Der Trade ist Geschwindigkeit und Abdeckung gegen Kosten.

CLAUDE.md-Optimierung für Teams

Jedes Teammitglied lädt dein CLAUDE.md beim Start mit einem frischen Kontextfenster. Das frühere Gespräch des Leads überträgt sich nicht, weshalb die CLAUDE.md-Qualität für Teams so wichtig ist. Wenn CLAUDE.md vage ist, verschwendet jedes Teammitglied Tokens damit, die Codebase selbst zu erkunden. Drei Teammitglieder, die gleichzeitig Kontext laden, bedeuten 3x die Token-Kosten, wenn dieser Kontext Erkundung statt eine schnelle Lektüre erfordert.

Drei Regeln machen Agent Teams spürbar effektiver:

Regel 1: Beschreibe deine Modulgrenzen

Je klarer deine Modulgrenzen in CLAUDE.md, desto smarter teilt Claude Arbeit auf Teammitglieder auf. Nutze eine Tabelle:

Wenn du Claude sagst "erstelle ein Team und teile nach Datei-Eigentümerschaft auf", liest es die Struktur und weist jedem Teammitglied explizite Dateilisten zu. Null Konflikte.

Regel 2: Halte Projektkontext kurz und operational

Stack, Einstiegspunkt, Test-Befehl, Datenbank. Kurze Lektüre, keine Erkundung.

Kein Teammitglied sollte den Lead fragen müssen, worum es in dem Projekt geht oder wo Dateien liegen. Jede Runde "was ist das für ein Framework?" verbrennt Tokens im Kontext des Teammitglieds und im Kontext des Leads, wenn er antwortet.

Regel 3: Definiere, was "verifiziert" bedeutet

Wenn CLAUDE.md auflistet, wie man prüft, dass Dinge funktionieren, nutzen Teammitglieder diese Signale, um ihre eigene Arbeit selbst zu verifizieren, bevor sie berichten.

Claude passt die Verifikation per Aufgabe an. Bei einer Aufräum-Aufgabe könnten Teammitglieder grep nutzen, um Entfernungen zu verifizieren. Bei einem Feature führen sie die Test-Suite aus. Projektweite Gates zu haben gibt dem Lead ein Vokabular für "erledigt", das er automatisch anwenden kann.

Mit klaren Regeln in CLAUDE.md berichten Teammitglieder genau, was sie getan haben, ohne Lead-Eingriff. Klare Regeln rein, klare Berichte raus. Für mehr zum Gestalten deiner Projektdateien, sieh dir CLAUDE.md mastery an.

Zusammenfügen

Du hast jetzt die Steuerungsmöglichkeiten, um Agent Teams effektiv zu nutzen. Fang mit dem Delegate-Modus bei deiner nächsten Team-Session an und spür den Unterschied im Lead-Verhalten. Füge einen TaskCompleted-Hook hinzu, um deine Test-Suite durchzusetzen. Schreib Modulgrenzen in dein CLAUDE.md und lass Claude die Arbeit automatisch aufteilen.

Für reale Prompts, die du kopieren und anpassen kannst, sieh dir Agent Teams Use Cases and Prompt Templates an. Für die Behebung häufiger Probleme und aktueller Einschränkungen, sieh Agent Teams Best Practices. Für den vollständigen Planungs-bis-Produktion-Workflow, der diese Steuerungsmöglichkeiten zusammenbringt, sieh den End-to-End-Workflow-Guide.