Inhaltsverzeichnis
- 1. Was möglich ist: Subagenten mit anderem Modell und anderem Aufwand
- 2. In welcher Reihenfolge das Modell festgelegt wird
- 3. So richten Sie es ein (fünf Wege)
- 4. Mit welchem Modell die eingebauten Subagenten laufen
- 5. Messung 1: Lief es wirklich mit diesem Modell?
- 6. Messung 2: Zehntausende Tokens allein für den Start
- 7. Messung 3: Dieselbe Übersetzung, je zweimal mit drei Modellen
- 8. Auswirkung auf Kosten und Nutzungslimits
- 9. Welche Arbeit Sie auf ein günstigeres Modell verlagern
- FAQ
Die Hauptsitzung von Claude Code soll mit Opus 5 laufen, und auch den Aufwand (effort) möchten Sie hoch lassen. Aber Aufgaben wie Übersetzungen oder das Durchsehen vieler Dateien mit demselben Modell zu erledigen, wirkt verschwenderisch. Daraus entsteht die Frage: Lassen sich nur die Subagenten mit Sonnet oder Haiku betreiben?
Die kurze Antwort: Ja. Das Modell eines Subagenten wird unabhängig von der Hauptsitzung festgelegt, und Sie können es über eine Angabe beim Aufruf, über model in der Definitionsdatei oder über eine Umgebungsvariable ändern. Auch den Aufwand können Sie für jeden Subagenten auf einen eigenen Wert setzen.
In diesem Artikel ordne ich zunächst ein, was die offizielle Dokumentation mit Stand 15. September 2026 beschreibt, und zeige dann, was passierte, als ich Subagenten tatsächlich mit anderen Modellen gestartet und die Gesprächsprotokolle geprüft habe. Dieselbe Übersetzung habe ich Opus 5, Sonnet 5 und Haiku 4.5 je zweimal gegeben und Zeit, Kosten und Übersetzungsqualität verglichen.
Das Modell eines Subagenten ist der erste Treffer, von oben nach unten geprüft
Trifft nichts zu, läuft er mit dem Modell der Hauptsitzung (des Hauptgesprächs)
model, das Claude beim Starten des Subagenten mitgibtmodel in der Definitionsdatei: inherit bedeutet dasselbe Modell wie die HauptsitzungCLAUDE_CODE_SUBAGENT_MODEL: der Standard, wenn nichts anderes das Modell festgelegt hatQuelle: Claude Code Dokumentation, „Create custom subagents“ (Choose a model). Vor v2.1.251 stand Punkt 3 ganz oben
1. Was möglich ist: Subagenten mit anderem Modell und anderem Aufwand
Ein Subagent ist ein Helfer mit eigenem, getrenntem Kontext, den Claude Code startet, um einen Teil der Arbeit abzugeben. Er teilt den Gesprächsverlauf nicht mit der Hauptsitzung und gibt nach getaner Arbeit nur sein Ergebnis an sie zurück (den Unterschied zwischen Subagenten und Agent Teams behandelt Claude Code: Subagents vs. Agent Teams).
Für Subagenten lassen sich laut offizieller Dokumentation die folgenden zwei Dinge separat festlegen.
Modell (model)
sonnet, opus, haiku, fable, eine vollständige Modell-ID oder inherit
Eine vollständige Modell-ID sieht aus wie claude-opus-5. inherit bedeutet dasselbe Modell wie die Hauptsitzung. Ohne Angabe entscheidet die Reihenfolge oben.
Aufwand (effort)
low, medium, high, xhigh, max
Ohne Angabe übernimmt der Subagent den Aufwand der Hauptsitzung. Welche Stufen verfügbar sind, hängt vom Modell ab; Haiku 4.5 unterstützt den Aufwand nicht. Ist die Umgebungsvariable CLAUDE_CODE_EFFORT_LEVEL gesetzt, hat sie Vorrang.
Eine Kombination wie „Hauptsitzung mit Opus 5 bei Aufwand high, Übersetzer mit Sonnet 5 bei Aufwand medium“ lässt sich also direkt im Rahmen der offiziellen Spezifikation umsetzen. Was der Aufwand selbst bedeutet, erklärt Claude Code: die Aufwandseinstellung erklärt (Schneller ↔ Intelligenter).
Quelle: Claude Code Dokumentation, „Create custom subagents“ (Supported frontmatter fields), ebenda, „Model configuration“ (Vorrang beim Aufwand)
2. In welcher Reihenfolge das Modell festgelegt wird
Wie die Grafik am Anfang zeigt, ist das Modell eines Subagenten der erste Treffer in dieser Reihenfolge: „Angabe beim Aufruf“ → „model in der Definitionsdatei“ → „Umgebungsvariable CLAUDE_CODE_SUBAGENT_MODEL“ → „Modell der Hauptsitzung“. Auf drei Punkte sollten Sie achten.
Erstens: Die Reihenfolge hängt von der Version ab. Vor v2.1.251 stand die Umgebungsvariable ganz oben und überschrieb sogar die Angabe beim Aufruf und model in der Definitionsdatei (einschließlich inherit). Wenn Sie model: sonnet in eine Definition geschrieben haben und es scheinbar nicht wirkt, prüfen Sie zuerst Ihre Version und Ihre Umgebungsvariablen.
Zweitens: Um alles auf ein einziges Modell festzulegen, gibt es eine eigene Einstellung. Die Umgebungsvariable allein wirkt nicht auf Subagenten, deren Definitionsdatei model angibt. Wollen Sie alle erzwingen, setzen Sie zusätzlich zu CLAUDE_CODE_SUBAGENT_MODEL auch CLAUDE_CODE_SUBAGENT_MODEL_FORCE auf 1 (ab v2.1.257).
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
}
}
Beim Erzwingen wird model in den Definitionsdateien ignoriert, auch bei den eingebauten Explore und Plan, und Claude kann beim Aufruf kein Modell mehr angeben. Es gibt zwei Ausnahmen, die beim Modell der Hauptsitzung bleiben: ein Fork, der das gesamte Gespräch übernimmt, und ein Skill mit model: inherit, der in einem Subagenten läuft.
Drittens: Wohin sonnet und opus zeigen, hängt vom Anbieter ab. Auch wenn Sie dasselbe sonnet schreiben, erhalten Sie je nach Anbieter ein anderes Modell.
| Anbieter | opus | sonnet |
|---|---|---|
| Anthropic API | Opus 5 | Sonnet 5 |
| Claude Platform on AWS | Opus 5 | Sonnet 4.6 |
| Amazon Bedrock, Agent Platform von Google Cloud | Opus 5 | Sonnet 4.5 |
| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |
Quelle: Claude Code Dokumentation, „Model configuration“ (Tabelle mit Stand 15. September 2026). Um eine bestimmte Version festzulegen, schreiben Sie statt eines Alias die vollständige Modell-ID
Beschränken die verwalteten Einstellungen Ihrer Organisation die verfügbaren Modelle (availableModels), gilt das auch für model von Subagenten und für die Umgebungsvariable.
3. So richten Sie es ein (fünf Wege)
1. In eine Definitionsdatei schreiben (für Rollen, die immer dasselbe Modell nutzen sollen)
Am praktischsten ist eine Definitionsdatei pro Rolle. Legen Sie sie im Projekt unter .claude/agents/ ab, können Sie sie über git teilen; für alle Ihre Projekte gehört sie nach ~/.claude/agents/.
---
name: translator
description: Übersetzt japanische Artikel ins Englische. Verwenden, wenn eine Übersetzung angefragt wird
model: sonnet
effort: medium
tools: Read, Write, Grep
---
Sie sind Übersetzer für technische Artikel. Ändern Sie keine HTML-Tags und -Attribute,
sondern übertragen Sie nur den sichtbaren Text in natürliches Englisch.
Gibt es mehrere Definitionen mit demselben Namen, gilt diese Rangfolge: verwaltete Einstellungen der Organisation, --agents beim Start, Projekt, Benutzer, Plugins. Seit v2.1.198 öffnet der Befehl /agents keinen Erstellungsdialog mehr; bitten Sie also Claude, die Datei anzulegen, oder schreiben Sie sie selbst.
2. Beim Aufruf angeben (nur für diesen einen Fall)
Auch ohne Definition kann Claude beim Starten eines Subagenten ein Modell mitgeben. Bitten Sie im Gespräch etwa „Überlass diese Prüfung einem Haiku-Subagenten“, startet Claude den Subagenten mit diesem Modell im Aufruf. Diese Angabe hat Vorrang vor der Definitionsdatei. Ob sie wirklich mitgegeben wurde, prüfen Sie mit der Methode aus Abschnitt 5.
3. Einen Standard per Umgebungsvariable festlegen (alles ohne Modellangabe auf einmal ändern)
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "sonnet"
}
}
Unter env in settings.json eingetragen, wirkt sie auf Subagenten, deren Modell nicht auf anderem Weg festgelegt wurde. Laut offizieller Dokumentation gilt das auch für Mitglieder von Agent Teams und für Agenten in Workflows. Das Modell der eingebauten Explore und Plan ändert sich dadurch allein allerdings nicht (Abschnitt 4).
4. Beim Start mit --agents übergeben (nur für diese Sitzung)
claude --agents '{
"translator": {
"description": "Translates Japanese articles into English.",
"prompt": "You are a technical translator. Keep all HTML tags.",
"model": "sonnet",
"effort": "medium"
}
}'
Nichts wird in einer Datei gespeichert; die Definition gilt nur für die Dauer dieser Sitzung.
5. Im Claude Agent SDK definieren
from claude_agent_sdk import ClaudeAgentOptions, AgentDefinition
options = ClaudeAgentOptions(
agents={
"translator": AgentDefinition(
description="Translates Japanese articles into English.",
prompt="You are a technical translator. Keep all HTML tags.",
tools=["Read", "Write"],
model="sonnet",
effort="medium",
),
}
)
Auch in AgentDefinition des SDK akzeptiert model einen Alias, inherit oder eine vollständige Modell-ID. Ohne Angabe entscheidet die Reihenfolge oben. Die offizielle Dokumentation merkt zudem an, dass Opus 5 Arbeit bereitwilliger an Subagenten verteilt als frühere Modelle, und verweist auf Einstellungen, mit denen Sie die Zahl gleichzeitig laufender Subagenten (Standard 20) und die ausgegebenen Beträge begrenzen.
Quelle: Claude Code Dokumentation, „Create custom subagents“ (Speicherorte und Rangfolge, --agents, Änderung an /agents, Umgebungsvariablen), ebenda, „Model configuration“ (Geltungsbereich von CLAUDE_CODE_SUBAGENT_MODEL), ebenda, „Subagents in the SDK“ (AgentDefinition, Begrenzungen)
4. Mit welchem Modell die eingebauten Subagenten laufen
Auch ohne eigene Definitionen bringt Claude Code von Haus aus mehrere Subagenten mit. Ihre Modelle sehen so aus.
| Name | Modell | Hinweis |
|---|---|---|
| Explore | Übernimmt das Modell der Hauptsitzung. Über die Claude API höchstens Opus | Nur lesend. Liest weder CLAUDE.md noch den git-Status |
| Plan | Übernimmt das Modell der Hauptsitzung | Wird im Planmodus genutzt. Nur lesend. Liest weder CLAUDE.md noch den git-Status |
| general-purpose | Ohne Angabe beim Aufruf das Modell aus der Umgebungsvariable, fehlt auch diese, das der Hauptsitzung | Kann sowohl recherchieren als auch ändern |
| claude-code-guide | Haiku | Bei Fragen zu Funktionen von Claude Code |
| claude | Hat kein eigenes Modell; festgelegt durch die Reihenfolge aus Abschnitt 2 | Allzweck-Helfer, wenn keine andere Rolle passt |
| statusline-setup | Sonnet | Beim Ausführen von /statusline |
Quelle: Claude Code Dokumentation, „Create custom subagents“ (Built-in subagents, Stand 15. September 2026)
Seit v2.1.198 läuft Explore nicht mehr immer mit Haiku. Er übernimmt das Modell der Hauptsitzung, über die Claude API höchstens Opus. Läuft die Hauptsitzung mit einem höheren Modell wie Fable, arbeitet Explore mit Opus; läuft sie mit Sonnet oder Haiku, nutzt Explore dieses Modell. Um wieder Haiku zu verwenden, empfiehlt die offizielle Dokumentation, eine Definitionsdatei namens Explore mit model: haiku anzulegen (Ihre eigene Definition hat Vorrang vor dem gleichnamigen eingebauten Subagenten).
Wollen Sie das Modell von Explore und Plan per Umgebungsvariable ändern, müssen Sie zusätzlich CLAUDE_CODE_SUBAGENT_MODEL_FORCE aus Abschnitt 2 setzen.
5. Messung 1: Lief es wirklich mit diesem Modell?
Ob sich alles wie dokumentiert verhält, habe ich in meiner eigenen Umgebung geprüft (Hauptsitzung mit Opus 5, Aufwand high). Dem eingebauten general-purpose gab ich dieselbe kleine Aufgabe, „die README lesen und in drei Zeilen zusammenfassen“, in drei Varianten: mit Modell sonnet, mit Modell haiku und ohne Modellangabe.
Es gibt zwei Wege, das zu prüfen. Während der Subagent läuft, zeigt die Liste in /tasks sein Modell an (so steht es in der offiziellen Dokumentation). Nach dem Ende sehen Sie in den lokalen Gesprächsprotokollen in den Dateien agent-*.jsonl im Ordner subagents/ bei jeder Antwort nach message.model. Wo die Protokolle liegen und wie man sie liest, behandelt Claude Code: Verbrauch pro Sitzung messen ausführlich.
| Angabe beim Aufruf | Im Protokoll festgehaltenes Modell |
|---|---|
sonnet | claude-sonnet-5 |
haiku | claude-haiku-4-5-20251001 |
| Keine Angabe | claude-opus-5 (wie die Hauptsitzung) |
Quelle: eigene Messung (15. September 2026, Desktop-App unter Windows. Bei jeder Antwort jedes Subagenten war dasselbe Modell festgehalten)
Jeder Subagent lief mit dem angegebenen Modell, und der ohne Angabe übernahm das Modell der Hauptsitzung. In der Datei agent-*.meta.json im selben Ordner steht der angegebene Wert, etwa "model": "sonnet", nur dann, wenn ein Modell angegeben wurde.
6. Messung 2: Zehntausende Tokens allein für den Start
Aus denselben Protokollen ergab sich noch etwas. Ein Subagent liest schon in seiner allerersten Antwort, bevor er mit der Arbeit beginnt, Zehntausende Tokens ein. Denn zuerst werden sein eigener System-Prompt, die Tool-Definitionen, CLAUDE.md und Ähnliches geladen.
| Modell | Start ohne Cache (Cache-Schreiben) | Dasselbe Modell etwa 1 Minute später gestartet (Lesen / Schreiben) |
|---|---|---|
| Sonnet 5 | 83.007 | 44.846 / 38.385 |
| Haiku 4.5 | 65.958 | 34.008 / 32.122 |
| Opus 5 | 77.235 | 39.159 / 38.298 |
Quelle: eigene Messung (15. September 2026. Token-Zahlen der ersten Antwort jedes Subagenten. Alle Schreibvorgänge gingen in den 5-Minuten-Cache)
Aus diesen Zahlen lassen sich drei Dinge ablesen.
Erstens: Subagenten mit demselben Modell lesen den gemeinsamen Anfang aus dem Cache. Beim zweiten Start wurden bei Sonnet 5 rund 45.000 Tokens als Cache-Lesen abgerechnet (das 0,1-Fache des Eingabepreises). Auch die offizielle Dokumentation schreibt, dass Anfragen mit demselben Modell und demselben Anfang den Cache teilen. Umgekehrt ist der Cache pro Modell getrennt, und Subagenten lesen auch den Cache der Hauptsitzung nicht (weil der Anfang einen anderen Inhalt hat).
Zweitens: Auch im Abonnement läuft der Cache von Subagenten nach 5 Minuten ab. Laut offizieller Dokumentation gilt bei Nutzung im Rahmen eines Tarifs für das Hauptgespräch 1 Stunde, für Subagenten aber 5 Minuten. Starten Sie den nächsten Subagenten erst nach mehr als 5 Minuten, beginnt er wieder mit einem Schreibvorgang. Für 1 Stunde setzen Sie die Einstellung subagentPromptCacheTtl oder die Umgebungsvariable CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL auf 1h (ab v2.1.242). Wollen Sie das pro Subagent festlegen, tragen Sie in der Definitionsdatei unter experimental den Schlüssel cacheTtl ein (ab v2.1.248; solange ein Claude-Abonnement zusätzliches Nutzungsguthaben (usage credits) verbraucht, wird ein dort gesetztes 1h ignoriert). Beim 1-Stunden-Cache kostet das Schreiben das 2-Fache des Eingabepreises (beim 5-Minuten-Cache das 1,25-Fache).
Drittens: Haiku 4.5 weist für denselben Text weniger Tokens aus. Laut der offiziellen Preisseite verwenden Modelle ab Claude 4.7 einen neuen Tokenizer, der für denselben Text etwa 30 % mehr Tokens zählt. Haiku 4.5 stammt aus einer Generation vor 4.7 und wird nicht unter den Modellen mit dem neuen Tokenizer aufgeführt. Vergleicht man die Zahlen der Tabelle direkt, wirkt Haiku leichter, als es tatsächlich ist.
Worauf Sie bei diesen Zahlen achten sollten
- Mein Projekt hat eine große CLAUDE.md (etwa 57.000 Bytes), deshalb fallen die Werte höher aus als in einem typischen Projekt. Die Größe der CLAUDE.md kommt direkt bei jedem einzelnen Subagenten zum Eingelesenen hinzu
- Mit
omitClaudeMd: truein der Definitionsdatei lädt dieser Subagent die CLAUDE.md-Dateien auf Benutzer-, Projekt- und lokaler Ebene nicht (die Dateien der verwalteten Richtlinien der Organisation werden weiterhin geladen; ab v2.1.271). Die eingebauten Explore und Plan lesen sie ohnehin nicht - 🟡 Wie sich die beim Start gelesenen Tokens aufschlüsseln, ist nicht offiziell veröffentlicht. Angegeben sind hier die Summen aus meiner Umgebung
Verteilen Sie kleine Aufgaben auf viele Subagenten, fallen diese „Kosten allein für den Start“ bei jedem einzelnen an. Übergeben Sie die Arbeit einem günstigeren Modell, wird nicht nur die Arbeit selbst billiger, sondern auch dieser Anteil.
Quelle: Claude Code Dokumentation, „How Claude Code uses prompt caching“ (Cache pro Modell, Subagenten und Cache, Lebensdauer des Cache), Claude Platform Docs, „Pricing“ (Tokenizer, Cache-Faktoren), Claude Code Dokumentation, „Create custom subagents“ (omitClaudeMd)
7. Messung 3: Dieselbe Übersetzung, je zweimal mit drei Modellen
Die Idee vom Anfang, „nur die Übersetzung auf ein günstigeres Modell verlagern“, habe ich tatsächlich ausprobiert. Aus der japanischen Fassung eines Artikels dieser Website wählte ich einen Abschnitt (6.265 Zeichen HTML, mit einer Tabelle, Kennzahlenkarten und Code-Schnipseln) und gab jedem Modell mit identischer Anweisung die Aufgabe, ihn ins Englische zu übersetzen, ohne die Tag-Struktur zu verändern, je zweimal, insgesamt also sechs Durchläufe. Opus 5 und Sonnet 5 liefen mit dem von der Hauptsitzung übernommenen Aufwand high (Haiku 4.5 unterstützt den Aufwand nicht).
| Modell | Benötigte Zeit (1. Lauf / 2. Lauf) | Anzahl der Tags | 49 Zahlenwerte | Kosten (Eingabe und Cache) |
|---|---|---|---|---|
| Opus 5 | 46 s / 45 s | Beide Male identisch mit dem Original | Beide Male vollständig | 0,46 $ / 0,46 $ |
| Sonnet 5 | 39 s / 74 s | Beide Male identisch mit dem Original | Beide Male vollständig | 0,23 $ / 0,25 $ |
| Haiku 4.5 | 99 s / 94 s | Im 1. Lauf fehlte ein <strong> | Beide Male vollständig | 0,10 $ / 0,10 $ |
Quelle: eigene Messung (15. September 2026. Kosten zum Listenpreis, berechnet aus den Token-Zahlen der Gesprächsprotokolle multipliziert mit den offiziellen Preisen. Die Ausgabe ist nicht enthalten, siehe Hinweis unten)
Die Ausgabe fehlt in der Kostenspalte, weil die Ausgabe-Tokens in den Protokollen nicht verlässlich waren. In einem Fall war eine Antwort, die eine Übersetzung von etwa 8.800 Zeichen in eine Datei schrieb, mit 18 Ausgabe-Tokens verzeichnet. Der Ausgabepreis pro Million Tokens beträgt 25 $ für Opus 5, 10 $ für Sonnet 5 und 5 $ für Haiku 4.5, und alle englischen Übersetzungen umfassten etwa 8.500 bis 8.900 Zeichen.
Die Übersetzungsqualität habe ich selbst geprüft, indem ich jede Fassung Satz für Satz mit dem japanischen Original verglichen habe.
- In keinem der sechs Durchläufe fand ich einen inhaltlichen Übersetzungsfehler. Zahlen, Tabellen und interne Links blieben korrekt erhalten. Allerdings gehört ein Text mit vielen Zahlen und Aufzählungen zu den leichter übersetzbaren
- Unterschiede zeigten sich bei Lesbarkeit und einheitlicher Schreibweise. Haiku 4.5 mischte im 1. Lauf für die erste Person „my“ und „the author's“ und lieferte im 2. Lauf eine hölzerne Wortstellung wie „G from 9th rises to 6th“. Sonnet 5 schrieb natürliches Englisch, schrieb „subagent“ aber im 1. Lauf als „Sub-agent“ und im 2. Lauf als „Subagent“, die Schreibweise schwankte also von Lauf zu Lauf. Opus 5 blieb beide Male bei einheitlichen Begriffen
- Am längsten brauchte das günstigste Modell, Haiku 4.5. Bei Sonnet 5 lagen die beiden Läufe zeitlich fast um den Faktor zwei auseinander. Bei so wenigen Durchläufen sollten Sie die Rangfolge der Geschwindigkeit nur als groben Anhaltspunkt verstehen
Was dieser Vergleich nicht zeigt
- Es wurde nur ein Abschnitt je zweimal übersetzt. Bei langen Artikeln, Sprachen mit stark abweichender Wortstellung, Sprachen, die wie Arabisch von rechts nach links geschrieben werden, oder Texten mit vielen Fachbegriffen könnte der Abstand größer werden
- Die Fähigkeit, Fehler im Original zu bemerken, habe ich nicht gemessen. Auf dieser Website hat ein Opus-Subagent, dem ich eine Übersetzung übergeben hatte, schon auf sachliche Fehler im japanischen Original hingewiesen (etwa eine falsch angegebene Zeichenobergrenze pro Tarif). Wie stark sich solche Hinweise zwischen Modellen unterscheiden, liegt außerhalb dieses Experiments
8. Auswirkung auf Kosten und Nutzungslimits
Wie viel es bringt, Subagenten auf ein günstigeres Modell zu verlagern, hängt davon ab, ob Sie die API nutzungsbasiert bezahlen oder ein Abonnement wie Pro oder Max nutzen.
Nutzungsbasierte API: Das Preisverhältnis wirkt direkt
| Modell | Eingabe | Ausgabe | Cache-Schreiben (5 Minuten) | Cache-Lesen |
|---|---|---|---|---|
| Claude Opus 5 | 5 $ | 25 $ | 6,25 $ | 0,50 $ |
| Claude Sonnet 5 | 2 $ | 10 $ | 2,50 $ | 0,20 $ |
| Claude Haiku 4.5 | 1 $ | 5 $ | 1,25 $ | 0,10 $ |
Quelle: Claude Platform Docs, „Pricing“ (pro Million Tokens, Stand 15. September 2026. Der Einführungspreis von Sonnet 5 wurde zum regulären Preis)
Sonnet 5 kostet pro Token zwei Fünftel von Opus 5, Haiku 4.5 ein Fünftel. In der Messung aus Abschnitt 7 lagen die Kosten für Eingabe und Cache bei Sonnet 5 bei etwa der Hälfte von Opus 5 und bei Haiku 4.5 bei etwa einem Fünftel. Während Haiku 4.5 nahe am Preisverhältnis liegt, fällt Sonnet 5 höher aus als das Preisverhältnis (zwei Fünftel). Der Grund: Die Zahl der Antworten und die pro Antwort eingelesene Menge unterschieden sich je nach Modell (Sonnet 5 kam auf 4 und 6 Antworten, Opus 5 beide Male auf 4; bei Haiku 4.5 spielt zusätzlich der andere Tokenizer mit hinein).
Abonnement: Manche Limits kommen durch einen Modellwechsel nicht zurück
Bei Pro und Max gelten das Sitzungslimit und das Wochenlimit für alle Modelle gemeinsam. Sind sie aufgebraucht, können Sie auch nach einem Modellwechsel mit /model nicht weiterarbeiten. Daneben gibt es Limits pro Modellfamilie wie ein „Opus-Limit“ und ein „Sonnet-Limit“; nur wenn Sie eines davon erreichen, können Sie mit einem Modell außerhalb dieser Familie weitermachen.
🟡 Wie viel länger die Limits Ihres Tarifs reichen, wenn Subagenten mit Sonnet oder Haiku laufen, ist nicht veröffentlicht. Das Preisverhältnis der API taugt als Anhaltspunkt, aber nirgends steht, dass die Limits genau in diesem Verhältnis schrumpfen. Welche Subagenten am meisten verbrauchen, sehen Sie in der Tarif-Aufschlüsselung von /usage (Anteile nach Skill, Subagent, Plugin und MCP-Server).
Quelle: Claude Code Dokumentation, „Error reference“ (You've hit your session limit: gemeinsame Limits für alle Modelle und Limits pro Modellfamilie), ebenda, „Manage costs effectively“ (Tarif-Aufschlüsselung in /usage)
9. Welche Arbeit Sie auf ein günstigeres Modell verlagern
Als Richtwert nennt die offizielle Dokumentation: Die meisten Programmieraufgaben erledigt Sonnet gut und günstiger als Opus, Opus sollten Sie sich für komplexe Architekturentscheidungen und mehrstufiges Schlussfolgern aufheben, und für einfache Subagenten-Aufgaben geben Sie in der Definitionsdatei model: haiku an. Auch für Mitglieder von Agent Teams wird Sonnet empfohlen.
Darauf aufbauend nenne ich drei Entscheidungshilfen aus der Messung in Abschnitt 7 und aus dem Betrieb dieser Website.
Leicht zu verlagern
Arbeit, deren Ergebnis sich maschinell prüfen lässt
Umwandlung in ein festes Format, Dateien suchen und lesen, umfangreiche Routineprüfungen. Auch das fehlende <strong> aus Abschnitt 7 fiel auf, weil die Tags maschinell gezählt wurden.
Nur mit Prüfung verlagern
Arbeit, bei der Lesbarkeit und einheitliche Schreibweise zählen
Etwa Übersetzungen, bei denen der Inhalt stimmt, die Schreibweise aber leicht schwankt. Dafür brauchen Sie Vorkehrungen, etwa eine Begriffsliste in der Anweisung oder einen nachgelagerten Schritt, der die Schreibweise vereinheitlicht.
Besser nicht verlagern
Arbeit, die Urteilsvermögen oder das Bemerken von Ungereimtheiten verlangt
Arbeit, bei der Fehler im Original oder im Entwurf auffallen sollen, oder deren Ergebnis sich maschinell schwer prüfen lässt. Diese Fähigkeit kann sich zwischen Modellen unterscheiden und wurde in diesem Experiment nicht gemessen.
Im Zweifel ist der sichere Weg, eine Ihrer üblichen Aufgaben einem günstigeren Modell zu geben und das Ergebnis neben das Ihres aktuellen Modells zu legen. Dafür ändern Sie nur eine Zeile, model in der Definitionsdatei, und wenn es nicht passt, stellen Sie sofort wieder um. Wollen Sie nicht das Modell eines Subagenten, sondern das der Hauptsitzung aufteilen, also Opus nur zum Planen und Sonnet zum Implementieren, erledigt das opusplan; siehe Was ist opusplan in Claude Code?
FAQ
F1. Ändert sich auch der Subagent, wenn ich mitten im Gespräch das Modell der Hauptsitzung mit /model wechsle?
Subagenten, deren Modell durch die Angabe beim Aufruf, durch model in der Definitionsdatei (außer inherit) oder durch die Umgebungsvariable festgelegt ist, ändern sich nicht. Subagenten ohne jede dieser Angaben und solche mit inherit in der Definitionsdatei folgen dem Modell der Hauptsitzung. Beachten Sie: Wechseln Sie das Modell der Hauptsitzung, muss deren Cache neu aufgebaut werden.
F2. Kann ich das Modell beibehalten und nur den Aufwand senken?
Ja. Schreiben Sie etwa effort: medium in die Definitionsdatei, gilt dieser Aufwand nur, solange dieser Subagent läuft. Ist allerdings die Umgebungsvariable CLAUDE_CODE_EFFORT_LEVEL gesetzt, hat sie Vorrang.
F3. Welches Modell erhalte ich auf Amazon Bedrock mit model: sonnet?
Laut offizieller Dokumentation mit Stand 15. September 2026 ist es Sonnet 4.5. Über die Anthropic API ist es Sonnet 5; dieselbe Definitionsdatei führt je nach Anbieter also zu unterschiedlichen Ergebnissen. Um eine Version festzulegen, schreiben Sie die vollständige Modell-ID.
F4. Lohnt es sich, den Cache von Subagenten auf 1 Stunde zu stellen?
Das hängt von Ihrer Arbeitsweise ab. Starten Sie dieselbe Art von Subagent immer wieder mit Pausen von mehr als 5 Minuten, sparen Sie wiederholte Schreibvorgänge. Andererseits kostet das Schreiben beim 1-Stunden-Cache das 2-Fache des Eingabepreises (beim 5-Minuten-Cache das 1,25-Fache); lassen Sie Subagenten nur kurz hintereinander laufen, ist der 5-Minuten-Cache günstiger. Die Einstellungen für einen 1-Stunden-Cache und ihre Bedingungen fasst Abschnitt 6 zusammen.
F5. Ich habe ein Modell angegeben, aber es scheint nicht zu wirken.
Prüfen Sie der Reihe nach: (1) ob CLAUDE_CODE_SUBAGENT_MODEL_FORCE aktiv ist (dann wird die Angabe in der Definitionsdatei ignoriert), (2) ob Sie eine Version vor v2.1.251 mit gesetzter Umgebungsvariable nutzen, (3) ob die verwalteten Einstellungen Ihrer Organisation dieses Modell zulassen. Mit welchem Modell der Subagent tatsächlich lief, sehen Sie während der Ausführung in /tasks und danach über message.model in den Gesprächsprotokollen.
Quellen
- Claude Code Docs — Create custom subagents (Felder der Definitionsdatei, Reihenfolge der Modellwahl und Unterschiede zwischen Versionen,
CLAUDE_CODE_SUBAGENT_MODEL_FORCE, eingebaute Subagenten, Speicherorte und Rangfolge,--agents,omitClaudeMd, Prüfung in/tasks) - Claude Code Docs — Model configuration (wohin Aliasse zeigen, Geltungsbereich von
CLAUDE_CODE_SUBAGENT_MODEL, Vorrang beim Aufwand,availableModels) - Claude Code Docs — How Claude Code uses prompt caching (Cache pro Modell, Lebensdauer bei Subagenten,
subagentPromptCacheTtlsowie Festlegung per Umgebungsvariable und Definitionsdatei) - Claude Code Docs — Manage costs effectively (Richtwerte zur Modellwahl, Empfehlung von Sonnet für Mitglieder von Agent Teams, Aufschlüsselung in
/usage) - Claude Code Docs — Error reference (gemeinsame Limits für alle Modelle und Limits pro Modellfamilie)
- Claude Code Docs — Subagents in the SDK (
modelundeffortinAgentDefinition, Opus 5 und Begrenzungen) - Claude Code Docs — Orchestrate teams of Claude Code sessions (wie das Modell von Mitgliedern eines Agent Teams festgelegt wird)
- Claude Platform Docs — Pricing (Preise pro Modell, Cache-Faktoren, Tokenizer)
Verwandte Artikel
- Claude Code: Subagents vs. Agent Teams — was ein Subagent ist
- Claude Code: die Aufwandseinstellung erklärt (Schneller ↔ Intelligenter) — was der Aufwand bedeutet
- Claude Code: Verbrauch pro Sitzung messen — wie man Gesprächsprotokolle liest
- Claude Code: Was frisst eigentlich Ihren Kontext? — warum CLAUDE.md jedes Mal gelesen wird
- Was ist opusplan in Claude Code? — die Hauptsitzung nur im Planmodus mit Opus betreiben
- 10 Claude Code Token-Spar-Tipps und Zusatzkosten — wo Sie sonst noch sparen können