Ab einem gewissen Projektumfang stößt eine einzelne, durchgehende Unterhaltung an eine praktische Grenze: Jede gelesene Datei, jede Zwischenüberlegung und jedes Suchergebnis bleibt Teil des Gesprächsverlaufs und damit des Kontextfensters (mehr dazu in Kapitel 22). Subagents lösen genau dieses Problem: Sie erledigen eine klar abgegrenzte Teilaufgabe in einer eigenen, separaten Unterhaltung und melden am Ende nur das Ergebnis zurück - der ganze Weg dorthin bleibt außen vor.

Was ein Subagent ist

Ein Subagent ist im Grunde eine zweite, spezialisierte Instanz von Claude Code, die für eine einzelne Aufgabe gestartet wird, eigenständig arbeitet, und danach eine Zusammenfassung an die Haupt-Sitzung zurückgibt. Die Haupt-Sitzung sieht dabei nicht jeden einzelnen Zwischenschritt des Subagents, sondern nur das fertige Ergebnis - vergleichbar damit, eine Kollegin um eine Recherche zu bitten und nur die Zusammenfassung zu bekommen, statt jede einzelne Google-Suche mitzuverfolgen.

Warum das den Kontext schont

Stell dir vor, du bittest Claude Code im Rezept-Planer-Projekt: "Durchsuche das ganze Frontend nach alten, nicht mehr genutzten CSS-Klassen." Diese Recherche kann viele Dateien lesen und viele Zwischenschritte brauchen. Läuft das direkt in der Haupt-Sitzung, füllt sich das Kontextfenster mit lauter Zwischenergebnissen, die für die eigentliche Arbeit am Feature gar nicht mehr relevant sind. Läuft dieselbe Recherche stattdessen in einem Subagent, bleibt in der Haupt-Sitzung nur die fertige Liste der gefundenen, ungenutzten Klassen übrig.

Typische Anwendungsfälle für Subagents

• Recherche: "Finde alle Stellen im Projekt, an denen aktuell direkt mit dem Dateisystem gearbeitet wird."
• Code-Review: ein zweiter, unabhängiger Blick auf eine Änderung, bevor sie übernommen wird - eine Art zweite Meinung.
• Abgegrenzte Teilaufgaben: "Schreib zusätzliche Tests für die Kategorie-Validierung aus dem letzten Kapitel, während ich mich um das Frontend kümmere."

Einen Subagent beauftragen

Im einfachsten Fall reicht es, eine Anfrage entsprechend zu formulieren, zum Beispiel:

> Beauftrage einen Subagent damit, die Tests in tests/recipes.test.js unabhaengig durchzusehen und zu prüfen, ob wichtige Fälle fehlen - ohne dabei selbst Code zu ändern. Fass mir am Ende nur zusammen, was fehlt.

Mit dem Slash-Command /agents aus Kapitel 16 lassen sich außerdem eigene, spezialisierte Subagents mit fest definiertem Aufgabenbereich einrichten und wiederverwenden - etwa ein Subagent, der ausschließlich für Code-Reviews im Rezept-Planer zuständig ist.

Subagents helfen dabei, den Kontext sauber zu halten. Im nächsten Kapitel geht es um eine andere Art der Erweiterung: MCP-Server, mit denen Claude Code Zugriff auf externe Werkzeuge und Datenquellen bekommt, die es von sich aus gar nicht kennt.