Claude Code Subagents im Jahr 2026: Wie sie funktionieren, wann man sie einsetzt und wann nicht

Claude Code Subagents sind spezialisierte, isolierte Claude-Instanzen, an die deine Hauptsitzung eine abgegrenzte Aufgabe übergeben kann – eine Codebase-Suche, ein Review, einen Stapel an Datei-Reads –, sodass diese Arbeit in ihrem eigenen Context Window läuft und nur die Zusammenfassung zurückkommt. Sie existieren, um ein einziges Problem zu lösen: Eine lange Sitzung füllt sich nach und nach mit Logs und Datei-Dumps, die du nie wieder ansiehst, und die Antwortqualität driftet dabei ab. Ein Subagent erledigt die lärmende Arbeit anderswo und hält deine Hauptunterhaltung sauber. Dieser Leitfaden behandelt, was Claude Code Subagents sind, wie man einen baut, die drei eingebauten Typen, worin sie sich von Skills und Agent-Teams unterscheiden, und den Teil, den die meisten Tutorials auslassen: wann sie ihre Token-Kosten nicht wert sind.

Was ist ein Claude Code Subagent?

Ein Subagent ist eine benannte, isolierte Claude-Instanz mit eigenem System-Prompt, eigenem Context Window, eigenem Tool-Zugriff und eigenen Berechtigungen. Du definierst einen als Markdown-Datei mit YAML-Frontmatter, und Claude Code liest das Feld description, um zu entscheiden, wann daran delegiert wird. Passt eine Aufgabe, läuft der Subagent eigenständig und gibt dann ein kurzes Ergebnis an den Parent zurück – der Parent sieht die Zwischensuchen oder Logs nie. Genau diese Isolation ist der springende Punkt: Die offizielle Anthropic-Dokumentation beschreibt Subagents als Antwort auf eine Nebenaufgabe, die andernfalls „deine Hauptunterhaltung mit Suchergebnissen, Logs oder Dateiinhalten überschwemmen würde, auf die du nie wieder zurückgreifst." Jede delegierte Aufgabe bekommt ein frisches Context-Budget, weshalb Praktiker Subagents als Gegenmittel gegen den Context Rot beschreiben, der sich über lange Sitzungen aufsummiert.

Wie erstellt man einen Claude Code Subagent?

Ein Subagent ist einfach eine Markdown-Datei mit YAML-Frontmatter, gespeichert an einem von zwei Orten: .claude/agents/ (projektbezogen, checke ihn in Git ein, damit dein Team ihn teilt) oder ~/.claude/agents/ (nutzerbezogen, in jedem Projekt auf deinem Rechner verfügbar). Kommt es bei einem name zu einer Kollision, gewinnt die Definition, die deinem Arbeitsverzeichnis am nächsten liegt, und Projekt-Subagents haben Vorrang vor nutzerbezogenen. Nur name und description sind erforderlich; alles andere ist optional. Ein minimaler Reviewer sieht so aus:

---
name: code-reviewer
description: Expert code reviewer. Use proactively after code changes.
tools: Read, Grep, Glob
model: haiku
---
You are a senior code reviewer. Review the diff for bugs, security
issues, and unclear naming. Return a short, specific list of findings.

Die wichtigsten Frontmatter-Felder, laut offizieller Referenz:

Feld	Erforderlich	Was es tut
name	Ja	Bezeichner in Kleinbuchstaben mit Bindestrich zum Aufruf des Subagents
description	Ja	Sagt Claude, wann delegiert werden soll – schreibe sie wie eine Routing-Regel
tools	Nein	Whitelist von Tools; erbt bei Weglassen alle Tools
disallowedTools	Nein	Entfernt bestimmte Tools aus dem geerbten Satz
model	Nein	haiku, sonnet, opus, fable, eine vollständige Modell-ID oder inherit (der Standard)
permissionMode	Nein	default, acceptEdits, plan, dontAsk und weitere

Standardmäßig erbt ein Subagent jedes Tool, das deine Hauptsitzung hat, einschließlich aller MCP-Server-Tools, weshalb die Felder tools und disallowedTools dazu da sind, diesen Satz zu verengen – ein Read-only-Reviewer mit tools: Read, Grep, Glob kann Dateien physisch nicht bearbeiten. Beachte, dass /agents in aktuellen Versionen keinen interaktiven Assistenten mehr öffnet – du schreibst die Datei selbst oder bittest Claude, sie zu schreiben, und Claude Code lädt die Änderung innerhalb weniger Sekunden per Hot-Reload nach. Die description ist das eine Feld, über das es sich zu grübeln lohnt: Sie ist das, wogegen der Orchestrator abgleicht, sodass „Use proactively after code changes" weit zuverlässiger aufgerufen wird als ein vages „reviews code."

Was sind die drei eingebauten Subagents?

Du bekommst drei Subagents, bevor du auch nur einen eigenen schreibst, und Claude routet automatisch zu ihnen:

• Explore – Read-only-Dateiermittlung und Codebase-Suche. Er liest Auszüge, um Dinge zu lokalisieren, und gibt dann eine Zusammenfassung zurück. In neueren Versionen erbt er das Modell deiner Sitzung (auf der Claude API auf Opus gedeckelt), statt immer auf Haiku zu laufen, wobei du das überschreiben kannst, indem du deinen eigenen Explore mit model: haiku definierst.
• Plan – sammelt Kontext und entwirft eine Strategie, bevor du dich auf Änderungen festlegst; wird im Plan-Modus verwendet.
• general-purpose – übernimmt Aufgaben, die Exploration und Modifikation vermischen, wenn keiner der oben genannten passt.

Automatisches Routing ist praktisch, aber wie ein detaillierter Beitrag anmerkt, ist die Auswahl „in der Praxis unvollkommen" – willst du einen bestimmten Subagent, benenne ihn ausdrücklich („use the code-reviewer subagent"). Die eingebauten decken die meiste einmalige Delegation ab; eigene Subagents brauchst du erst, wenn du immer wieder denselben Arbeitertyp mit denselben Anweisungen startest.

Subagents vs. Skills, Slash-Befehle und Agent-Teams

Diese vier Features überschneiden sich genug, um Leute zu verwirren, und der Unterschied dreht sich eigentlich um Kontext. Ein Subagent führt Arbeit in einem separaten Fenster aus. Ein Skill schleust Anweisungen und Dateien in das aktuelle Fenster ein. Ein Slash-Befehl ist ein gespeicherter Prompt, den du von Hand auslöst. Agent-Teams sind mehrere vollständige Sitzungen, die parallel laufen.

Feature	Läuft in	Am besten für	Isoliert Kontext?
Subagent	Seinem eigenen Context Window	Abgegrenzte Recherche, Review, Delegation	Ja
Skill	Der Hauptunterhaltung	Wiederverwendbares Know-how und Referenzdateien	Nein
Slash-Befehl	Der Hauptunterhaltung	Ein vorgefertigter Prompt, den du manuell aufrufst	Nein
Agent-Team	Separaten parallelen Sitzungen	Lange unabhängige Arbeitsstränge	Ja (pro Sitzung)

Faustregel: Greif zu einem Subagent, wenn das Ergebnis zählt, der Prozess aber Lärm ist, den du nicht in deinem Hauptthread haben willst. Greif zu einem Skill, wenn das Modell das Know-how vor sich behalten soll – dieselbe Logik steckt hinter dem Schreiben einer guten AGENTS.md-Datei.

Wann zahlen sich Claude Code Subagents tatsächlich aus?

Hier werden die meisten Tutorials still. Subagents sind nicht kostenlos – Delegation kopiert Kontext, und Multi-Agent-Workflows verbrennen Berichten zufolge ungefähr das 4- bis 7-Fache an Tokens einer einzelnen Sitzung, bei vollständigen Agent-Teams eher das 15-Fache. Im Claude Code Max Plan ist vieles davon zwischengespeichertes Lesen zu einem niedrigeren Tarif, was die Rechnung abfedert, aber der Multiplikator ist real.

Sie zahlen sich aus bei leselastigen, abgegrenzten Aufgaben mit einem sauberen Output: „finde jede Aufrufstelle dieser Funktion", „fasse dieses Subsystem zusammen", „prüfe, dass diese Änderung das Schema nicht kaputt gemacht hat." Zwei oder drei fokussierte Recherche-Subagents parallel laufen zu lassen und die Hauptsitzung synthetisieren zu lassen, hält deinen Kontext sauber und verkürzt zugleich die tatsächliche Wartezeit. Sie zahlen sich nicht aus bei parallelen Coding-Aufgaben mit geteilten Abhängigkeiten oder wenn ein fähiges Modell aus Gewohnheit delegiert – eine direkte Bearbeitung ist oft schneller und günstiger, als einen Arbeiter hochzufahren, der sie erledigt. Passt eine Aufgabe in dein Hauptfenster und du wirst ihren Output unterwegs heranziehen, ist ein Subagent meist das falsche Werkzeug.

Was sind verschachtelte Subagents?

Seit Claude Code v2.1.172 (10. Juni 2026) können Subagents ihre eigenen Subagents starten, bis zu fünf Ebenen tief – ein Lead-Architect-Subagent kann an Worker auf Modulebene delegieren, die wiederum weiter delegieren. Das spiegelt wider, wie ein echtes Engineering-Team Arbeit zerlegt, aber die Token-Rechnung summiert sich hart: Jede Ebene bekommt ihr eigenes Context Window, sodass jeder verschachtelte Aufruf ungefähr 30–60 % mehr Tokens hinzufügt, und dieser Overhead stapelt sich schnell, je tiefer die Kette geht. Das Limit von fünf Ebenen ist eine Stack-Grenze, kein Ziel – die meisten nützlichen Ketten leben auf Tiefe zwei oder drei. Das Standardmuster zur Kostenkontrolle ist, beim Abstieg nach Modell zu routen: ein stärkeres Modell an der Wurzel für die Planung, dann günstigere, schnellere Modelle an den Blättern, die den Großteil des Lesens erledigen. Verschachtelung ist mächtig für wirklich hierarchische Arbeit und verschwenderisch für alles andere.

Wie wir Subagents bei TechRiseUps einsetzen

Wir bauen und betreiben diese Seite mit Claude Code, Subagents sind hier also nicht theoretisch. Unsere automatisierte Publishing-Pipeline nutzt einen Fresh-Eyes-Reviewer-Subagent als harte Schranke: Nachdem ein Entwurf geschrieben ist, bewertet ein separater Agent mit eigenem Kontext ihn anhand einer Rubrik und gibt ein PASS / FIX / FAIL-Urteil zurück, bevor irgendetwas veröffentlicht wird. Das Review in einem isolierten Fenster laufen zu lassen, ist entscheidend – es sieht nie die Argumentation des Autors, also bewertet es den Artikel, den ein Leser tatsächlich bekommen würde, nicht die Absicht dahinter. Wir setzen außerdem auf Read-only-Recherche-Agents, um Quellen zu sammeln, ohne den Hauptthread zuzumüllen. Der ehrliche Vorbehalt, der zur obigen Kostenanalyse passt: Wir reservieren Delegation für abgegrenzte, klar definierte Schritte. Für schnelle Bearbeitungen lassen wir sie weg, weil der Overhead es nicht wert ist.

Häufig gestellte Fragen

Was ist der Unterschied zwischen einem Claude Code Subagent und einem Skill?

Ein Subagent führt eine Aufgabe in seinem eigenen isolierten Context Window aus und meldet eine Zusammenfassung zurück; ein Skill schleust Anweisungen und Referenzdateien in deine aktuelle Unterhaltung ein. Nutze einen Subagent, um lärmende Arbeit aus deinem Hauptthread herauszuhalten, und einen Skill, um nützliches Know-how vor dem Modell zu behalten.

Kosten Subagents mehr Tokens?

Ja. Delegation kopiert Kontext in ein neues Fenster, weshalb Multi-Agent-Läufe üblicherweise mit dem 4- bis 7-Fachen an Tokens einer einzelnen Sitzung angegeben werden, und verschachtelte Ketten multiplizieren das weiter. Bei Plänen, wo das meiste davon zwischengespeichertes Lesen ist, fallen die effektiven Kosten geringer aus, aber Subagents sind ein Effizienzwerkzeug für den Kontext, nicht für den Token-Verbrauch.

Wo werden Claude Code Subagents gespeichert?

In .claude/agents/ für projektbezogene Subagents (per Git teilbar) oder in ~/.claude/agents/ für persönliche, die über all deine Projekte hinweg verfügbar sind. Beide werden rekursiv durchsucht, und bei einer Namenskollision gewinnt die Definition, die deinem Arbeitsverzeichnis am nächsten liegt.

Kann ein Subagent einen anderen Subagent aufrufen?

Ja, seit v2.1.172 können Subagents bis zu fünf Ebenen tief verschachteln, wobei die meisten praktischen Workflows bei zwei oder drei Ebenen bleiben, weil die Token-Kosten mit jeder Schicht ansteigen.

Kann ich wählen, welches Modell ein Subagent verwendet?

Ja – setze das Feld model auf haiku, sonnet, opus, fable, eine vollständige Modell-ID oder inherit. Günstige Modelle wie Haiku an leselastige Subagents zu routen, ist die wichtigste Methode, mit der Leute Multi-Agent-Kosten niedrig halten.

Quellen

• Anthropic – Eigene Subagents erstellen (offizielle Dokumentation): Definition, Frontmatter-Felder, Dateispeicherorte, eingebaute Typen und Aufruf.
• ksred.com – Claude Code Agents & Subagents: What They Actually Unlock: Kontextisolation, die drei eingebauten Typen und die Token-Kosten-Multiplikatoren.
• ofox.ai – Claude Code Nested Sub-Agents: 5 Levels Deep, Token Math: das Nesting-Release v2.1.172, Tiefenlimits und die sich aufsummierenden Token-Kosten.