Claude Code Subagenten: Die Regelgrenze, vor der niemand warnt

Claude Code Subagenten gehören zu den nützlichsten Funktionen des Tools und sind gleichzeitig am leichtesten unbemerkt falsch zu nutzen. Sie fächern Arbeit auf. Sie fächern aber auch eine Lücke auf: Jede Regel, die du geschrieben hast, um deinen Agenten im Zaum zu halten, endet an der Tür des Subagenten. Dieser Beitrag erklärt, was Subagenten sind, wann man sie einsetzt und welches Grenzproblem in keinem Leitfaden für Einsteiger erwähnt wird.

Was sind Claude Code Subagenten?

Ein Subagent ist ein neuer Agent, den dein Hauptagent mit dem Tool Task startet, um eine in sich geschlossene Aufgabe selbstständig zu erledigen. Er läuft in seinem eigenen Kontextfenster, erledigt die Arbeit und gibt nur seine endgültige Antwort zurück. Diese Isolation ist der eigentliche Zweck: Eine umfassende Suche oder ein großes Audit können Tausende von Token verbrauchen, und ein Subagent hält all diesen Lärm aus deiner Hauptkonversation heraus.

Die Isolation funktioniert in beide Richtungen. Der Subagent sieht deine laufende Konversation nicht, und, wie wir gleich sehen werden, sieht er auch nicht die Regeln, die du zu Beginn aufgestellt hast.

Wann man einen Subagenten einsetzt

Nutze einen Subagenten, wenn eine Aufgabe unabhängig ist und viel Rauschen erzeugt: eine Suche über die gesamte Codebasis, wenn du nicht weißt, wo sich etwas befindet, eine Überprüfung mehrerer Dateien, bei der du nur das Ergebnis brauchst, oder mehrere unabhängige Aufgaben, die du parallel ausführen möchtest. Behalte eng verzahnte, schrittweise Arbeiten in der Hauptsitzung, bei denen jeder Schritt vom vorherigen abhängt.

Die Faustregel lautet: Delegiere das Lesen, behalte das Entscheiden. Ein Subagent ist hervorragend darin, Dinge herauszufinden. Für Aufgaben, bei denen du Schritt für Schritt auf dem Laufenden bleiben musst, ist er jedoch ungeeignet, da du ihn während des Prozesses nicht anleiten kannst. Du schickst einen Prompt ab und erhältst eine Antwort zurück.

Warum deine Regeln an der Task-Grenze enden

Hier ist der Teil, vor dem dich niemand warnt. Wenn dein Hauptagent einen Subagenten startet, erbt der Subagent dein Modell, aber nicht deine Regeln. Claude Code lädt deine CLAUDE.md und führt deine SessionStart-Hooks zu Beginn der Hauptsitzung aus, und dieser Kontext überschreitet nie die Task-Grenze. Der Subagent startet komplett neu, mit seinem eigenen System-Prompt und ohne deine sorgfältig geschriebenen Verhaltensregeln.

Denk darüber nach, was das im großen Stil bedeutet. Du verbringst einen Nachmittag damit, eine CLAUDE.md so abzustimmen, dass dein Agent nachfragt, bevor er baut, schlank bleibt und keine AI-Slop-UI liefert. Dann startet dein Agent fünf Subagenten, um ein Refactoring zu parallelisieren. Diese fünf laufen völlig ohne deine Regeln. Genau dort, wo du dir am meisten Zurückhaltung wünschst, wenn mehrere Agenten gleichzeitig Dateien bearbeiten, fehlen deine Regeln komplett. Das ist kein Fehler in deiner Konfiguration. So funktioniert diese Grenze, und es ist unsichtbar, bis man gezielt danach sucht.

Das wurde bereits öffentlich dokumentiert. Im Repository „ponytail rules“ wurde genau dazu Issue #252 eröffnet: Die SessionStart-Anweisungen erreichen Subagenten nicht, sodass die Regeln in dem Moment, in dem Arbeit delegiert wird, stillschweigend nicht mehr gelten. Wenn du dich auf ein reines SessionStart-Setup verlässt, ist jede delegierte Aufgabe eine Lücke.

Die Lösung: Regeln mit einem SubagentStart-Hook neu injizieren

Die Lösung ist ein Hook, der bei SubagentStart ausgelöst wird und deine Arbeitsregeln direkt in den Kontext des neuen Subagenten schreibt. Claude Code stellt dieses Event genau aus diesem Grund bereit. kitstarter verknüpft es mit einem 16-zeiligen Skript, subagent-rules.mjs, das jedes Mal ausgeführt wird, wenn ein Subagent gestartet wird, und die wichtigen Regeln erneut vorgibt. Es ist fehlertolerant aufgebaut, sodass ein fehlerhafter Durchlauf den Subagenten niemals blockiert.

Dies sind die drei Regeln, die er wortwörtlich in jeden Subagenten injiziert:

Dieser einzelne Hook ist jedoch noch nicht alles. Er ist einer von acht Events, die kitstarter verknüpft, damit die Regeln an jedem Punkt einer Sitzung gelten, nicht nur zu Beginn.

Regeln, die an jeder Grenze gelten

Eine Regel, die nur einmal ausgelöst wird, ist eine lückenhafte Regel. kitstarter verknüpft acht Claude Code-Events mit acht Skripten, sodass dasselbe Verhalten gilt, wenn eine Sitzung startet, wenn du einen Prompt eingibst, wenn ein Tool ausgeführt wird, wenn ein Subagent gestartet wird und wenn der Agent versucht zu stoppen. Die vollständige Verknüpfungstabelle sieht so aus:

Funktioniert die Durchsetzung tatsächlich?

In unserem Reinraum-Benchmark ja, und wir veröffentlichen auch die Misserfolge. Mit demselben Modell und denselben skriptbasierten Aufgaben fragte das Kit bei 5 von 5 Aufgaben vor dem Erstellen nach, verglichen mit 2 von 5 bei der Standardversion von Claude Code. Es lieferte etwa 40 Prozent weniger Code für dasselbe Ergebnis und reduzierte die Slop-Merkmale bei der debug-spiral-Aufgabe von 5 auf 0. Erzwungenes Verhalten schlug stimmungsabhängiges Verhalten bei jeder Aufgabe, die Spielraum bot.

Die ehrliche Seite: Bei einer bereits klaren, minimalen Aufgabe erzeugt das Kit reinen Overhead. Die todo-app-Aufgabe lief etwa doppelt so langsam und war rund 75 Prozent teurer bei fast identischem Ergebnis. Über die gesamte Suite hinweg verursachen die Hook-Kontext-Token einen durchschnittlichen Aufpreis von etwa 25 Prozent. Diese Kosten sind real, sie werden offengelegt und von deinem bestehenden Abonnement bezahlt. Wir verheimlichen die Misserfolge nie, denn ein Benchmark, der nur Gewinne zeigt, ist Marketing, keine Messung.

Das Fazit

Die Nutzung von Claude Code Subagenten lohnt sich. Du musst nur die Grenze kennen: Sie erben dein Modell, nicht deine CLAUDE.md. Ein reines SessionStart-Setup lässt also jede delegierte Aufgabe ungeschützt. Schließe diese Lücke mit einem SubagentStart-Hook, der deine Regeln neu injiziert, und jeder von deinem Agenten gestartete Subagent wird an denselben Standard gehalten wie die Hauptsitzung. Du kannst diesen Hook anhand der obigen Struktur selbst schreiben oder mit einem bereits fertigen starten.