Subagent — delegieren wie erfahrene Entwickler
Fokussierte Aufgaben an spezialisierte Claude-Instanzen übergeben
⏱ ca. ~6 Min
01 · Lesen
Erfahrene Entwickler machen nicht alles selbst — sie delegieren. Wenn ein Junior-Entwickler einen Senior bittet, einen Bug zu untersuchen, lässt der Senior seine aktuelle Arbeit nicht liegen. Er schickt jemanden zum Untersuchen und lässt sich berichten.
Subagents lassen dich dasselbe mit Claude Code machen. Statt einer großen Unterhaltung, die alles erledigt — Dateien lesen, Tests laufen lassen, Architektur untersuchen — kannst du fokussierte Aufgaben an spezialisierte Subagents delegieren, die in ihrem eigenen Context Window arbeiten.
Der entscheidende Vorteil: Subagents halten deine Hauptunterhaltung sauber. Ein Subagent liest vielleicht 50 Dateien, um dein Auth-System zu verstehen, gibt aber nur eine kurze Zusammenfassung an dein Context Window zurück.
💡 Stell dir das so vorStell dir einen Subagent vor wie eine Forschungsassistentin, die du in die Bibliothek schickst. Du gehst nicht selbst und stapelst Bücher auf deinem Schreibtisch — sie geht hin, liest alles und bringt eine einseitige Zusammenfassung zurück. Dein Schreibtisch bleibt frei für die wichtige Arbeit.
Kernpunkte
- Subagents laufen in einem eigenen Context Window, getrennt von deiner Hauptunterhaltung
- Sie untersuchen, analysieren und führen Aufgaben unabhängig aus
- Nur die Zusammenfassung kommt in deinen Context zurück — nicht alle Dateien, die sie gelesen haben
- Deine Hauptunterhaltung bleibt auf die Umsetzung fokussiert
02 · Lesen
Claude Code hat mehrere eingebaute Subagent-Typen, jeder für bestimmte Aufgaben gemacht:- Explore — Read-only-Recherche. Dateien suchen, Code lesen, Fragen zur Codebase beantworten. Kann nicht editieren. - Plan — Architektur-Design. Codebase erkunden, Umsetzungsplan vorschlagen. Read-only, bis du freigibst. - Bash — Befehlsspezialist. Führt Terminal-Befehle aus. Für Tests, Builds, System-Checks.
Claude erzeugt Subagents automatisch, wenn er Aufgaben erkennt, die isoliert werden sollten — wie das Untersuchen einer großen Codebase oder das Laufenlassen einer Test-Suite. Du kannst auch explizit darum bitten.
Kernpunkte
- Explore: Read-only-Recherche und Codebase-Analyse
- Plan: Architektur-Design und Umsetzungsplanung
- Bash: Terminal-Befehle und System-Operationen
- Claude erzeugt Subagents automatisch, wenn es passt
03 · Code-Beispiel
Du kannst Claude direkt bitten, einen Subagent zu nutzen. Unten ist ein Prompt, der die Subagent-Delegation auslöst.
Prompt, der einen Subagent auslöst
"Use a subagent to investigate how auth works in this codebase"
"Explore the database schema and summarize what tables we have"
"Run the test suite and report which tests fail"
"Analyze the API routes and list all endpoints"
Wenn du Claude bittest, etwas zu „untersuchen", „erkunden", „analysieren" oder „Tests laufen zu lassen", delegiert er das oft automatisch an einen Subagent. Der Subagent macht die schwere Arbeit in seinem eigenen Context und gibt eine knappe Zusammenfassung an deine Unterhaltung zurück.
04 · Lesen
Du kannst eigene Subagents bauen, indem du eine SKILL.md mit YAML-Frontmatter schreibst. Damit definierst du einen spezialisierten Agent mit eigenen Anweisungen, Tool-Einschränkungen und Modellwahl.
Eigene Agents sind stark, weil du ihre Fähigkeiten einschränken kannst. Ein Code-Reviewer muss nur Dateien lesen — er sollte nicht editieren oder Befehle ausführen. Ein Test-Runner braucht Bash, aber kein Edit. Die Tool-Einschränkungen machen den Agent sicherer und fokussierter.
Kernpunkte
- Eigene Agents werden in einer SKILL.md mit YAML-Frontmatter definiert
- Das tools:-Feld schränkt ein, was der Agent darf
- Ein Reviewer braucht Read/Grep/Glob — nicht Edit oder Bash
- Einschränkungen machen Agents sicherer und fokussierter
05 · Code-Beispiel
Unten siehst du, wie man einen eigenen Code-Reviewer-Subagent baut. Das YAML-Frontmatter konfiguriert sein Verhalten.
.claude/skills/code-reviewer/SKILL.md
---
name: code-reviewer
description: Expert code review specialist. Use after code changes.
tools: Read, Grep, Glob
model: sonnet
---
Review code for:
1. Bug risks and logic errors
2. Security vulnerabilities (injection, auth bypass)
3. Performance issues (N+1 queries, unnecessary loops)
4. Style inconsistencies with the existing codebase
Provide specific line references and severity ratings.
Dieser Agent kann nur Code lesen — keine Dateien editieren, keine Befehle ausführen. Die Einschränkung tools: Read, Grep, Glob sorgt dafür, dass er beim Review bleibt. model: sonnet heißt, er nutzt Sonnet (schnell, kosteneffizient) statt des Modells deiner Hauptunterhaltung.
06 · Quiz
Du baust ein neues Feature und musst verstehen, wie das bestehende Auth-System funktioniert. Dafür müssen 20+ Dateien gelesen werden. Was ist der context-effizienteste Ansatz?
- Alle 20 Dateien selbst in der Hauptunterhaltung lesen
- Claude bitten, Auth zu erklären, ohne die Dateien zu lesen
- Eine neue Claude-Session für die Untersuchung öffnen
- Einen Subagent zum Untersuchen schicken und eine Zusammenfassung zurückbekommen
07 · Zuordnen
Ordne jeden Subagent-Typ dem besten Einsatz zu.
(Diese Sektion ist interaktiv — aktiviere JavaScript, um sie zu nutzen.)
Andere Lektionen aus diesem Kapitel
⚠ Das volle interaktive Erlebnis braucht JavaScript. Bitte aktiviere es und lade die Seite neu.
※ Diese Seite ist ein unabhängiges Bildungsprojekt — kein offizielles Anthropic-Produkt. Claude™ ist eine eingetragene Marke von Anthropic, PBC.