Claude Code Agent Teams vs. Subagents: wann du was nutzt und wie du ein Team aufsetzt

Agent Teams vs. Subagents

Beide erledigen Arbeit parallel in getrennten Kontextfenstern. Der Unterschied liegt darin, wer koordiniert: Bei Subagents steuert der Hauptagent alles; in einem Team übernehmen Teammates Aufgaben aus einer gemeinsamen Liste und sprechen miteinander.

Wann sich Agent Teams lohnen (und wann nicht)

• Recherche und Review: Teammates betrachten ein Problem aus verschiedenen Blickwinkeln und hinterfragen dann gegenseitig ihre Ergebnisse.
• Neue Module oder Features: Jeder Teammate verantwortet ein eigenes Stück, etwa Frontend, Backend und Tests.
• Debugging mit konkurrierenden Hypothesen: Mehrere Teammates versuchen jeweils, ihre Theorie zu beweisen und die der anderen zu widerlegen.
• Nicht für sequenzielle Arbeit, Änderungen an denselben Dateien oder Aufgaben mit vielen Abhängigkeiten: Nimm dafür eine einzelne Session oder Subagents.
• Nicht für Routinearbeit: Der Token-Verbrauch wächst mit jedem aktiven Teammate.

So setzt du ein Claude Code Agent Team auf

1. Schalte Agent Teams ein

   Setz CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS in deiner Umgebung oder im env-Block der settings.json auf 1. Teams brauchen eine interaktive Session; mit -p (und im Agent SDK) startet Claude keine Teammates.

   // settings.json: agent teams are experimental and off by default
   {
     "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }
   }
   
   // Optional: give each teammate its own split pane (tmux or iTerm2)
   {
     "teammateMode": "auto"
   }

2. Beschreib das Team in normaler Sprache

   Sag, wie viele Teammates du willst und was jeder tun soll. Claude legt die gemeinsame Aufgabenliste an, startet sie und fasst ihre Ergebnisse zusammen, wenn sie fertig sind.

   Spawn three teammates to review PR #142:
   - One focused on security implications
   - One checking performance impact
   - One validating test coverage
   Have them each review and report findings.

3. Wähl einen Anzeigemodus

   In-Process ist der Standard und läuft in jedem Terminal: Teammates erscheinen in einem Bereich unter dem Prompt; mit den Pfeiltasten und Enter öffnest du einen und schreibst ihm, mit Ctrl+T die Aufgabenliste. Split-Panes geben jedem Teammate einen eigenen Bereich und brauchen tmux oder iTerm2 mit der it2-CLI; setz teammateMode auf auto oder tmux, oder starte mit claude --teammate-mode auto.

4. Nutz Rollen, die du schon definiert hast

   Bitte um einen Teammate „mit dem Agententyp security-reviewer“, um eine Subagent-Definition aus .claude/agents/ samt Tools, Modell und Anweisungen wiederzuverwenden.

5. Steuern, dann beenden

   Schau bei den Teammates vorbei, lenk sie um und sag „warte auf deine Teammates“, wenn der Lead anfängt, ihre Arbeit selbst zu machen. Zum Abschluss bittest du den Lead, einen Teammate namentlich zu beenden; die Verzeichnisse des Teams werden aufgeräumt, wenn die Session endet.

Quelle: Claude-Code-Doku, Agent teams

Best Practices und Grenzen

• Starte mit 3–5 Teammates und etwa 5–6 Aufgaben pro Teammate; drei fokussierte Teammates schlagen oft fünf verstreute.
• Gib jedem Teammate andere Dateien: Zwei Teammates, die dieselbe Datei bearbeiten, überschreiben sich gegenseitig.
• Pack die Aufgabendetails in den Spawn-Prompt: Teammates laden CLAUDE.md, MCP-Server und Skills, aber nicht die Unterhaltung des Leads.
• Nutz Hooks als Qualitätsschranken: TeammateIdle, TaskCreated und TaskCompleted können Arbeit mit Exit-Code 2 zurückschicken.
• Grenzen: ein Team pro Session, keine verschachtelten Teams, der Lead lässt sich nicht wechseln, /resume holt In-Process-Teammates nicht zurück, und der Aufgabenstatus kann hinterherhinken.
• Split-Panes funktionieren nicht im integrierten Terminal von VS Code, in Windows Terminal oder Ghostty; der In-Process-Modus funktioniert überall.
• Mit aktivierten Agent Teams kann ein Subagent, den Claude benennt, als Teammate starten; setz die Variable auf 0, wenn du normale Subagents zurückwillst.

Agent Teams vs. andere Wege, Claude Code parallel laufen zu lassen

Agent Teams teilen eine Aufgabe auf, die du beobachtest, innerhalb einer Session. Für unabhängige Aufgaben startest du getrennte Sessions in Git-Worktrees oder als Hintergrund-Agenten; einen vollständigen Vergleich findest du unter mehrere Claude-Code-Agenten. Um die Kosten zu senken, lies, wie du den Token-Verbrauch von Claude Code reduzierst.

Ein Team, das nach dem Ende der Session weiterarbeitet

Ein Agent Team lebt in einer Session und stoppt, wenn du sie schließt. Crewmark macht aus Sessions in Claude Code, Codex, DeepSeek Harness oder OpenCode KI-Mitarbeiter mit dauerhaften Rollen, Zielen und Arbeitszeiten: Jeder wacht per Heartbeat auf, übernimmt das nächste Issue von einem gemeinsamen Board und schreibt dir, wenn er eine Entscheidung braucht.

1. Gib jedem Mitarbeiter eine Rolle

   Ein Softwareentwickler, ein Reviewer, ein SEO-Spezialist: die Rollen, die du als Teammates starten würdest, nur dauerhaft.

2. Arbeite von einem Board aus

   Issues ersetzen die Aufgabenliste der Session und überstehen Neustarts, Tage und Wochen.

3. Lass den Heartbeat die Arbeit starten

   Alle 15, 30 oder 60 Minuten während der Arbeitszeiten; lies, was ein KI-Mitarbeiter ist.

FAQ zu Claude Code Agent Teams