Fehlerbehebung · 429 durch monatliches Ausgabenlimit

HTTP 429 ohne retry-after
error_code enforced_spend_limit_reached

Erneut am 2026-10-20 anhand der Anthropic-Dokumentation geprüft: Die monatlichen Ausgabenlimits für Start / Build / Scale betragen weiterhin $500 / $1,000 / $200,000. Nach dem Erreichen des Limits geben Anfragen weiterhin HTTP 429 mit dem type rate_limit_error zurück, aber ohne retry-after. Wiederholungen schlagen bis 00:00 UTC am ersten Tag des nächsten Monats weiter fehl.

Aktualisiert 2026-10-22

Ein Key für Claude, GPT und führende chinesische Modelle, Bezahlung pro Token, in wenigen Minuten startklar.

#enforced_spend_limit_reached#rate_limit_error#kein retry-after#monatliches Ausgabenlimit

Vier Fakten, die Sie einzeln zitieren können

429

Sieht aus wie ein normales Rate Limit

Der Status ist weiterhin 429 und error.type ist weiterhin rate_limit_error, weshalb viele SDKs den Fehler wie eine Drosselung pro Minute erneut versuchen.

Kein retry-after

Der Unterschied zu einem echten Rate-Limit-429

Ein 429 durch das Ausgabenlimit der Stufe enthält kein retry-after. Standardmäßige SDK-Wiederholungen schlagen bis 00:00 UTC am 1. fehl – oder bis Sie in eine höhere Stufe verschoben werden.

$500 / $1,000 / $200,000

Monatliche Limits für Start / Build / Scale

Diese drei Dollarbeträge sind die dokumentierten monatlichen Limits. Organisationen auf der Custom-Stufe haben kein monatliches Ausgabenlimit; die Limits werden mit dem Account-Team vereinbart.

enforced_spend_limit_reached

error_code der Messages API

Lesen Sie error.details.error_code. Lautet er so, hören Sie mit den Wiederholungen auf. Ein Ausgabenlimit, das Sie selbst festgelegt haben, liefert stattdessen HTTP 400 invalid_request_error.

Dieser 429 bedeutet nicht „Sie haben zu schnell gesendet“

Anthropic unterscheidet zwischen Ausgabenlimits (wie viele Dollar eine Organisation in einem Kalendermonat ausgeben darf) und Rate Limits (RPM / ITPM / OTPM). Beide können HTTP 429 mit error.type rate_limit_error zurückgeben. Das Unterscheidungsmerkmal steckt in details: Wird das monatliche Limit der Stufe erreicht, setzt die Messages API error.details.error_code auf enforced_spend_limit_reached und sendet kein retry-after. Die dokumentierte Beispielmeldung lautet „You have reached your API usage limits: your organization has crossed its monthly API usage threshold… You will regain access on 2026-09-01 at 00:00 UTC.“ Der Zugriff wird am ersten Tag des nächsten Monats um 00:00 UTC wiederhergestellt, sofern Sie nicht vorher eine höhere Stufe erhalten. Ein niedrigeres Ausgabenlimit, das Sie auf der Billing-Seite konfiguriert haben, ist ein anderer Fall: Es liefert HTTP 400 mit dem type invalid_request_error, und die Meldung beginnt mit „You have reached your specified API usage limits“. Workspace-Limits von Claude Code werden separat geprüft und können einen 429 zurückgeben, der ein retry-after enthält.

Warum man ihn leicht mit Wochenlimits und Rate-Limit-429 verwechselt

Am 2026-06-26 fasste das Plattform-Changelog von Anthropic die Nutzungsstufen zu Start / Build / Scale zusammen und veröffentlichte die monatlichen Limits von $500 / $1,000 / $200,000. Agent-Workloads verbrauchen Dollar schneller als Tokens pro Minute, sodass Start-/Build-Organisationen das Monatslimit lange vor RPM/ITPM erreichen können. Auf der Leitung steht weiterhin 429, was mit „You've hit your weekly limit“ und mit Rate Limits mit retry-after kollidiert. Unsere bestehende Seite zu 529 vs. 429 vs. Wochenlimit behandelt 429 hauptsächlich als Drosselung, die sich per Backoff auflösen lässt. Diese Seite behandelt den dritten 429: das monatliche Dollar-Limit, bei dem Backoff nichts bewirkt.

Zeitachse

2026-06-26

Anthropic-Changelog: Die Nutzungsstufen wurden zu drei Stufen zusammengefasst – Start, Build und Scale. Die Rate Limits von Sonnet und Haiku entsprechen nun auf jeder Stufe denen von Opus; die meisten Organisationen wurden höher eingestuft, keine erhielt niedrigere Limits. Monatliche Ausgabenlimits gelten je Stufe.

Aktuelle Dokumentation (abgerufen am 2026-10-20)

platform.claude.com/docs/en/api/rate-limits besagt: Wird das Limit der Stufe erreicht, ist die Nutzung bis 00:00 UTC am 1. pausiert; der 429 hat kein retry-after; error_code ist enforced_spend_limit_reached.

00:00 UTC am 1.

Ohne Stufenerhöhung wird der Zugriff in genau diesem Moment wiederhergestellt. Das Beispiel-JSON verwendet 2026-09-01 00:00 UTC als Beispieldatum; verlassen Sie sich auf den Zeitstempel in Ihrem eigenen Fehler-Body.

Bestätigt vs. häufige Verwechslungen

Bestätigt

Die am 2026-10-20 abgerufene Anthropic-Dokumentation bestätigt: Ein 429 durch das Ausgabenlimit der Stufe verwendet weiterhin den type rate_limit_error und enthält kein retry-after; auf der Messages API grenzt error.details.error_code = enforced_spend_limit_reached ihn von einem Rate Limit ab. Die Limits betragen $500 / $1,000 / $200,000. Ein von Ihnen festgelegtes Ausgabenlimit liefert HTTP 400.

Häufige Verwechslungen

„Jeder 429 verschwindet, wenn man einige Dutzend Sekunden wartet“ stimmt für Rate Limits mit retry-after und ist bei enforced_spend_limit_reached falsch. Eine weitere Verwechslung: den Fehler für das Wochenlimit von Claude Code zu halten. Das Wochenlimit ist ein Kontingent pro Abo-Zeitraum; das Ausgabenlimit ist die monatliche USD-Obergrenze einer Console-Organisation. Die Zeitpunkte für das Zurücksetzen sind unterschiedlich.

Was zu tun ist: clientseitig vs. abrechnungsseitig

Rate-Limit-429: retry-after beachten

type rate_limit_error zusammen mit einem retry-after- oder anthropic-ratelimit-*-Header bedeutet RPM / ITPM / OTPM oder ein Beschleunigungslimit. Reduzieren Sie die Parallelität, beachten Sie den Header und nutzen Sie Prompt Caching. Die Wiederherstellung dauert meist Minuten. Behandeln Sie einen 429 durch das Ausgabenlimit nicht auf diese Weise.

enforced_spend_limit_reached: Backoff hilft nicht

Fordern Sie auf der Rate-limits-Seite eine höhere Stufe an oder warten Sie bis 00:00 UTC am 1. Ein 400 durch Ihr eigenes Ausgabenlimit verschwindet, sobald Sie es unter Billing erhöhen oder entfernen. Ist der Kalendermonat bereits ausgeschöpft und der Job kann nicht warten, benötigen Sie einen Abrechnungsweg, der nicht diese Console-Organisation ist.

Dreistufige Prüfung (funktioniert ohne Anbieterwechsel)

Schritt 1: HTTP 429 oder 400? Schritt 2: Lautet error.details.error_code enforced_spend_limit_reached, und fehlt retry-after? Schritt 3: Nennt die Meldung 00:00 UTC am 1. des Monats? Dann ist es das Tarif-Limit. Ein 400, dessen Meldung auf Ihr eigenes Ausgabenlimit verweist, ist das von Ihnen gesetzte Limit. Die Limits des Claude Code workspace werden separat geprüft; bei Überschreitung kann es ein 429 mit retry-after sein. Erhöhen Sie zuerst den Tarif oder das Billing-Limit innerhalb derselben Organisation.

Dieser Fehler stammt nicht aus dem Ledger von QCode

enforced_spend_limit_reached betrifft das monatliche Ausgabenlimit Ihrer eigenen Organisation im Anthropic Console - das ist ein anderes System als Ihr QCode-Guthaben. Bei QCode gilt: Abrechnung pro Token; die Preise je Modell stehen auf /models. Prüfen Sie zuerst, ob bei Ihnen ein Privatplan aktiv ist: Privatpläne haben ein Tageskontingent für 30 Tage; reicht ein Tag nicht, kaufen Sie ein Booster-Pack. Ohne Privatplan und ohne Monatsplan nutzen Sie Nutzungspakete ab $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen nutzen. Ist das Kontingent aufgebraucht, antworten Anfragen mit HTTP 402, nach Ablauf mit HTTP 401.

FAQ

Wie unterscheide ich enforced_spend_limit_reached von einem normalen 429?

Zwei Prüfungen: kein retry-after, und error.details.error_code entspricht enforced_spend_limit_reached. Wenn beides zutrifft, behandeln Sie es als Monatslimit und nicht als Drosselung pro Minute.

Wie hoch sind die monatlichen Limits für Start / Build / Scale?

Die am 2026-10-20 abgerufene Dokumentation nennt Start $500, Build $1,000, Scale $200,000 USD pro Kalendermonat. Custom hat kein monatliches Ausgabenlimit. Verlassen Sie sich auf die Zahlen auf Ihrer Console-Seite Billing / Rate limits.

Verwendet ein von mir selbst gesetztes Ausgabenlimit diesen error_code?

Nein. Ein Limit, das Sie für die Organisation oder einen Workspace setzen, liefert HTTP 400, type invalid_request_error, Meldung beginnend mit „You have reached your specified API usage limits“. Ein Workspace-Overage bei Claude Code kann ein 429 mit retry-after sein. Verwenden Sie für die drei Fälle keine gemeinsame Retry-Strategie.

Kann ich das Monatslimit umgehen, indem ich das Claude-Modell wechsle?

Nein. Das Limit gilt in Dollar pro Organisation und Kalendermonat, nicht pro Modell. Auch eine andere Claude-SKU wird derselben Organisation berechnet. Sie können nur fortfahren, indem Sie den Tarif erhöhen, bis zum 1. warten oder den Traffic an ein Konto außerhalb dieser Console-Organisation senden.

Was macht der automatische Retry des SDK?

Offizielle SDKs wiederholen Rate Limits, die retry-after enthalten. Ein 429 durch das Ausgabenlimit hat keines, daher schlagen Wiederholungen bis zur Wiederaufnahmezeit fehl. Hören Sie mit den Wiederholungen auf, sobald Sie enforced_spend_limit_reached sehen, und öffnen Sie Billing / Rate limits.

Ist das dasselbe wie das Wochenlimit von Claude Code?

Nein. Das Wochenlimit ist ein Kontingent für den Abo-Zeitraum. enforced_spend_limit_reached ist das monatliche USD-Limit einer API-Organisation. Das eine erscheint in Claude Code / claude.ai, das andere bei Console-API-Keys. Die Reset-Zeitpunkte unterscheiden sich.

Quellen

Limit-Beträge, das fehlende retry-after, error_code enforced_spend_limit_reached und der HTTP-400-Fehler bei einem von Ihnen gesetzten Ausgabenlimit stammen von der Rate-Limits-Seite von Anthropic unter platform.claude.com/docs/en/api/rate-limits, abgerufen am 2026-10-20; der Beispiel-Fehlertext und das Beispiel-Wiederaufnahmedatum stehen im JSON-Beispiel derselben Seite. Das Datum der Zusammenführung zu Start / Build / Scale ist der Eintrag vom 2026-06-26 unter platform.claude.com/docs/en/release-notes/overview, abgerufen am 2026-10-20.

Wenn eine Console-Organisation ihr Limit erreicht hat, muss die Lieferung nicht bis zum 1. warten

Das ist die Abrechnung Ihrer Anthropic-Organisation, kein defekter Key. Wenn Sie einen anderen Abrechnungsweg brauchen: Bei QCode gilt Abrechnung pro Token, und Sie rufen die auf /models gelisteten Modelle mit Ihrem Guthaben auf.

Unsicher, womit Sie anfangen sollen?

Eine Woche ausprobieren

Kleinpaket für $4: $30 Kontingent, 7 Tage gültig

Täglich im Einsatz

Starter für $9.00 pro Monat mit $5 Kontingent pro Tag: nur etwa $0.060 pro $1 Kontingent, beim Mittelpaket etwa $0.113