Subagent

Ein Sub-Agent ist ein spezialisierter Assistent, der eine bestimmte Art von Aufgabe in seinem eigenen context-window mit einem benutzerdefinierten System-Prompt, spezifischem Tool-Zugriff und unabhängigen Berechtigungen bearbeitet. Verwenden Sie ihn, wenn eine Nebenaufgabe Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten würde, auf die Sie nicht mehr verweisen werden; der Sub-Agent erledigt diese Arbeit in seinem eigenen Kontext und gibt nur die Zusammenfassung zurück. Claude verwendet das description-Feld jedes Sub-Agenten, um zu entscheiden, wann delegiert werden soll.

Sub-Agenten werden in .agent.md-Dateien definiert. Verifizierte Speicherorte für diese Dateien sind .claude/agents/ (für das aktuelle Projekt, im Versionskontrollsystem) und ~/.claude/agents/ (für alle Ihre Projekte). Claude Code scannt beide Verzeichnisse rekursiv. Die Identität eines Sub-Agenten ergibt sich ausschließlich aus seinem name-Frontmatter-Feld, das eindeutig, kleingeschrieben und durch Bindestriche getrennt sein muss; der Dateiname oder der Unterordnerpfad trägt nicht zu seiner Identität bei.

Erforderliche Frontmatter-Felder sind name und description. Die description teilt Claude mit, wann Aufgaben an diesen Sub-Agenten delegiert werden sollen. Optional können Sie tools angeben, um Zugriff auf bestimmte Tools zu gewähren (lässt man dieses Feld weg, wird Zugriff auf alle verfügbaren Tools gewährt). Das Feld model kann angeben, welches Claude-Modell verwendet werden soll (z. B. sonnet, opus, haiku, fable oder eine vollständige Modell-ID) oder das Standardmodell erben. Ein Feld skills kann verwendet werden, um bestimmte Skills in den Kontext des Sub-Agenten vorzuladen.

Plugin-Sub-Agenten unterstützen aus Sicherheitsgründen keine hooks, mcpServers oder permissionMode. Claude Code überwacht beide Agentenverzeichnisse, sodass Änderungen an Sub-Agenten-Definitionen innerhalb von Sekunden angewendet werden, ohne dass ein Neustart erforderlich ist. Der Befehl /agents öffnet nicht mehr einen Erstellungsassistenten; er fordert den Benutzer auf, Claude zu fragen oder die .agent.md-Dateien direkt zu bearbeiten.

Skills wie Sub-Agents können externe CLI-KIs als abgegrenzte Sub-Agenten starten, während Create Custom Agent diese .agent.md-Dateien erstellt. Für komplexe Workflows kann Multi-Agent Coordinator Aufgaben auf Sub-Agenten aufteilen, und Agent Orchestration Advisor hilft bei der Gestaltung dieser Multi-Agenten-Systeme, möglicherweise unter Nutzung von progressive-disclosure-Mustern.