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 |
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_keyHä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 Unbegrenzte Tarife ansehenAI 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.