Source: https://aiprimetech.io/de/claude-code/subagents/ [Startseite](/de/) › [Claude Code](/de/claude-code/) › Subagenten [Überblick](/de/claude-code/)[Installation](/de/claude-code/install/)[CLI-Referenz](/de/claude-code/cli/)[Preise und Limits](/de/claude-code/pricing/)[Agent SDK](/de/claude-code/sdk/)[Skills und Plugins](/de/claude-code/skills/)[GitHub](/de/claude-code/github/)[Web, Desktop und IDE](/de/claude-code/web-and-desktop/)[Modelle](/de/claude-code/models/)[Fehler](/de/claude-code/errors/)[Open Source?](/de/claude-code/open-source/)[Tutorial](/de/claude-code/tutorial/)[Für Studierende](/de/claude-code/for-students/)[QA-Automatisierung](/de/claude-code/qa-automation/)[Vergleich mit Cursor](/de/claude-code/vs-cursor/)[Vergleich mit Codex und OpenCode](/de/claude-code/vs-codex/)[Subagenten](/de/claude-code/subagents/)[Hooks](/de/claude-code/hooks/)[MCP](/de/claude-code/mcp/)[Ökosystem](/de/claude-code/ecosystem/)[VS Code](/de/claude-code/vscode/)[OpenRouter](/de/claude-code/openrouter/)[Anfragelimits](/de/claude-code/rate-limits/)[Chinesischer Leitfaden](/claude-code/zh/) Zuletzt aktualisiert: 11. Oktober 2026 # Claude Code-Subagenten: Funktionsweise, Definition und Agententeams Ein Subagent ist ein separater Claude Code-Arbeitsagent mit eigenem System-Prompt, eigenen Werkzeugberechtigungen und — besonders wichtig — einem eigenen Kontextfenster. Die Hauptsitzung delegiert eine Aufgabe an ihn, erhält eine Zusammenfassung zurück und hält ihren Kontext übersichtlich. Richtig eingesetzt, machen Subagenten den Unterschied zwischen einer Sitzung, deren Qualität nach einer Stunde nachlässt, und einer, die den ganzen Tag läuft. ## TLDR - Definieren Sie einen als Markdown-Datei in .claude/agents/ (Projekt) oder ~/.claude/agents/ (benutzerspezifisch): Frontmatter für name, description, tools, model; der Textkörper ist der System-Prompt. - Claude delegiert automatisch, wenn die Beschreibung zur Aufgabe passt, oder ausdrücklich, wenn Sie den Agenten nennen. - Jeder Subagent hat seinen eigenen Kontext und verursacht eigene Token-Kosten; die Ergebnisse werden zusammengefasst zurückgegeben. - /agents erstellt und verwaltet sie; Agententeams erweitern das Konzept auf die Koordination von Sitzungen. ## Einen Subagenten definieren ``` # .claude/agents/code-reviewer.md --- name: code-reviewer description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change. tools: Read, Grep, Glob, Bash(git diff *) model: sonnet --- You are a senior reviewer. Read the staged diff, list concrete defects with file:line, flag untested paths, and stop. Do not edit files. ``` name legt fest, wie Sie ihn aufrufen; description bestimmt, wann Claude ihn selbstständig aufruft. Formulieren Sie es daher als Routing-Regel („nach jeder nicht trivialen Änderung verwenden“) statt als Stellenbezeichnung. tools schränkt ein, was er tun darf — ein Reviewer, der nichts bearbeiten kann, ist ein sicherer Reviewer. model legt eine Modellstufe fest: haiku für Erkundung und Klassifizierung, sonnet für die meisten Aufgaben, opus für den schwierigen Schritt oder inherit um der übergeordneten Sitzung zu folgen. ## Projekt- und Benutzeragenten Dateien in .claude/agents/ gehören zum Repository und werden mit ihm weitergegeben — checken Sie sie ein, und jedes Teammitglied erhält denselben Reviewer, Testautor und Migrationsagenten. Dateien in ~/.claude/agents/ stehen Ihnen in jedem Projekt zur Verfügung. Bei Namenskonflikten haben Projektagenten Vorrang. /agents listet innerhalb einer Sitzung beide Arten auf, erstellt und bearbeitet sie, ohne dass Sie Dateien manuell ändern müssen. ## Wann Claude delegiert Es gibt zwei Wege. Implizit: Der Hauptagent liest die Beschreibung jedes Subagenten und delegiert, wenn eine Aufgabe dazu passt — „führe den Subagenten code-reviewer dafür aus“ ist nicht nötig, wenn die Beschreibung bereits angibt, wann er verwendet werden soll. Explizit: Nennen Sie ihn im Prompt. In beiden Fällen läuft der Subagent in seinem eigenen Kontext, sieht nur das, was er erhält und selbst liest, und liefert ein Ergebnis zurück, das die Hauptsitzung als Zusammenfassung in ihren eigenen Verlauf aufnimmt. Subagenten starten keine weiteren Subagenten; die Hierarchie ist nur eine Ebene tief. ## Warum sie die Sitzungskosten niedrig halten Bei jedem Schritt in Claude Code wird die gesamte Unterhaltung erneut gesendet. Ein Subagent, der vierzig Dateien liest, tut dies in seinem eigenen Kontextfenster; die übergeordnete Sitzung erhält einen Absatz. Ohne Subagents würden diese vierzig Dateien für den Rest der Sitzung im Hauptkontext bleiben und bei jedem Schritt erneut gesendet werden. Das Muster für große Codebasen lautet daher: mit einem Haiku-Subagent erkunden, mit einem Sonnet-Subagent prüfen und den Kontext der übergeordneten Sitzung für Entscheidungen freihalten. Jeder Subagent rechnet seine eigenen Tokens ab — er ist nicht kostenlos, sein Kontext bleibt aber begrenzt. ## Parallelität und Ratenlimits Mehrere Subagents können gleichzeitig laufen, und jeder davon ist eine parallele Streaming-Anfrage. So erreichen Sie am schnellsten das Limit für gleichzeitige Anfragen eines Endpunkts. Beginnen Sie daher bei einem neuen Gateway-Konto mit zwei oder drei parallelen Subagents und beantragen Sie eine höhere Parallelität, sobald eine tatsächliche Arbeitslast vorliegt. Der Fehlerleitfaden behandelt die 429, die Sie andernfalls erhalten. ## Agententeams Neuere Versionen von Claude Code bieten Agententeams: Statt einer übergeordneten Sitzung, die Aufgaben an kurzlebige Subagents delegiert, koordinieren sich mehrere Sitzungen als benannte Teammitglieder mit einer gemeinsamen Aufgabenliste und Nachrichten untereinander. So kann eine leitende Sitzung Aufgaben verteilen, den Status abfragen und ein Teammitglied stoppen. Diese experimentelle Funktion wird über eine Einstellung aktiviert und ändert sich zwischen Versionen — prüfen Sie claude --help und das Änderungsprotokoll auf den aktuellen Schalter, statt sich auf einen Blogbeitrag zu verlassen. Das Grundprinzip entspricht dem von Subagents, ergänzt um Persistenz und Kommunikation; auch das Kostenmodell ist gleich, multipliziert mit der Anzahl der Teammitglieder. ## Auf dem Gateway Subagents und Teams verwenden denselben Endpunkt und Schlüssel wie die übergeordnete Sitzung, daher deckt ANTHROPIC_BASE_URL=https://aiprimetech.io sie alle ab. Bei einem unbegrenzten Pauschaltarif wird die Frage der Parallelität zu einer Frage der fairen Nutzung statt der Abrechnung. Deshalb landen Nutzer mit intensiver Multi-Agent-Nutzung häufig dort. | Plan | Laufzeit | Preis | Unbegrenzt für 1 Stunde | 1 Stunde | $1 | Unbegrenzt für 24 Stunden | 24 Stunden | $10 | Unbegrenzt für 1 Woche | 1 Woche | $49 | Unbegrenzt für 15 Tage | 15 Tage | $89 [Alle unbegrenzten Tarife →](/de/plans/) ## Zuerst kostenlos ausprobieren Neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code CLAUDECODE — genug für einen Abend mit Claude Code auf Sonnet — danach Guthaben zum 7.69231-Fachen des Nennwerts. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Konto mit dem Code CLAUDECODE erstellen](/register?promo=CLAUDECODE) ## Häufig gestellte Fragen Was ist ein Subagent in Claude Code? Ein separater Agent mit eigenem System-Prompt, eigenen Werkzeugberechtigungen, eigener Modellwahl und eigenem Kontextfenster, der als Markdown-Datei in .claude/agents/ definiert ist und dem die Hauptsitzung Aufgaben überträgt.Wo finde ich die Dokumentation zu Subagents in Claude Code? Die offizielle Referenz finden Sie in Anthropics Claude Code-Dokumentation unter Sub-agents; diese Seite ist die praxisorientierte Fassung — mit Dateiformat, den Bedingungen für die Delegation und den Kosten.Kosten Subagents extra? Ihre eigenen Tokens werden wie bei jeder Anfrage abgerechnet. Bei langen Sitzungen sparen sie Geld, indem sie umfangreiche Lesevorgänge aus dem übergeordneten Kontext heraushalten. Wenn Sie viele davon parallel mit Opus ausführen, steigen die Kosten.Was sind Agententeams? Eine experimentelle Erweiterung, bei der sich mehrere Claude Code-Sitzungen als benannte Teammitglieder über Nachrichten und eine gemeinsame Aufgabenliste koordinieren, statt mit einer übergeordneten Sitzung und kurzlebigen Helfern zu arbeiten. ## Claude Code über das Gateway nutzen Dieselben Modelle, zwei Umgebungsvariablen, Guthaben zum 7.69231-Fachen des Nennwerts — oder ein unbegrenzter Pauschaltarif. Neue Konten: $5 kostenloses API-Guthaben mit dem Code CLAUDECODE.[API-Schlüssel erhalten](/register?promo=CLAUDECODE) [Unbegrenzte Tarife ansehen](/de/plans/) AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen. ## Weitere Leitfäden zu Claude Code [Claude Code: der vollständige Leitfaden](/de/claude-code/)[So installieren Sie Claude Code](/de/claude-code/install/)[Claude Code CLI-Dokumentation: Befehle und Flags](/de/claude-code/cli/)[Preise und Limits von Claude Code erklärt](/de/claude-code/pricing/)[Das Claude Code SDK, jetzt Claude Agent SDK](/de/claude-code/sdk/)[Skills und Plugins für Claude Code](/de/claude-code/skills/)[Claude Code in GitHub: die App, die Action und @claude](/de/claude-code/github/)[Hat Claude Code eine Weboberfläche? Web, Desktop und IDE erklärt](/de/claude-code/web-and-desktop/)[Welches Modell Claude Code verwendet und wie Sie es ändern](/de/claude-code/models/)[Fehler in Claude Code und wie Sie sie beheben](/de/claude-code/errors/)[Ist Claude Code Open Source?](/de/claude-code/open-source/)[Claude Code Tutorial: Ihre erste echte Sitzung](/de/claude-code/tutorial/)[Claude für Studierende: Claude Code, die API und was Bildungsangebote Ihnen tatsächlich bieten](/de/claude-code/for-students/)[So nutzen Sie Claude Code für die QA-Automatisierung](/de/claude-code/qa-automation/)[Claude Code im Vergleich mit Cursor: welches Werkzeug wann — und wie Sie beide nutzen](/de/claude-code/vs-cursor/)[Claude Code vs. Codex vs. OpenCode: Terminal-Agenten im Vergleich](/de/claude-code/vs-codex/)[Claude Code-Hooks: deterministische Kontrolle über die Aktionen des Agenten](/de/claude-code/hooks/)[Claude Code MCP: Server verbinden, Geltungsbereiche, Remote-MCP und Praxisbeispiele](/de/claude-code/mcp/)[Das Claude Code-Ökosystem: Router, Frameworks, Plugins und die Listen, die sie erfassen](/de/claude-code/ecosystem/)[Claude Code in VS Code: die Erweiterung, die Nutzung im Terminal und die Fehler](/de/claude-code/vscode/)[OpenRouter in Claude Code verwenden (und wann Sie darauf verzichten sollten)](/de/claude-code/openrouter/)[Claude-Fehler zum Ratenlimit: Was „API error: rate limit reached“ bedeutet und wie Sie ihn beheben](/de/claude-code/rate-limits/)[Claude Code verwenden: von der Installation bis zur täglichen Nutzung](/claude-code/zh/)