Claude Code Subagenten und Agententeams: Ein praktischer Leitfaden

Du hast die Begriffe "Subagenten", "Agententeams", "Orchestrierung" gesehen und fragst dich, ob du etwas verpasst. Kurze Antwort: Für die meisten deiner Aufgaben, nein. Aber bei großen Arbeiten, ja, und es lohnt sich, es zu verstehen.

Lass uns das ohne Fachjargon entwirren.

Was ein Subagent tatsächlich ist

Ein Subagent ist ein spezialisierter Assistent mit eigenem Kontext, eigenem Prompt und eigenen Werkzeugberechtigungen.

Wenn der Hauptagent auf eine klar definierte Teilaufgabe stößt, delegiert er diese an einen Subagenten. Dieser Subagent arbeitet in seinem eigenen Kontextfenster, erledigt seine Aufgabe und liefert nur das Ergebnis zurück. Der Hauptagent erhält nicht seine gesamte Historie, die seinen Kontext verschmutzt, sondern nur die Schlussfolgerung.

Das ist der Punkt: den Kontext des Hauptagenten sauber halten. Anstatt dass ein Agent in 50.000 Tokens einer Dateisuche ertrinkt, gibt es einen Subagenten, der die Suche durchführt und drei nützliche Zeilen zurückmeldet.

Du deklarierst deine Subagenten im .claude/agents/ Ordner deines Projekts. Jeder hat einen Namen, eine Beschreibung, wann er verwendet werden soll, und einen System-Prompt.

---
name: test-writer
description: Verwende, wenn Tests geschrieben oder repariert werden müssen
---
Du schreibst Tests. Du zielst auf Edge-Case-Abdeckung,
nicht auf den Happy Path. Du berührst niemals Produktionscode.

Agententeams, der nächste Schritt

Agententeams ist der Multi-Agent-Orchestrator, der in Claude Code integriert ist. Noch experimentell, standardmäßig deaktiviert, aber ein solider Einstiegspunkt.

Die Idee: Ein leitender Agent teilt eine große Aufgabe auf, delegiert jedes Stück an einen spezialisierten Agenten (mit eigenem Modell, Prompts, Werkzeugen), die Spezialisten arbeiten parallel in einem gemeinsamen Dateisystem, und die Ergebnisse fließen zurück zum leitenden Agenten.

Wenn "an einen Spezialisten delegieren" nach Subagenten klingt, ist das normal. Agententeams ist diese Idee, die bis zur Ausführung mehrerer Agenten wirklich parallel, nicht nur nacheinander, vorangetrieben wird.

Neben dem eingebauten gibt es Drittanbieter-Orchestratoren wie Multiclaude und Gas Town. Sie sind meinungsstark, was sie zu guten Ausgangspunkten macht, wenn du anfängst: Sie entscheiden für dich, bis du deine eigenen Gewohnheiten entwickelt hast.

Wann du es brauchst (und wann nicht)

Lass uns klar sein: Multi-Agent-Orchestrierung ist für 95% der agentengestützten Aufgaben sinnlos. Für die meisten deiner täglichen Arbeiten ist ein einzelner Agent schneller und einfacher.

Im Moment ist Multi-Agent immer noch eine teure und experimentelle Methode, um große Projekte anzugehen.

Du brauchst es, wenn:

• Das Projekt sich in wirklich unabhängige Teile aufteilt, die verschiedene Dateien berühren.
• Ein einzelnes Kontextfenster nicht alles fassen kann.
• Du eine umfassende Umstrukturierung oder eine repo-weite Migration parallelisieren möchtest.

Du brauchst es nicht für einen Bugfix, ein fokussiertes Feature oder irgendetwas, das in einen Kopf passt.

Die Falle ist, ein Zehn-Agenten-"Team" für etwas hochzufahren, das ein Agent in fünf Minuten erledigen würde. Du zahlst in Tokens und Komplexität für eine Parallelität, die die Aufgabe nie verlangt hat.

Das eigentliche Problem: Sichtbarkeit

Hier ist, was nicht genug besprochen wird. In dem Moment, in dem du mehrere Subagenten oder ein Agententeam ausführst, verlierst du den Überblick.

Ein leitender Agent delegiert an fünf Spezialisten. Welcher arbeitet? Welcher ist fertig? Welcher wartet auf eine Entscheidung? In einem Terminal siehst du eine Wand aus scrollendem Text und kannst nicht erkennen, wer was tut.

Hier verändert ein visuelles Dashboard alles. AgentsRoom zeigt jeden Agenten und jeden Subagenten als eigenes Kachel, mit seinem Status ausgeschrieben. Du siehst die Delegation geschehen, siehst, wer auf deine Antwort wartet, siehst, wer abgestürzt ist. Die Textwand wird zu einer lesbaren Karte.

Ohne diese Ansicht bleibt die Multi-Agent-Orchestrierung eine beeindruckende Demo, die im Alltag unhandlich ist. Mit ihr wird sie zu einem Werkzeug, das du tatsächlich nutzt.

Wo du anfangen solltest

Springe nicht direkt zu einem Acht-Agenten-Team.

Beginne mit ein oder zwei Subagenten für präzise, sich wiederholende Aufgaben: einer, der Tests schreibt, einer, der den Code durchsucht. Du wirst schnell den Gewinn im Kontext deines Hauptagenten spüren.

Sobald sich dieser Mechanismus natürlich anfühlt, aktiviere Agententeams für Arbeiten, die sich klar aufteilen. Behalte im Auge, wer was tut, genehmige Pläne vor der Ausführung und stoppe, sobald die Überprüfung zu deinem Engpass wird.

Multi-Agent belohnt die Menschen, die strukturieren, bevor sie starten. Nicht diejenigen, die die meisten Agenten starten.