Die offizielle Claude-Code-Dokumentation stellt „Subagents“ vor, spezialisierte KI-Assistenten, die aufgabenspezifische Workflows verbessern und das Context Management innerhalb der Entwicklungsumgebung optimieren sollen. Diese Subagents sind vorkonfigurierte KI-Personas, an die Claude Code Aufgaben delegieren kann, wobei jeder mit einem eigenen Zweck und gezielter Fachkompetenz in seinem Bereich arbeitet.
Kerneigenschaften
Jeder Subagent verfügt über vier wesentliche Attribute: ein unabhängiges Kontextfenster, das eine Verunreinigung des Hauptkonversationskontexts vermeidet, ein konfigurierbares, domänenspezifisches Toolset sowie einen angepassten System-Prompt, der sein Verhalten steuert. Diese kontextuelle Isolation ermöglicht eine fokussiertere und effektivere Problemlösung, wobei feinabgestimmte Anweisungen die Erfolgsquote bei den zugewiesenen Aufgaben verbessern.
Strukturelle Vorteile
Subagents bieten vier wesentliche Vorteile: Kontexterhaltung, indem die Hauptkonversation auf übergeordnete Ziele fokussiert bleibt, spezialisierte Expertise durch detaillierte Anweisungen für bestimmte Domänen, die die Leistung verbessern, Wiederverwendbarkeit projektübergreifend mit der Möglichkeit, sie teamübergreifend zu teilen und so konsistente Workflows zu fördern, sowie flexible Berechtigungen mit granularer Kontrolle über den Tool-Zugriff je Subagent-Typ zur Erhöhung der Sicherheit.
Erstellung und Konfiguration
Die Erstellung erfolgt über den Befehl /agents in Claude Code, der die Auswahl zwischen projekt- oder benutzerbezogenen Subagents ermöglicht. Benutzer definieren den Zweck und gewähren Zugriff auf bestimmte Tools. Subagents werden als Markdown-Dateien mit YAML-Frontmatter gespeichert: .claude/agents/ für die Projektebene, ~/.claude/agents/ für die Benutzerebene. Zu den Konfigurationsfeldern gehören name (eindeutiger Bezeichner), description (Zweckbeschreibung), tools (optionale, kommagetrennte Liste) und model (optionale Angabe wie sonnet, opus, haiku oder inherit).
Praktische Beispiele und Muster
Die Dokumentation liefert drei archetypische Beispiele: Code reviewer, ein Experte für Codequalität und Sicherheit mit Read, Grep, Glob, Bash; Debugger, spezialisiert auf Ursachenanalyse mit Read, Edit, Bash, Grep, Glob; Data scientist, ein Experte für SQL- und BigQuery-Analysen mit Bash, Read, Write. Diese Muster veranschaulichen, wie die Beschränkung des Tool-Zugriffs auf das strikte Minimum Sicherheit und Fokussierung verbessert.
Verwaltung und Aufruf
Der Befehl /agents bietet eine interaktive Oberfläche zum Anzeigen, Erstellen, Bearbeiten und Löschen von Subagents sowie zur Verwaltung der Tool-Berechtigungen. Alternative: direkte Dateiverwaltung. Claude Code kann Aufgaben basierend auf Aufgabenbeschreibung, Subagent-Konfiguration und aktuellem Kontext automatisch an Subagents delegieren. Ein expliziter Aufruf ist durch Nennung des Namens möglich.
Best Practices und fortgeschrittene Anwendungsfälle
Zu den wichtigsten Empfehlungen zählen: mit von Claude generierten Agents zur ersten Kalibrierung beginnen, fokussierte Subagents mit klaren Zuständigkeiten entwerfen, detaillierte System-Prompts verfassen, den Tool-Zugriff auf das strikte Minimum beschränken und Versionskontrolle für projektbezogene Subagents verwenden. Fortgeschrittene Anwendungen umfassen das Verketten mehrerer Subagents für komplexe Workflows sowie die Nutzung dynamischer Auswahl, bei der Claude automatisch den passenden Subagent basierend auf dem Kontext wählt. Diese modulare Architektur ermöglicht eine flexible Zusammensetzung spezialisierter Fähigkeiten bei gleichzeitiger Wahrung der Aufgabentrennung und Kontextklarheit.