Claude Agent SDK: 5-Stunden-Limit prüfen und Verbrauch messen

Wenn Claude-Agent-SDK-Apps oder claude -p Ihr 5-Stunden-Kontingent früh aufbrauchen, vergleichen Sie dieselbe Aufgabe im interaktiven Claude Code. Community-Tests melden einen etwa 1.6×–2.97× schnelleren Verbrauch, belegen aber keinen allgemein gültigen Faktor. Für wiederkehrende Automatisierung bietet die dokumentierte API-Abrechnung ein separates Guthaben und messbare Token-Kosten.

Mit Stand 2026-10-27 ist Anthropic-Issue #97074 weiterhin offen. Die Berichte liefern Hinweise auf unterschiedlichen Kontingentverbrauch je nach Client-Einstiegspunkt. Sie klären nicht, ob Anthropic diesen Unterschied beabsichtigt oder als Fehler betrachtet.

Was die kontrollierten Vergleiche tatsächlich gemessen haben

Mehrere Autoren meldeten einen höheren Verbrauch des 5-Stunden-Kontingents bei vergleichbarer Arbeit über claude -p oder Agent-SDK-Apps. Die einzelnen Versuche unterscheiden sich bei Versionen, Modellen, Token-Zusammensetzung und Vergleichsclients.

Bericht	Testbedingungen	Gemeldetes Ergebnis
qvarker, 25. September	Max; Claude Code 2.1.282; claude-opus-5; Effort-Einstellung high	Im Headless-Modus etwa 1.8× schnellerer Kontingentverbrauch als im interaktiven Terminal
kler, 17. Oktober	Team; Claude Code 2.1.300; claude-opus-5-5; Effort-Einstellung high	sdk-ts: 2.97×; sdk-cli: 2.83× gegenüber einem Testprogramm mit der Kennung claude-vscode
Theos T3-Code-Bericht, 25. Oktober	Ein Max-Konto; abgestimmte Arbeitslast; interaktives Terminal, T3 Code und claude -p	Nach dem Cache-Vergleich des Berichts etwa 1.6×–1.7× schnellerer Verbrauch über SDK beziehungsweise Headless-Modus
frostfire575, 26. Oktober	Windows 11; Claude Code 2.1.310; claude-opus-5-5; Effort-Einstellung low	Über claude -p etwa 2.4× mehr Kontingent pro gewichtetem Token als im interaktiven Terminal

Der höchste Wert braucht eine wichtige Einschränkung: klers Testprogramm ahmte die Kennung der VS-Code-Erweiterung nach. Es bediente nicht die tatsächliche Erweiterung. Das Ergebnis grenzt einen kennungsbezogenen Unterschied innerhalb dieses Versuchs ein.

Die Dollarbeträge in qvarkers Bericht sind API-äquivalente Schätzungen, mit denen der Arbeitsumfang vergleichbar gemacht wurde. Sie sind keine zusätzlichen Abonnementgebühren. Ein niedrigerer Wert für „Arbeit in Dollar pro 1%“ bedeutet, dass das Kontingent schneller aufgebraucht wurde.

Das Wochenkontingent muss separat betrachtet werden. Theo verzeichnete bei jedem Durchlauf denselben Anstieg um zwei Prozentpunkte. Bei frostfire575 stieg die Wochenanzeige nur von 0% auf 1%. Diese Auflösung reicht für eine Schlussfolgerung nicht aus. Die Daten stützen einen unveränderten Wochenverbrauch in Theos Versuch, aber keine Garantie für jedes Konto.

Was sdk-cli und sdk-ts tatsächlich belegen

Der Einstiegspunkt, also der entrypoint, kennzeichnet den aufrufenden Client. Sein Wert legt Anthropics serverseitige Formel zur Verbrauchsberechnung nicht offen.

Das veröffentlichte Paket @anthropic-ai/claude-agent-sdk 0.3.311 enthält in sdk.mjs diese Vorgabe:

if(!c.CLAUDE_CODE_ENTRYPOINT)c.CLAUDE_CODE_ENTRYPOINT="sdk-ts"

Das SDK setzt somit sdk-ts, wenn der entsprechende Umgebungswert fehlt. In Transkripten aus der Community steht bei gewöhnlichen claude -p-Aufrufen sdk-cli, beim interaktiven Terminal dagegen cli.

In qvarkers Netzwerkvergleich unterschieden sich die Anfragen bei cc_entrypoint im Systemblock x-anthropic-billing-header. Der Autor beobachtete außerdem Unterschiede im User-Agent und bei einem Beta-Flag.

Das ist eine Community-Beobachtung zum Inhalt der Anfragen. Es handelt sich weder um eine offiziell dokumentierte Billing-Header-Schnittstelle noch um den Beweis, dass ein Feld alle Unterschiede erklärt.

Das Änderungsprotokoll von Claude Code 2.1.311 kündigt keine Korrektur dieser Verbrauchsabweichung an. Aus dem fehlenden Eintrag lässt sich nicht ableiten, ob sich das Verhalten auf dem Server geändert hat.

So prüfen Sie Ihren eigenen Ablauf

Prüfen und messen Sie den tatsächlich gestarteten Client, den Authentifizierungsweg und den Arbeitsumfang, bevor Sie die Konfiguration ändern.

Authentifizierung und Vergleichsbedingungen bestätigen

Prüfen Sie die Umgebung, in der der Claude-Prozess Ihrer Anwendung läuft. Laut Authentifizierungsreferenz kann ein API-Schlüssel im Modus -p Vorrang vor der Abonnement-Anmeldung haben.

Notieren Sie die ausführbare Datei, CLI-Version, SDK-Paketversion, den Kontotarif, die genaue Modell-ID und die Effort-Einstellung. Eine Oberfläche kann eine andere Binärdatei starten als Ihr Terminal.

Für den Vergleich gelten folgende Bedingungen:

• Verwenden Sie dasselbe Konto, denselben Projektstand, dieselbe Prompt-Liste, dieselben Tools und dieselben Cache-Einstellungen.
• Pausieren Sie andere Aktivitäten auf diesem Konto.
• Beginnen Sie neue Sitzungen und führen Sie beide Durchläufe innerhalb desselben 5-Stunden-Fensters aus.
• Brechen Sie den Vergleich ab, wenn das Fenster zurückgesetzt wird oder die Nutzung auf kostenpflichtige Zusatznutzung umschaltet.

Wählen Sie eine repräsentative Aufgabe, etwa dieselben Quelldateien zusammenzufassen. Erfassen Sie Eingabe-, Ausgabe-, Cache-Lese- und Cache-Schreib-Tokens getrennt. Eine gleich lange Ausgabe belegt allein keinen gleichen Arbeitsumfang.

Verbrauchsanzeige und aufgezeichneten entrypoint erfassen

Bewahren Sie die vollständigen Daten des Rate-Limit-Ereignisses auf. Die verfügbaren Felder unterscheiden sich zwischen Versionen.

Die folgende Bash-Prüfung benötigt jq und eine bestehende Abonnement-Anmeldung. Sie verbraucht Kontingent. Sie prüft Telemetrie und Authentifizierung; die Antwort aus einem Wort misst keinen Verbrauchsfaktor.

set -o pipefail
claude --version
claude auth status | jq '{authMethod}'
claude -p "Reply with exactly OK." \
  --model claude-sonnet-5-5 \
  --max-turns 1 \
  --disallowedTools "*" \
  --output-format stream-json --verbose |
jq -c '
  if .type == "rate_limit_event" then
    {type, session_id, rate_limit_info}
  elif .type == "result" then
    {type, subtype, is_error, session_id,
     usage, modelUsage, total_cost_usd, result}
  else empty end
'

Die CLI-Referenz dokumentiert diese Optionen und den Befehl zum Authentifizierungsstatus. Eine erfolgreiche Antwort sollte einen result-Datensatz mit subtype: "success" und is_error: false enthalten.

Die für Messungen angepassten Builds im Issue verwendeten diesen Pfad:

rate_limit_event.rate_limit_info.unifiedWindows.five_hour.utilization

Im öffentlichen Ereignistyp des SDK 0.3.311 fehlt jedoch unifiedWindows. Dieser Typ deklariert stattdessen unter anderem rateLimitType und utilization. Deuten Sie ein fehlendes Feld oder Ereignis nicht als Nullverbrauch. Verwenden Sie die Usage-Seite des Kontos, wenn der Stream keinen brauchbaren Messwert liefert.

Vergleichen Sie Messwerte aus derselben Schnittstelle und auf derselben Skala. Ereignisbasierte Verbrauchswerte und die separate Antwort zur Nutzungssteuerung im SDK haben unterschiedliche Schemas. Ihre Zahlen sind nicht austauschbar.

Suchen Sie mit der zurückgegebenen session_id das zugehörige Transkript. Laut Sitzungsdokumentation liegen Transkripte unter ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl. Ein angepasstes CLAUDE_CONFIG_DIR ändert das Stammverzeichnis.

Prüfen Sie mit Bash nur den aufgezeichneten entrypoint:

read -r -p "Transcript path: " CLAUDE_TRANSCRIPT
jq -r 'select(.entrypoint? | type == "string") | .entrypoint' \
  "$CLAUDE_TRANSCRIPT" | sort -u

Ein leeres Ergebnis bedeutet, dass das Feld nicht verfügbar war. Es kennzeichnet die Sitzung nicht automatisch als interaktiv.

Starten Sie für den Terminalvergleich den echten interaktiven Claude-Code-Client aus einer sauberen Shell. qvarker berichtete, dass ein tmux-Server CLAUDE_CODE_ENTRYPOINT übernommen und an spätere Terminalsitzungen weitergegeben hatte. Prüfen Sie das entstandene Transkript, statt die Kennung allein aus der Oberfläche abzuleiten.

Kontingentverbrauch pro Arbeitseinheit vergleichen

Vergleichen Sie Prozentpunkte pro gleichwertiger Arbeitseinheit. Die Laufzeit oder die Anzahl der Prompts reicht dafür nicht aus.

Frostfire575 meldete im Terminal 1.43 Millionen gewichtete Tokens bei einem Anstieg um fünf Prozentpunkte. Der Headless-Durchlauf verwendete 1.32 Millionen gewichtete Tokens bei einem Anstieg um elf Prozentpunkte. Aus den gemeldeten Werten ergibt sich:

Headless / terminal = (11 / 1.32) / (5 / 1.43) = 2.38

Diese Rechnung erklärt das gemeldete Ergebnis von 2.4×. Sie verwendet die gewichtete Token-Messgröße des Autors und gilt nur für diesen Vergleich.

Änderungen um einen Prozentpunkt sind für aussagekräftige Vergleiche kleiner Durchläufe zu grob. Wiederholen Sie normale Aufgaben bei Bedarf in umgekehrter Reihenfolge. Vermeiden Sie dabei eine Rücksetzung des Fensters und gleichzeitige Aktivitäten auf dem Konto.

Verwenden Sie für Kostenschätzungen die Endergebnisse neuer Sitzungen. Addieren Sie keine kumulierten Ergebnisdatensätze fortgesetzter Sitzungen. Die Dokumentation zur Kostenverfolgung unterscheidet Token-Erfassung und tatsächliche Abrechnung. Weder total_cost_usd noch modelUsage misst das Abonnementkontingent.

Verschwindet die Abweichung nach dem Abgleich des Cache-Verhaltens oder dem Stoppen paralleler Aktivitäten, untersuchen Sie zuerst diese Ursachen.

Sollten Sie CLAUDE_CODE_ENTRYPOINT ändern?

Behandeln Sie eine geänderte Client-Kennung als nicht offiziell unterstütztes Experiment.

Am 26. Oktober berichteten qvarker und oviano von geringerem Verbrauch mit dem Namen ihres eigenen Tools. In ihren Vergleichen lag der Verbrauch mit der Standardkennung sdk-cli etwa 1.9×–2.4× höher.

Diese Berichte belegen keinen genehmigten Weg, eine andere Kontingentbehandlung zu erhalten. Eine eigene Kennung verändert die Zuordnung des Clients, die offenbar für die Verbrauchsberechnung relevant ist. Ihre Behandlung könnte sich ändern. Der Status im Hinblick auf die Nutzungsregeln bleibt ungeklärt.

Kennzeichnen Sie Ihre Anwendung nicht als cli oder claude-vscode, um die Behandlung eines anderen Clients zu erhalten. Diese Namen stehen für andere Clients.

Der zugehörige T3-Code-Pull-Request #25597 war bei der Prüfung am 2026-10-27 offen und nicht zusammengeführt. Seine Existenz belegt weder einen veröffentlichten T3-Code-Fix noch eine Freigabe durch Anthropic.

Testen Sie für interaktive Arbeit den echten Terminalclient. Prüfen Sie für Automatisierung mit strukturierten Ein- und Ausgaben die API-Abrechnung.

Welches Guthaben bezahlt Agent-SDK-Automatisierung?

Die Authentifizierung entscheidet, ob ein Auftrag Abonnementkontingent oder API-Guthaben verbraucht.

Anthropics Abrechnungsupdate vom 7. Oktober behält die Abonnementnutzung für Agent SDK, claude -p und Drittanbieter-Apps bei. Berechtigte Max- und Team-API-Guthaben können auch für selbst gestartete SDK- und claude -p-Aufträge verwendet werden. Dafür müssen sie sich mit einem API-Schlüssel der verknüpften Console-Organisation authentifizieren.

Unterscheiden Sie diese Kontingente und Guthaben:

Abrechnungsweg	Was der Auftrag verbraucht
Anmeldung über das Claude-Abonnement	Abonnementkontingente einschließlich des 5-Stunden-Fensters
Aktivierte Zusatznutzung, auch usage credits genannt	Separat bezahlte Weiternutzung nach dem enthaltenen Kontingent
Anthropic-API-Schlüssel	Berechtigtes API-Guthaben oder bezahltes API-Guthaben der Console-Organisation
Unabhängiges API-Gateway	Guthaben und Abrechnungsregeln dieses Anbieters

Mit API-Abrechnung hängt der Auftrag nicht mehr vom 5-Stunden-Kontingent des Abonnements ab. API-Ratenlimits, Ausgabenlimits und das verfügbare Guthaben gelten weiterhin.

Mit Stand 2026-10-27 nennt das Programm für monatliches API-Guthaben folgende Beträge:

Berechtigter Tarif	Monatliches API-Guthaben
Max 5x	$100 USD
Max 20x	$200 USD
Team Standard	$20 USD pro Sitz
Team Premium	$100 USD pro Sitz

Team-Guthaben bildet einen gemeinsamen Pool mit einer Obergrenze von $500 USD. Pro ist nicht berechtigt. Neue Abonnenten müssen sieben Tage in einem berechtigten Tarif bleiben.

Öffnen Sie zum Aktivieren des Guthabens bei Max Settings > Billing oder bei Team Organization settings > Billing. Wählen Sie unter API credits Link organization. Sie benötigen die erforderliche Abonnenten- beziehungsweise Inhaberrolle sowie Console-Abrechnungsberechtigungen. Erstellen Sie den API-Schlüssel in dieser verknüpften Organisation.

Das Programm schließt interaktives Claude Code, Zusatznutzung und Aufträge aus, die Claude Code GitHub Action, IDE-Erweiterungen oder die Claude-Desktop-App starten. Das Hinzufügen von -p hebt diese Ausschlüsse nicht auf.

Laut Platform-Dokumentation zum Guthaben verfällt ungenutztes Guthaben ohne Übertrag. Enthaltenes Guthaben wird vor gekauftem Guthaben verbraucht. Danach können gekauftes Guthaben oder eine anwendbare Rechnungsvereinbarung den Betrieb fortsetzen. Andernfalls stoppen die Anfragen. Sie wechseln nicht automatisch zurück zum Abonnementkontingent.

API-Abrechnung vor der Migration wiederkehrender Aufträge prüfen

Prüfen Sie einen direkten API-Schlüssel-Aufruf und dessen Console-Nutzung, bevor Sie eine Auftragswarteschlange umstellen.

Verwenden Sie ein Bash-Terminal, das für direkten Anthropic-Zugriff eingerichtet ist. Prüfen Sie zuerst vorhandene Werte für ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN und die Einstellungen des Cloud-Anbieters. Diese können einen anderen Endpunkt oder eine andere Quelle für Zugangsdaten auswählen.

Erstellen Sie einen API-Schlüssel in der vorgesehenen Console-Organisation. Geben Sie ihn ohne Anzeige ein:

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
claude --bare -p \
  --model claude-sonnet-5-5 \
  --tools "" \
  --max-turns 1 \
  --max-budget-usd 1.00 \
  --output-format json \
  "Reply with exactly OK."

Laut Dokumentation zur programmgesteuerten Nutzung überspringt --bare die OAuth-Zugangsdaten des Abonnements und automatisch gefundene Anpassungen. Damit eignet sich der Modus für die API-Prüfung. Bei einem Abonnementvergleich würde er den Authentifizierungsweg verändern.

Erwarten Sie ein erfolgreiches JSON-Ergebnis mit der Antwort. Prüfen Sie anschließend Nutzung und Guthaben der richtigen Organisation in der Console. Die CLI-Kostenschätzung allein belegt nicht, dass Aktionsguthaben die Anfrage bezahlt hat.

Scheitert die Authentifizierung, prüfen Sie den Schlüssel und den aktiven Anbieter. Ist das Guthaben aufgebraucht, prüfen Sie die Console-Abrechnung. Bei API-Ratenlimit- oder Ausgabenlimitfehlern müssen Sie diese Grenzen prüfen, selbst wenn noch Abonnementkontingent vorhanden ist.

Das CLI-Budget von $1.00 ist eine geschätzte Stoppschwelle. Eine Anfrage kann sie überschreiten. Setzen Sie deshalb zusätzlich ein geeignetes Ausgabenlimit in der Console.

Als Budgetbeispiel nennen Anthropics aktuelle Preise für claude-sonnet-5-5 $2 pro Million nicht zwischengespeicherter Eingabe-Tokens. Ausgabe-Tokens kosten $10 pro Million. Mit Stand 2026-10-27 ergeben eine Million Eingabe-Tokens und 100,000 Ausgabe-Tokens somit geschätzte Token-Kosten von:

(1 × $2) + (0.1 × $10) = $3

Die Rechnung setzt standardmäßiges synchrones globales Routing voraus. Sie berücksichtigt weder Cache-Nutzung noch separat berechnete Servertools und enthält keine anfallenden Steuern. Berechnen Sie bei wiederholtem Kontext Cache-Schreib- und Cache-Lesezugriffe mit ihren jeweiligen Preisen.

Ein unabhängiges Gateway ist eine weitere Möglichkeit. BetterTokens Live-Katalog führte am 2026-10-27 claude-sonnet-5-5 und claude-opus-5-5. Der Claude-Code-Leitfaden verwendet Ihren eigenen BetterToken-Schlüssel und die Basis-URL https://bettertoken.ai, ohne /v1. Vergleichen Sie die aktuellen Preise und die erforderliche Tool-Kompatibilität anhand Ihrer Arbeitslast. Anthropics enthaltenes API-Guthaben lässt sich nicht auf diesen separaten Abrechnungsweg übertragen.