HTTP 429 ohne retry-after
error_code enforced_spend_limit_reached
Geprüft anhand der Anthropic-Dokumentation am 2026-08-30: Die monatlichen Ausgabenlimits für Start / Build / Scale betragen $500 / $1,000 / $200,000. Sobald das Limit erreicht ist, geben Anfragen weiterhin HTTP 429 mit dem type rate_limit_error zurück, aber es gibt keinen retry-after-Header. Wiederholungen schlagen bis 00:00 UTC am ersten Tag des nächsten Monats weiter fehl.
Aktualisiert 2026-09-21
Vier Fakten, die Sie einzeln zitieren können
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.
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.
Monatliche Limits für Start / Build / Scale
Diese drei Dollarbeträge sind die dokumentierten monatlichen Limits. Organisationen mit Custom-Stufe haben kein öffentliches Limit; es wird mit dem Account-Team vereinbart.
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
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.
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.
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-08-30 abgerufene Anthropic-Dokumentation bestätigt: Ein 429 durch das Ausgabenlimit der Stufe verwendet weiterhin den type rate_limit_error, enthält kein retry-after und setzt in der Messages API error.details.error_code auf enforced_spend_limit_reached. Die Limits betragen $500 / $1,000 / $200,000. Ein vom Nutzer 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 mit „You have reached your specified API usage limits“ beginnt, ist das von Ihnen selbst gesetzte Limit. Das wöchentliche Kontingent von Claude Code ist meist ein Produkttext wie „You've hit your weekly limit“ und nicht dieser API-error_code. Erhöhen Sie zuerst den Tarif oder das Billing-Limit innerhalb derselben Organisation. Diese Seite beschreibt keine Umgehung der Anthropic-Authentifizierung oder der Ausgabenkontrollen.
Dieser Fehler stammt nicht aus dem Ledger von QCode
enforced_spend_limit_reached ist an den Monatstarif einer Anthropic-Console-Organisation gebunden, nicht an das Guthaben eines Resellers. QCode zieht ein vorausbezahltes Guthaben zum offiziellen Preis × einem Service-Multiplikator ab, auf einem anderen Abrechnungsweg. Diese Seite behauptet nicht, dass QCode nie drosselt. Wenn Ihre eigene Anthropic-Organisation bis zum 1. gesperrt ist und der Job nicht warten kann, ist das Weiterleiten über einen anderen bereits eingerichteten API-Key ein technischer Fallback und kein Weg, die Regeln von Anthropic zu umgehen.
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-08-30 abgerufene Dokumentation nennt Start $500, Build $1,000, Scale $200,000 USD pro Kalendermonat. Custom hat kein öffentliches Limit. 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, fehlendes retry-after, error_code enforced_spend_limit_reached und der HTTP-400-Fehler bei einem vom Nutzer gesetzten Ausgabenlimit stammen von der Rate-Limits-Seite von Anthropic unter platform.claude.com/docs/en/api/rate-limits, abgerufen am 2026-08-30. Der Beispielsatz „You have reached your API usage limits: your organization has crossed its monthly API usage threshold“ ist das JSON-Beispiel auf dieser 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-08-30). Es wird keine unveröffentlichte interne Konfiguration zitiert.
Wenn eine Console-Organisation ihr Limit erreicht hat, muss die Lieferung nicht bis zum 1. warten
Das ist die Abrechnung der Anthropic-Organisation, kein defekter Key. Wenn Sie einen zweiten Abrechnungsweg brauchen, ist vorausbezahltes Guthaben zum offiziellen Preis × einem Service-Multiplikator eine Option.
Verwandte Themen
529 vs. 429 vs. Weekly Limit
Die beiden anderen Fehler, die nach Kontingent aussehen: Überlastung beim Anbieter, Drosselung pro Minute, Wochenlimit im Abo.
Claude-Nutzungslimit erreicht
Das 5-Stunden-Fenster und das Wochenkontingent im Abo-Produkt – nicht dieses Dollar-Limit der API.
Claude Weekly Limit 2026
Wochenkontingent und Zeitplan des +50-%-Boosts, damit Sie es nicht mit dem Reset zum Kalendermonat verwechseln.
Technische Auslegung der öffentlichen Anthropic-Dokumentation, keine Aussage von Anthropic. Tarif, Limit und Wiederaufnahmezeit sind das, was Ihre Claude Console und der Fehlertext angeben. QCode umgeht weder die Anthropic-Authentifizierung noch Missbrauchskontrollen oder Ausgabenlimits.