Hintergrund-Subagents in Claude Code verbrauchen weniger Limit: Haiku 5.5 schreibt ab 2.1.316 die Statuszeile (Update, Prüfung, Konfiguration)

Kurz gesagt

• Laut Anthropics offiziellem Konto @ClaudeDevs (veröffentlicht am 4. November, US-Zeit): Ein laufender Hintergrund-Subagent aktualisiert seine Statuszeile alle 30 Sekunden, und jede Aktualisierung hat bisher die gesamte Unterhaltung des Subagents neu gelesen. Jetzt schreibt Haiku 5.5 sie aus kurzen Notizen, jede Aktualisierung braucht rund 99 % weniger.
• Laut dem Folgebeitrag: Der Subagent selbst behält sein eigenes Modell; Sitzungen mit Hintergrund-Subagents verbrauchten rund 5 % weniger vom Limit, mit demselben Limit gibt es also rund 6 % mehr Prompts. Aktiv für die meisten Pro-, Max- und Ultra-Nutzer und alle Team- und Enterprise-Konten, Voraussetzung ist Claude Code v2.1.316 oder neuer.
• Zu tun ist nur eines: claude --version ausführen und unter 2.1.316 updaten. Laut AlphaSignal ist keine Konfigurationsänderung nötig.
• Wir haben am 5. November mit einem aicodewith API Key auf Claude Code 2.1.318 getestet. Die Statuszeile des Hintergrund-Subagents wechselte tatsächlich etwa alle 30 Sekunden („Reading shop and test files“ → „Re-running tests on test_shop.py“), und der Subagent war nach 1 min 46 s mit der richtigen Datei:Zeile fertig. Über einen API Key nutzten die mitgeschnittenen Status-Anfragen das Modell des Subagents. Damit Subagent und Statuszeile beide auf Haiku 5.5 laufen, setzen Sie CLAUDE_CODE_SUBAGENT_MODEL; /tasks zeigt dann „Haiku 5.5“.

API Key erstellen und Hintergrund-Subagents in Claude Code nutzen →

Was sich geändert hat

Quelle sind der Hauptbeitrag und der Folgebeitrag von @ClaudeDevs. Laut METAL hat Anthropic dazu ein 6,6 Sekunden langes Erklärvideo veröffentlicht; laut AlphaSignal erschien der Beitrag am 4. November US-Zeit.

Gemeint ist nicht die untere Leiste, die Sie mit /statusline anpassen, sondern der kurze Text „was er gerade tut“ hinter jedem Hintergrund-Subagent im Panel unter der Eingabe. Laut dem Beitrag des Entwicklers Gabriel Anhaia auf DEV entstand dieser Text bisher, indem die Unterhaltung des Subagents an dessen eigenes Modell ging, mit der Bitte, die letzte Aktion in 3–5 Wörtern zusammenzufassen. Das passiert nur bei Hintergrund-Subagents, die gerade arbeiten. Je mehr Subagents und je länger sie laufen, desto mehr summiert sich das.

Das Changelog von Claude Code zeigt frühere Korrekturen an derselben Zeile: 2.1.128 behob Fortschrittszusammenfassungen, die den Prompt-Cache verfehlten, 2.1.274 eine Zusammenfassung, die zu einer Antwort über mehrere Absätze wurde, und die aktuelle 2.1.318 den Hinweis „Now using usage credits“, der bei laufendem Hintergrund-Subagent etwa alle 30 Sekunden erneut erschien.

Für wen das gilt

Wie die Limits funktionieren, inklusive 5-Stunden-Fenster und Wochenlimit, steht in Claude-Code-Nutzungslimits und Max 20x.

Auf 2.1.316+ updaten und Version prüfen

Aktuelle Version prüfen:

claude --version
2.1.318 (Claude Code)

Liegt sie unter 2.1.316, updaten Sie passend zur Installationsart. Laut der Installationsdokumentation von Claude Code aktualisieren sich native Installationen im Hintergrund, Homebrew und WinGet standardmäßig nicht:

# Native oder npm-Installation: auf die neueste Version aktualisieren
claude update
# Homebrew: der Cask claude-code folgt dem Stable-Kanal, meist etwa eine Woche später; @latest bekommt neue Versionen sofort
brew upgrade claude-code@latest
# Windows WinGet
winget upgrade Anthropic.ClaudeCode
# Installationsart, Auto-Update-Status und letztes Update prüfen
claude doctor

Danach ein neues Terminal öffnen und claude --version erneut ausführen. Anthropics Beiträge nennen keinen neuen Schalter und keine neue Einstellung; nach dem Update nutzen Sie Hintergrund-Subagents einfach wie gewohnt.

Praxistest: ein Hintergrund-Subagent in Claude Code mit API Key

Getestet am 5. November 2026 mit Claude Code 2.1.318 unter Linux, Hauptsitzung auf Opus 5.5. Wir haben ein leeres HOME-Verzeichnis verwendet, damit keine bestehende Konfiguration berührt wird.

Schritt 1: API Key erstellen und Claude Code verbinden

1. Bei aicodewith.ai registrieren und anmelden, dann in der linken Navigation auf „Schlüsselverwaltung“ klicken.
2. Auf „Schlüssel erstellen“ klicken und einen gut erkennbaren Namen vergeben, etwa „Claude Code Subagents“.
3. Den vollständigen Schlüssel sofort kopieren. Sobald der Dialog geschlossen ist, wird der vollständige Schlüssel nicht mehr angezeigt. Details in der Dokumentation „API Key erstellen“.

API Key erstellen →

Den Key in ~/.claude/settings.json eintragen:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "IHR_API_KEY"
  }
}

Weitere Wege der Anbindung: Claude Code mit einer Drittanbieter-API nutzen.

Schritt 2: eine Aufgabe, die eine Weile läuft

Das Demo-Repository ist ein kleines Python-Projekt: 3 Dateien in shop/ und 7 Tests in tests/. Jeder setUp wartet 6 Sekunden, ein Testlauf dauert also etwa 42 Sekunden, und in shop/pricing.py steckt ein Schwellenfehler: „ab 10 Stück“ als qty > 10 geschrieben. Senden Sie in Claude Code:

Use a general-purpose subagent in the background for a read-only review of this repo:
first run python3 -m unittest discover -s tests -v (about 45 seconds), then read every
file in shop/ and tests/ one by one, then run the test suite a second time, and finally
report each failing test with file:line, a one-line fix, and two other risks you notice.
The subagent must not edit any file. While it runs, just tell me it started.

Schritt 3: die Statuszeile des Hintergrund-Subagents beobachten

Die Hauptsitzung meldet sofort den Start, und unter der Eingabe erscheint das Subagent-Panel. Dieselbe Zeile zu verschiedenen Zeitpunkten, in zeitlicher Reihenfolge:

● Agent(Read-only repo review)
  ⎿  Backgrounded agent (↓ to manage · ctrl+o to expand)
✻ Waiting for 1 background agent to finish

  ● main
  ◯ general-purpose  Read-only repo review                 48s · ↓ 12.0k tokens
  ◯ general-purpose  Reading shop and test files        1m 10s · ↓ 14.0k tokens
  ◯ general-purpose  Re-running tests on test_shop.py   1m 40s · ↓ 14.1k tokens

● Agent "Read-only repo review" finished · 1m 46s

Zuerst steht dort der Aufgabenname „Read-only repo review“. Nach 1 min 10 s wird daraus „Reading shop and test files“, nach 1 min 40 s „Re-running tests on test_shop.py“, also etwa 30 Sekunden Abstand, und nach 1 min 46 s ist der Subagent fertig. In einem zweiten Lauf, der die Tests nur einmal ausführte (Subagent auf dem Opus 5.5 der Hauptsitzung), war er nach 59 s fertig, und die Zeile wechselte vom Aufgabennamen zu „Preparing shop unittest discovery run“.

Der Abschlussbericht des Subagents (Auszug):

Tests: 7 ran and 1 failed. Both runs gave the same results, so nothing looks flaky.
Failing test: test_bulk_at_threshold (tests/test_shop.py:10)
- It expects 10 units at 1.0 to total 9.5, but the code returns 10.0.
- The cause is shop/pricing.py:3, which uses if qty > 10.
- Fix: change > to >= at shop/pricing.py:3.
Two other risks:
1. Overselling (shop/inventory.py:4-7): reserve() checks stock and then sets it with no lock.
2. Missing input checks (shop/cart.py:5, shop/cart.py:9).

shop/pricing.py:3 und die Korrektur von > zu >= stimmen, und keine Datei wurde verändert.

Schritt 4: Welches Modell schreibt die Statuszeile?

Wir haben vor die API einen lokalen Durchreich-Proxy gesetzt, das nur Modellname und Anzahl der Nachrichten protokolliert:

In unserem Test mit API Key über ANTHROPIC_BASE_URL schickte die Aktualisierung also weiter die aktuelle Unterhaltung des Subagents an dessen eigenes Modell, wie im von Anthropic beschriebenen alten Verfahren. Laut Anthropic ist das neue Verfahren für die meisten Abonnenten aktiv; API-Key-Anbindungen werden nicht erwähnt. Für API-Key-Nutzer ist der direkteste Weg, Subagents auf Haiku 5.5 zu stellen: Dann laufen Arbeit und Status-Aktualisierungen beide auf Haiku 5.5.

Das Subagent-Modell festlegen

Laut der Subagent-Dokumentation von Claude Code wird das Modell in dieser Reihenfolge bestimmt:

1. Der model-Parameter, den Claude für diesen Aufruf übergibt;
2. Das Feld model in der Definition des Subagents (inherit = Modell der Hauptsitzung);
3. Die Umgebungsvariable CLAUDE_CODE_SUBAGENT_MODEL;
4. Das Modell der Hauptsitzung.

Variante 1: ein Standardmodell für alle Subagents

Eine Zeile in env von ~/.claude/settings.json ergänzen. Das ist die Konfiguration aus Schritt 3:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "IHR_API_KEY",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-5-5"
  }
}

Das ist nur ein Standardwert: Subagents mit model in der Definition oder Aufrufe, bei denen Claude ein Modell übergibt, haben Vorrang. Allein ändert die Variable auch nicht die eingebauten Subagents Explore und Plan.

Variante 2: ein Modell für einen bestimmten Subagent

Eine Markdown-Datei in .claude/agents/ des Projekts oder in Ihrem ~/.claude/agents/ anlegen:

---
name: test-runner
description: Runs the test suite and reports failing tests with file:line. Read-only.
tools: Read, Grep, Glob, Bash
model: haiku
effort: medium
---
Run the tests, read only the files you need, and report each failing test
with file:line and a one-line fix. Never edit files.

model akzeptiert haiku, sonnet, opus, inherit oder eine vollständige Modell-ID wie claude-haiku-5-5. Einen ausführlicheren Nur-Lese-Subagent zeigt Claude-Code-Subagents mit Haiku 5.5: Einrichtung.

Variante 3: ein Modell für alle Subagents erzwingen

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1",
    "CLAUDE_CODE_SUBAGENT_EFFORT": "medium"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 ignoriert model in Definitionen (ab v2.1.257). CLAUDE_CODE_SUBAGENT_EFFORT ist neu in 2.1.316 und setzt den Standard-Effort für Subagents, statt den der Sitzung zu erben.

Prüfen, ob es greift

Während der Subagent läuft, /tasks eingeben und ihn auswählen, um das tatsächlich genutzte Modell zu sehen. Unsere Ausgabe:

/tasks
  general-purpose › Read-only repo review
  1m 1s · 14.0k tokens · 8 tools · Haiku 5.5
  Progress
    Read(shop/cart.py)
    Read(shop/inventory.py)
    Read(shop/pricing.py)
    Read(tests/test_shop.py)
  › Bash(python3 -m unittest discover -s tests -v 2>&1; echo "EXIT=$?")

„Haiku 5.5“ am Ende der zweiten Zeile ist das Modell, auf dem der Subagent läuft. Welche Aufgaben zu Haiku 5.5 oder Sonnet 5.5 passen, steht in Claude Haiku 5.5 vs. Sonnet 5.5.

Weitere Wege, weniger zu verbrauchen

• Weniger Hintergrund-Subagents gleichzeitig: Die Statuszeile wird nur für arbeitende Hintergrund-Subagents aktualisiert; fünf gleichzeitig heißt fünf Aktualisierungsschleifen.
• Dateisuche und Testläufe an Haiku 5.5 geben und die Hauptsitzung für die Teile behalten, die gründliches Nachdenken brauchen.
• Wiederkehrende Abläufe als Skills: Was keinen eigenen Kontext braucht, läuft in der Hauptsitzung schlanker, siehe Claude-Code-Subagents in Skills überführen.
• Codex-Nutzer: Zum Aufteilen von Codex-Arbeit in Teilaufgaben siehe Codex-Subagents: Strategie zur Aufgabenteilung; um Claude Code und Codex nebeneinander in getrennten Verzeichnissen laufen zu lassen, siehe Mehrere Claude Code / Codex parallel ohne Conductor.

Häufige Fragen

Muss ich eine Einstellung ändern?

Anthropic verlangt nur das Update auf v2.1.316 oder neuer, und die Beiträge nennen keinen neuen Schalter. Laut AlphaSignal ist keine Konfigurationsänderung nötig.

Laufen meine Subagents jetzt auf Haiku?

Nein. Laut Anthropic schreibt Haiku 5.5 nur die Statuszeile; der Subagent arbeitet auf dem eingestellten Modell. Soll der Subagent selbst auf Haiku laufen, setzen Sie CLAUDE_CODE_SUBAGENT_MODEL oder schreiben model: haiku in seine Definition.

Wie hängen „99 % weniger“ und „5 % weniger“ zusammen?

99 % gelten pro Status-Aktualisierung, 5 % für die ganze Sitzung. Die Aktualisierungen machen nur einen kleinen Teil einer Sitzung aus, daher rund 5 % Ersparnis, also rund 6 % mehr Prompts mit demselben Limit.

Wie sehe ich, was ein Hintergrund-Subagent gerade tut?

Das Panel unter der Eingabe zeigt pro Hintergrund-Subagent eine Zeile mit Status, Laufzeit und Tokens. Mit ↓ auswählen, mit Enter das Protokoll öffnen, und /tasks zeigt Modell, Tool-Aufrufe und Fortschritt.

Gilt das neue Verfahren auch bei Anbindung per API Key?

Anthropics Beiträge nennen nur Pro, Max, Ultra, Team und Enterprise. In unserem API-Key-Test mit 2.1.318 folgten die Aktualisierungen dem Modell des Subagents; mit dem Subagent auf Haiku 5.5 liefen auch sie auf Haiku 5.5.

API Key erstellen und Hintergrund-Subagents in Claude Code nutzen →

Weiterlesen

• Claude-Code-Subagents mit Haiku 5.5: Einrichtung
• Claude-Code-Subagents in Skills überführen
• Claude-Code-Nutzungslimits und Max 20x
• Claude Haiku 5.5 vs. Sonnet 5.5
• Claude Code mit einer Drittanbieter-API nutzen