# claude-code-subagents-documentation-anthropic-2025-09-29

## Veille

Claude Code Subagents - Spezialisierte KI-Assistenten - Context Management - Aufgabendelegation - Anthropic-Dokumentation

## Titre Article

Subagents - Claude Docs

## Date

2025-09-29

## URL

https://docs.anthropic.com/en/docs/claude-code/sub-agents

## Keywords

Claude Code, Subagents, KI-Assistenten, aufgabenspezifische Workflows, Context Management, System-Prompts, Tools, Delegation, Code reviewer, Debugger, Data scientist, KI-Modelle, Konfiguration, Best Practices, YAML-Frontmatter, Markdown-Dateien, Tool-Berechtigungen, `/agents`-Befehl

## Authors

Anthropic (documentation officielle)

## Ton

**Profil:** Professionell-pädagogisch | Instruktiv | Lehrreich | Mittleres Niveau

Die Dokumentation verwendet einen typischen technischen Schreibstil, der Gründlichkeit und Zugänglichkeit ausbalanciert. Die systematische Struktur (Merkmale → Konfiguration → Beispiele → Best Practices) leitet zu einem schrittweisen Verständnis an. Präzise Fachterminologie (YAML-Frontmatter, Kontextfenster, Tool-Berechtigungen) setzt ein Entwicklerpublikum voraus. Konkrete Codebeispiele (Code reviewer, Debugger, Data scientist) verankern die abstrakten Konzepte. Präskriptive Sprache bei Best Practices bietet klare Orientierung. Sorgfältige Formatierung mit klar abgegrenzten Abschnitten erleichtert das überfliegende Lesen. Kein werblicher Diskurs — rein instruktiver Inhalt. Typische Qualität von Entwicklerdokumentation (Stripe-Stil, Anthropic-Docs), die Klarheit und praktischen Nutzen priorisiert.

## Pense-betes

- **Subagents = spezialisierte KI-Assistenten** mit eigenem Zweck, separatem Kontextfenster, konfigurierbaren Tools, angepasstem System-Prompt
- **Wesentliche Vorteile**: Kontexterhaltung, spezialisierte Expertise, Wiederverwendbarkeit, flexible Tool-Berechtigungen
- **Verwaltung über `/agents`** oder direkte Dateien (Markdown + YAML-Frontmatter)
- **Konfiguration**: `name`, `description`, `tools` (optional), `model` (optional)
- **Aufruf**: automatisch durch Claude Code oder explizit durch Nennung des Namens
- **Speicherort**: `.claude/agents/` (Projekt) oder `~/.claude/agents/` (Benutzer)
- **Typische Beispiele**: Code reviewer (Read, Grep, Glob, Bash), Debugger (Read, Edit, Bash, Grep, Glob), Data scientist (Bash, Read, Write)
- **Best Practices**: mit von Claude generierten Agents beginnen, fokussiertes Design, detaillierte Prompts, Tool-Zugriff beschränken, Versionskontrolle für Projekt-Agents
- **Verkettung möglich**: mehrere Subagents für komplexe Workflows
- **Dynamische Auswahl**: Claude wählt den passenden Subagent basierend auf Aufgabe/Kontext

## RésuméDe400mots

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.

## GrapheDeConnaissance

- Anthropic —publie→ documentation subagents Claude Code (DOCUMENT, 0.99)
- Claude Code —utilise→ subagents (TECHNOLOGIE, 0.99)
- subagents —utilise→ context window séparé (CONCEPT, 0.98)
- subagents —utilise→ fichiers Markdown YAML frontmatter (TECHNOLOGIE, 0.97)
- Claude Code —permet→ subagents (CONCEPT, 0.98)
- subagents —améliore→ préservation du contexte (CONCEPT, 0.95)
- Claude Code —utilise→ Plan subagent (TECHNOLOGIE, 0.96)
- Plan subagent —s_applique_à→ plan mode (METHODOLOGIE, 0.97)
- subagents —permet→ chaînage de workflows (CONCEPT, 0.92)
- subagents —observé_dans→ répertoire .claude/agents/ (TECHNOLOGIE, 0.98)
- subagents —utilise→ MCP Tools (TECHNOLOGIE, 0.93)
- subagents —utilise→ agentId (CONCEPT, 0.9)

---
Canonical: https://www.thekb.eu/de/fiches/claude-code-subagents-documentation-anthropic-2025-09-29/