Claude Code Subagents und Agent Teams: Ein praktischer Leitfaden

Sie haben die Worte "Subagents", "Agent Teams", "Oorchestration" gesehen, und Sie fragen sich, ob Sie etwas vermissen. Kurze Antwort: für die meisten Ihrer Aufgaben, nein. Aber auf große Arbeit, ja, und es lohnt sich zu verstehen.

Lassen Sie uns es ohne das Jargon entwirren.

Was ein Subagent eigentlich ist

Ein Subagent ist ein spezialisierter Assistent mit seinem eigenen Kontext, seiner eigenen Aufforderung und seinen eigenen Werkzeugberechtigungen.

Wenn der Hauptagent einen gut definierten Subtask trifft, delegiert es an einen Subagent. Dieser Subagent funktioniert in seinem eigenen Kontextfenster, macht seinen Job und gibt nur das Ergebnis zurück. Der Hauptagent erhält nicht seine vollständige Geschichte, die seinen Kontext verschmutzt, es wird das Ergebnis.

Das ist der Punkt: Halten Sie den Kontext des Agenten sauber. Anstelle eines Agenten, der in 50.000 Token der Dateisuche ertrinkt, haben Sie einen Subagent, der die Suche macht und drei nützliche Zeilen zurückmeldet.

Sie erklären Ihre Subagents im .claude/agents/-Ordner Ihres Projekts. Jeder hat einen Namen, eine Beschreibung, die sagt, wann er verwendet werden soll, und eine Systemanforderung.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams, der nächste Schritt

Agent Teams ist der in Claude Code eingebaute multiagente Orchestermeister. Noch experimentell, standardmäßig deaktiviert, aber ein fester Eingabepunkt.

Die Idee: ein Lead-Agent teilt eine große Aufgabe, delegiert jedes Stück zu einem Spezialisten-Agent (mit seinem eigenen Modell, Aufforderungen, Tools), die Spezialisten arbeiten parallel auf einem gemeinsamen Dateisystem, und die Ergebnisse fließen zurück zur Führung.

Wenn "zu einem Spezialisten gehen" wie Subagents klingt, ist das normal. Agent Teams ist, dass Idee den ganzen Weg geschoben, um mehrere Agenten wirklich parallel, nicht nur einen nach dem anderen.

Über die eingebaute hinaus gibt es Drittorchester wie Multiclaude und Gas Town. Sie sind Meinungen, was macht sie gute Ausgangspunkte, wenn Sie beginnen: Sie entscheiden für Sie, bis Sie Ihre eigenen Gewohnheiten gebaut haben.

Wenn Sie es brauchen (und wenn Sie nicht)

Lassen Sie uns klar sein: Die multiagente Orchestrierung ist für 95 % der mit Agenten unterstützten Aufgaben sinnlos. Für die meisten Ihrer täglichen Arbeit ist ein einzelner Agent schneller und einfacher.

Derzeit ist Multiagent noch eine teure und experimentelle Möglichkeit, große Projekte anzugreifen.

Sie brauchen es, wenn:

• Das Projekt spaltet sich in wirklich unabhängige Stücke, die verschiedene Dateien berühren.
• Ein einziges Kontextfenster kann das Ganze nicht halten.
• Sie möchten einen breiten Refactor oder eine repoweite Migration parallelisieren.

Sie brauchen es nicht für eine Bugfixierung, eine fokussierte Funktion oder alles, was in einem Kopf passt.

Die Falle dreht sich um ein zehnfaches "Team" für etwas, das ein Agent in fünf Minuten tun würde. Sie zahlen in Token und Komplexität für einen Parallelismus die Aufgabe nie gefragt.

Das eigentliche Problem: Sichtbarkeit

Das wird nicht genug geredet. Wenn Sie mehrere Subagents oder ein Agent Team ausführen, verlieren Sie den Faden.

Eine führende Delegierte an fünf Spezialisten. Welcher arbeitet? Welcher ist fertig? Was wartet auf eine Entscheidung? In einem Terminal sehen Sie eine Wand des Scrolling Text, und Sie können nicht sagen, wer tut was.

Hier verändert ein visuelles Dashboard alles. AgentsRoom zeigt jeden Agenten und jeden Subagent als eigene Kachel, mit seinem Status ausgeschrieben. Sie sehen, wie die Delegation passiert, Sie sehen, wer auf Ihre Antwort wartet, Sie sehen, wer abgestürzt ist. Die Textwand wird zu einer lesbaren Karte.

Ohne diesen Blick bleibt die mehrstimmige Orchestrierung ein beeindruckendes Demo, das Tag für Tag unbeherrschbar ist. Damit wird es ein Werkzeug, das Sie tatsächlich verwenden.

Wo zu starten

Springen Sie nicht direkt zu einem Acht-Agenten-Team.

Beginnen Sie mit einem oder zwei Subagentien für präzise, repetitive Aufgaben: eine, die Tests schreibt, eine, die die Codebasis sucht. Sie werden schnell den Gewinn auf den Kontext Ihres Hauptagents spüren.

Sobald dieser Mechaniker sich natürlich fühlt, schalten Sie Agent Teams für die Arbeit ein, die sauber spaltet. Halten Sie ein Auge auf, wer tut was, billigen Sie Pläne vor der Ausführung, und stoppen Sie den Moment der Überprüfung wird Ihr Engpass.

Multiagent belohnt die Menschen, die Struktur, bevor sie starten. Nicht die, die die meisten Agenten starten.