KIOpen Source 833 Wörter 4 Min. Lesezeit

Claude Code: Warum ein Drei-Wörter-Status bis zu einem Viertel der Tokens kostet

Claude Code: Warum ein Drei-Wörter-Status bis zu einem Viertel der Tokens kostet
Inhaltsverzeichnis

Claude Code schickt für jeden Hintergrund-Subagenten etwa alle 30 Sekunden dessen komplettes Transcript an das Modell. Die Antwort besteht aus drei bis fünf Wörtern und landet nur als Statuszeile im Agents-Panel. In mehreren Messungen aus dem GitHub-Issue #86879 machen diese Anfragen je nach Messung rund 16 bis 26 Prozent des Verbrauchs aus. Einen offiziellen Schalter dafür gibt es bisher nicht. Die Firma Flamerix AI hat einen Workaround als Gist veröffentlicht.

Was passiert #

Intern läuft die Anfrage unter der Kennung query_source = agent_summary. Sie bekommt das gesamte bisherige Transcript des Agenten, verwendet dasselbe Modell wie der Agent (meist Opus) und liest den Kontext fast immer aus dem Prompt-Cache. Das ist günstiger als ein frischer Durchlauf, aber der Kontext wird bei jedem Tick komplett gelesen. Je länger ein Agent arbeitet, desto teurer wird jede Statuszeile.

Der Gist nennt als Zeitleiste:

  • 2.1.72 (März 2026): als SDK-Option erreichbar
  • 2.1.232 (13. August): für interaktive Hintergrund-Agenten standardmäßig aktiv
  • 2.1.300 (14. Oktober): Intervall wird serverseitig steuerbar, Werte zwischen 30 und 240 Sekunden
  • 2.1.310 (23. Oktober): ein sparsamerer short-Modus mit rund 2.000 Token Notizen statt des vollen Transcripts ist enthalten, aber ausgeschaltet

Was gemessen wurde #

QuelleMessung
Flamerix AI (OpenTelemetry-Export)16,4 % der Kosten und 19,7 % der API-Requests; die Hauptkonversation kam auf 15,7 % der Kosten
sylvain-artois (Issue, Version 2.1.276)103 Summary-Aufrufe gegenüber 442 regulären Aufrufen; 26 % der Cache-Reads bei rund 20 Ausgabe-Tokens pro Aufruf
rabitlord1324 (Issue, Fable-5.1-Subagenten)versteckte Cache-Reads etwa so groß wie ein kompletter Kontext-Re-Read pro Agenten-Schritt

Ein Beispiel aus dem Issue: Bei einem Agenten mit 380.000 Token Kontext kommen allein für die Statuszeile etwa 45 Millionen gelesene Cache-Tokens pro Stunde zusammen.

Die Zahlen stammen aus Nutzermessungen und sind nicht repräsentativ. Flamerix gibt an, dass es sich um die von Claude Code selbst geschätzten Kosten handelt und nicht um eine Rechnung. Wer ein Abo nutzt, verliert dadurch vor allem Spielraum im Rate-Limit.

Dazu kommt ein Messproblem: Die Summary-Anfragen stehen laut Issue nicht in den lokalen Session-Logs (siehe #104358 ). Tools, die Kosten aus den Transcripts berechnen, sehen sie deshalb nicht. Sichtbar sind sie nur im OpenTelemetry-Export.

Was sich abschalten lässt #

Eine eigene Einstellung gibt es nicht. Laut Issue und Gist bleiben diese Wege:

  • CLAUDE_CODE_FORK_SUBAGENT=0 stoppt die Summaries, schaltet aber auch Fork-Subagenten ab.
  • CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 wirkt ebenfalls, nimmt aber die Hintergrund-Agenten mit.
  • Im nicht-interaktiven Modus (claude -p) war die Funktion in Version 2.1.276 aus. Ob das auch für neuere Versionen gilt, ist nicht belegt.
  • CLAUDE_CODE_ENABLE_NARRATION=0 half in 2.1.241 und ist in neueren Versionen ohne Wirkung.
  • DISABLE_NON_ESSENTIAL_MODEL_CALLS kommt laut Gist in der Binary gar nicht vor.

Der Workaround aus dem Gist #

Flamerix liefert ein kleines Bun-Preload-Skript, no-agent-summary.js (MIT-Lizenz). Es wird über BUN_OPTIONS=--preload … in jeden Claude-Prozess geladen und ersetzt nur den Timer der Statuszeile durch einen, der nie auslöst. Die Binary bleibt unverändert, alle anderen Timer laufen normal.

Der Gist nennt Tests unter Linux mit den Versionen 2.1.257 bis 2.1.312. In einem Lauf mit einem Subagenten über rund 2,5 Minuten (Version 2.1.312) gab es ohne Hook 5 Summary-Forks, mit dem Hook keinen. Flamerix berichtet, dass seit dem Einsatz in der eigenen Umgebung keine agent_summary-Anfragen mehr aufgetaucht sind und keine andere Hintergrundanfrage an deren Stelle gewachsen ist. Subagenten, Hintergrund-Agenten und Skills laufen weiter, nur die Statuszeile pro Agent im Panel aktualisiert sich nicht mehr.

Vor dem Einsatz sollte man wissen:

  • Das Skript ist kein offizieller Weg und unabhängig von Anthropic. Der Gist weist selbst darauf hin, dass ein verändertes Laufzeitverhalten gegen die Nutzungsbedingungen verstoßen kann und das in der Verantwortung der Nutzer liegt.
  • Updates können den Hook unwirksam machen. Er erkennt den Timer am Quelltext des Callbacks. Wird dort etwas umbenannt, greift er nicht mehr, und die Summaries kommen unbemerkt zurück. Nach jedem Update sollte man per CC_AGENT_SUMMARY_LOG prüfen, ob der Hook den Timer noch findet.
  • Nach der Installation muss claude daemon stop --any laufen, sonst starten Hintergrundprozesse weiter ohne den Hook.
  • Getestet ist nur Linux. Für macOS und Windows gibt es keine Angaben.
  • Das Skript ist rund 90 Zeilen lang. Beim Durchlesen fanden sich keine Netzwerkzugriffe, und in eine Datei schreibt es nur, wenn man die Log- oder Marker-Variable setzt. Wer es einsetzt, sollte es trotzdem selbst lesen, bevor er es global in die Shell einträgt.

Die Installation besteht im Kern aus einer Zeile in der Shell-Konfiguration:

export BUN_OPTIONS="${BUN_OPTIONS:+$BUN_OPTIONS }--preload $HOME/.local/share/no-agent-summary.js"

Zum Prüfen gibt man beim Start CC_AGENT_SUMMARY_LOG=/tmp/nas.log mit. Die Logdatei sollte preload active mode=off enthalten.

Einordnung #

Wer selten oder nie mit Hintergrund-Subagenten arbeitet, dürfte davon wenig merken. Teuer wird es bei vielen oder lange laufenden Agenten mit großem Kontext, besonders unbeaufsichtigt über Nacht oder in CI, wo niemand die Statuszeile liest. Die Forderungen im Issue sind einfach: eine offizielle Einstellung oder Umgebungsvariable, ein Intervall, das mit der Kontextgröße oder der Aktivität des Agenten wächst, und die Aufzeichnung dieser Anfragen in den lokalen Logs. Bis Anthropic reagiert, bleibt die Wahl zwischen der offiziellen Variablen, die den Fork-Modus mit abschaltet, und dem inoffiziellen Hook.

Quellen: GitHub-Issue #86879 (anthropics/claude-code), Gist „Claude Code burns ~15–20 % of your tokens on a 3-word status line“ (Flamerix AI, Stand 28.10.2026)