Claude Code Subagent Generator
Beschreiben Sie eine einzelne, klar definierte Aufgabe, die Sie abgeben möchten - PRs auf Sicherheitslücken prüfen, Unit-Tests schreiben, erforschen, wie etwas in einer Codebasis funktioniert - und erhalten Sie eine vollständige .claude/agents/<name>.md, die Sie direkt in Claude Code einfügen können. Die KI schreibt den Inhalt; Name, YAML-Frontmatter und die Tool-Allowlist werden während der Bearbeitung gegen die echten Subagent-Regeln geprüft, und eine rein lesende Beschreibung mit schreibfähigen Tools wird automatisch markiert.
1. Beschreibe die Aufgabe, die du delegieren möchtest
Umgangssprache reicht völlig. Denk an eine gut abgegrenzte Teilaufgabe, die du gern einem Spezialisten übergeben und von der du nur die Zusammenfassung lesen würdest - genau dafür ist ein Subagent gemacht.
Oder beginne mit einem dieser Beispiele
Dein .claude/agents/<name>.md erscheint hier, vollständig bearbeitbar, wobei Name und Beschreibung beim Tippen gegen die echten Subagenten-Regeln geprüft werden.
Was eine Subagent-Datei tatsächlich enthält
Ein Subagent ist eine einzige Markdown-Datei: YAML-Frontmatter oben, ein Markdown-Textkörper darunter. Der Textkörper ist kein Hinweis oder Zusatz - er ist der vollständige System-Prompt des Subagenten und ersetzt den Standard-Prompt von Claude Code für die gesamte Laufzeit dieses Subagenten. Er startet außerdem in seinem eigenen Kontextfenster, ohne dass irgendetwas aus Ihrer aktuellen Konversation übernommen wird, also muss alles, was er wissen muss, in diesem Textkörper stehen.
Nur zwei Frontmatter-Felder sind erforderlich. name verwendet nur Kleinbuchstaben und Bindestriche, enthält keine Doppelpunkte und muss unter Ihren Subagenten eindeutig sein - es ist der Dateiname und die Art, wie Sie den Subagenten manuell aufrufen. description ist das Feld, über das man sich wirklich Gedanken machen sollte, denn es ist der einzige Text, den Claude liest, um zu entscheiden, welcher Subagent eine Aufgabe erhalten soll. Zwei Subagenten mit vagen Beschreibungen werden sich gegenseitig die Arbeit wegnehmen.
Alles andere ist optional, und dieser Builder verdrahtet jedes davon tatsächlich in die Datei: tools (eine durch Kommas getrennte Positivliste - weglassen, um alle Tools zu erben), disallowedTools (die Negativliste), model (sonnet, opus, haiku, fable, eine vollständige Modell-ID oder inherit), permissionMode, maxTurns (eine Obergrenze für agentische Runden, bevor er anhält und Teilergebnisse zurückgibt), skills (Skill-Namen, die in seinen Kontext vorab geladen werden) und color, das nur zur Anzeige dient.
Das Wertvollste, was Sie mit dieser Liste tun können, ist tools schmal zu halten. Ein Code-Reviewer, der nur Read, Glob, Grep besitzt, kann Ihren Branch nicht umschreiben, während er „hilft“, egal wie sich die Konversation entwickelt. Dieses Tool prüft die Positivliste gegen das, was Ihre Beschreibung über den Zweck des Subagenten sagt, und markiert eine eigentlich nur lesende Aufgabe, der irgendwie Write, Edit oder Bash gegeben wurde.
Häufig gestellte Fragen
Was ist ein Claude-Code-Subagent genau?
Ein Subagent ist eine spezialisierte Claude-Instanz, die in ihrem eigenen, separaten Kontextfenster mit einem anderen System-Prompt läuft, sodass Sie ihm eine klar definierte Teilaufgabe übertragen und nur die Zusammenfassung zurückbekommen können. Er wird durch eine einzelne Markdown-Datei unter .claude/agents/<name>.md definiert: YAML-Frontmatter mit einem Namen und einer Beschreibung oben, und einem Textkörper, der der vollständige System-Prompt dieses Subagenten wird. Da er in einem isolierten Kontext arbeitet, landet die lange, unordentliche Recherche, die er betreibt - fünfzig Dateien lesen, Greps ausführen, Sackgassen verfolgen - nie in Ihrer Hauptkonversation. Nur sein Abschlussbericht tut das. Diese Isolation ist der ganze Sinn der Sache: Sie hält Ihren Hauptkontext sauber und erlaubt es, einer engen, bei Missbrauch gefährlichen Aufgabe ein ebenso enges Set an Tools zu geben.
Claude-Code-Agenten vs. Skills - was ist der Unterschied?
Ein Skill lädt Anweisungen in die Konversation, die Sie bereits führen; ein Subagent startet eine ganz neue eigene Konversation. Wenn ein Skill auslöst, wird sein SKILL.md-Textkörper Claudes aktuellem Kontext hinzugefügt, und Claude arbeitet als es selbst weiter, mit allem, was es bereits wusste. Wenn ein Subagent auslöst, erzeugt Claude eine separate Instanz mit leerem Kontext und einem anderen System-Prompt, diese Instanz arbeitet allein, und nur ihre Abschlussnachricht kommt zurück. Greifen Sie also zu einem Skill, wenn Sie Claude beibringen wollen, etwas zu tun, das es dann hier erledigt - ein Hausstil, eine Checkliste, ein Release-Verfahren. Greifen Sie zu einem Subagenten, wenn die Arbeit anderswo erledigt werden soll und Sie nur das Ergebnis wollen: eine große Suche, die Sie nicht Ihren Kontext zumüllen lassen wollen, oder eine Überprüfung, die von etwas durchgeführt werden soll, das Ihre Dateien buchstäblich nicht bearbeiten kann. Ein Slash-Befehl ist eine dritte, noch einfachere Sache: ein gespeicherter Prompt, den Sie durch Eingabe von /name auslösen, inline ausgeführt, ohne Isolation und ohne eigene Identität.
Wie erstelle ich einen Subagenten in Claude Code?
Erstellen Sie den Ordner mit mkdir -p .claude/agents, speichern Sie darin eine nach dem Subagenten benannte Markdown-Datei, und laden Sie Claude Code neu. Die Datei braucht YAML-Frontmatter mit mindestens name (nur Kleinbuchstaben und Bindestriche, keine Doppelpunkte, eindeutig) und description (wann Claude an ihn delegieren soll), gefolgt vom Textkörper, der als System-Prompt fungiert. Legen Sie sie unter .claude/agents/ im Repo ab, um sie in Git zu committen und mit Ihrem Team zu teilen, oder unter ~/.claude/agents/ in Ihrem Home-Ordner, um sie projektübergreifend persönlich zu halten. Existieren beide mit demselben Namen, gewinnt in diesem Repo die Projektversion. Dieser Generator schreibt die gesamte Datei für Sie und zeigt den genauen Pfad und den mkdir-Befehl für den gewählten Geltungsbereich.
Warum ist die Tool-Allowlist so wichtig?
Weil sie die einzige harte Grenze dafür ist, was ein Subagent tun kann. Lassen Sie tools weg, erbt der Subagent alles, was die Hauptkonversation hat, einschließlich MCP-Tools - gut für einen vertrauenswürdigen Helfer, unnötig riskant für einen, dessen gesamte Aufgabe darin besteht, zu schauen und zu berichten. Ein Sicherheitsprüfer mit Read, Glob, Grep kann Ihren Arbeitsbaum physisch nicht verändern; derselbe Prüfer mit Bash und Write kann es. Die Faustregel lautet: minimale Rechte - gewähren Sie das Minimum, das für die Aufgabe nötig ist, fügen Sie Write und Edit nur für einen Subagenten hinzu, der Dateien ändern soll, und Bash nur, wenn er wirklich etwas wie eine Testsuite ausführen muss. Dieser Builder markiert die Diskrepanz in beide Richtungen - eine review-artige Beschreibung mit schreibfähigen Tools, und eine fix-artige Beschreibung ohne jede Möglichkeit, etwas zu schreiben.
Wie entscheidet Claude, welchen Subagenten es verwendet?
Es gleicht die Aufgabe mit der Beschreibung jedes Subagenten ab, diese Zeichenkette ist also Ihre Routing-Tabelle. Eine Beschreibung wie 'Überprüft Code' gibt Claude nichts zum Unterscheiden und wird entweder für alles oder für nichts ausgewählt. Benennen Sie stattdessen die konkreten Auslöser: 'Überprüft geänderten Code auf Sicherheitslücken - Injection, fehlende Autorisierung, unsichere Deserialisierung, geleakte Secrets. Proaktiv verwenden nach jeder Änderung an Auth oder Eingabeverarbeitung, und immer, wenn der Nutzer eine Sicherheitsüberprüfung anfordert.' Der Hinweis 'proaktiv verwenden' fördert die automatische Delegation; Sie können dies jederzeit überschreiben, indem Sie einen Subagenten namentlich anfordern - 'benutze den security-code-reviewer-Subagenten, um diesen Diff zu prüfen'. In einem Multi-Agenten-Setup mit überlappenden Subagenten müssen die Beschreibungen klare Grenzen zwischen ihnen ziehen, weshalb dieser Generator live warnt, wenn Ihre zu generisch klingt oder den Wann-Teil auslässt.
Zwei Begleiter zu diesem hier: Der Claude Skill Generator schreibt eine SKILL.md, die Anweisungen in die Konversation lädt, in der Sie sich bereits befinden, und der AI Slash Command Generator schreibt die Einzeldatei-Version als /command.