Dokumentationerreichbar
Anthropic, Create custom subagents
code.claude.com (externe Seite)
Die Herstellerdokumentation zu Subagenten. Sie beantwortet die Frage, wozu man sie nimmt, über den Kontext statt über die Arbeitsteilung: Eine Nebenaufgabe, deren Suchtreffer, Protokolle und Dateiinhalte niemand wieder braucht, läuft in einem eigenen Fenster und gibt nur die Zusammenfassung zurück. Dazu die Kanten, die man beim Bauen trifft: eigene Tool-Liste und eigene Berechtigungen, eine Anlaufzeit, weil ein Subagent bei null anfängt, und die Beobachtung, dass viele ausführliche Rückgaben denselben Platz kosten, den man sparen wollte.
geprüft 24.09.2026
Worauf sich diese Seite beruft, wörtlich, abgerufen am 04.08.2026:
Use one when a side task would flood your main conversation with search results, logs, or file contents you won't reference again: the subagent does that work in its own context and returns only the summary.
bestätigt 24.09.2026Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.
bestätigt 24.09.2026Running many subagents that each return detailed results can consume significant context.
bestätigt 24.09.2026At the depth limit, Claude Code withholds the Agent tool from every subagent except a fork
bestätigt 24.09.2026This works best when the research paths don't depend on each other.
bestätigt 24.09.2026There's no limit on the total number of subagents Claude can spawn over a session.
bestätigt 24.09.2026By default, when 20 subagents are running in a session, spawning another with the Agent tool fails
bestätigt 24.09.2026By default, a subagent can spawn subagents of its own, up to three layers below the main conversation.
bestätigt 24.09.2026Latency matters. A subagent that isn't a fork starts fresh and may need time to gather context
bestätigt 24.09.2026A fork inherits everything the main session has at the moment it spawns. Any other subagent starts fresh from its definition.
bestätigt 24.09.2026