Was 529 Overloaded tatsächlich bedeutet
Stand 2026-10-20 gilt: 529 Overloaded bedeutet, dass die API von Claude vorübergehend ausgelastet ist – laut offizieller Fehlerreferenz betrifft dieser Kapazitätszustand alle Nutzer, nicht nur Sie, und er wird nicht auf Ihr Kontingent angerechnet. Bei der erneuten Prüfung kommen die Retry-Vorgabewerte hinzu, die die offizielle Dokumentation nennt: CLAUDE_CODE_MAX_RETRIES steht standardmäßig auf 10 (Obergrenze 15 seit 2.1.186), die Basisverzögerung für 529-Wiederholungen liegt standardmäßig bei 500 ms (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, bis 32000 anhebbar), die Obergrenze des Backoffs bei 32000 ms (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, bis 64000 anhebbar). Eine Änderung an Ihrem Code hilft nicht; eine Änderung Ihrer Retry-Strategie schon.
Aktualisiert 2026-10-20
Ein Key für Claude, GPT und führende chinesische Modelle, Bezahlung pro Token, in wenigen Minuten startklar.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Vier Punkte
Überlastung beim Modellanbieter
Wird zurückgegeben, wenn die serverseitige Kapazität knapp ist. Unabhängig vom Kontingent Ihres Keys, Ihren Parametern oder dem Request-Body. Die offizielle Fehlerreferenz hält fest, dass ein 529 alle Nutzer gleichzeitig betrifft: Das liegt beim Modellanbieter, nicht bei Ihnen.
Sie werden per Rate Limit gedrosselt
Dieser Fehler bedeutet, dass Sie Ihre eigene Rate oder Ihr eigenes Kontingent überschritten haben. 529 und 429 erfordern unterschiedliche Behandlung – teilen Sie sich keinen Codepfad. Ein Detail aus der offiziellen Dokumentation wird leicht übersehen: Meldet ein 429 ein Ausgabelimit oder erschöpfte Nutzungsguthaben, schlägt Claude Code sofort fehl, ohne erneut zu senden – bei einem 529 ist es genau umgekehrt.
Die einzige wirksame Maßnahme auf Client-Seite
Exponentielles Backoff mit Jitter. Sofortige Wiederholungen verschärfen die Überlastung und führen schneller zu einem Rate Limit. Die offizielle Dokumentation nennt für 529-Wiederholungen eine Basisverzögerung von standardmäßig 500 ms (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS) und eine Backoff-Obergrenze von standardmäßig 32000 ms (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS).
Strukturelle Entschärfung
Wenn dieselbe Arbeit bei einer anderen Modellfamilie landen kann, bedeutet ein überlasteter Modellanbieter keinen Ausfall mehr. Der Preis dafür: Sie müssen Unterschiede zwischen den Modellen in Kauf nehmen.
Wie sich 529 von 429 und 503 unterscheidet
Stand 2026-10-20 bedeutet 529, dass der Server gerade überlastet ist – ein Kapazitätsproblem, meist vorübergehend; die offizielle Fehlerreferenz hält fest, dass dieser Zustand alle Nutzer gleichzeitig betrifft, nicht nur Sie, und nicht auf Ihr Kontingent angerechnet wird. 429 bedeutet, dass Sie Ihre eigene Rate- oder Kontingentgrenze erreicht haben – ein Kontingentproblem; laut offizieller Dokumentation schlägt ein 429, der ein Ausgabelimit oder erschöpfte Nutzungsguthaben meldet, sofort fehl, ohne erneuten Versuch. 503 bedeutet in der Regel, dass der Dienst nicht verfügbar ist oder gewartet wird. Keiner dieser Codes heißt, dass Ihre Anfrage fehlerhaft war, aber die Behandlung unterscheidet sich: Bei 529 sind Backoff und Wiederholung angebracht, bei 429 langsameres Senden oder höhere Limits, bei 503 Abwarten und ein Blick auf die Statusseite. Alle drei in einem einzigen catch-Block zusammenzufassen, ist der häufigste Fehler bei der Fehlerbehandlung.
Warum die Diskussion regelmäßig wieder aufflammt
Immer wenn ein neues Modell erscheint oder eine große Migration stattfindet, wird die Kapazität beim Modellanbieter für eine Weile knapp, und die Diskussion über 529 nimmt zu. Diese Wellen klingen meist ab, sobald Kapazität hinzukommt – für jemanden mit einer Deadline ist das Warten auf den Ausbau durch den Anbieter aber keine Option. Auf der offiziellen Statusseite sind für 2026-10 zwei überprüfbare Einträge vermerkt: Am 2026-10-07 führte ein Problem mit Ausgabelimits dazu, dass einige Organisationen fälschlich als limit erreicht pausiert wurden und Anfragen an die Claude API, Claude Code und die übrigen Claude-Oberflächen abgelehnt wurden – der Eintrag ist als behoben markiert; am 2026-10-13 hieß es zum Vorfall mit Nutzungsdaten auf platform.claude.com ausdrücklich, dass API-Anfragen nicht betroffen waren. Beide Einträge betreffen Ausgabelimits und Nutzungsdaten, nicht Kapazität. Claude Code brachte am 2026-10-08 und am 2026-10-09 zwei Versionen hintereinander: 2.1.295 brachte eine Obergrenze für die Gesamtwartezeit im unbeaufsichtigten Wiederholungsmodus, 2.1.296 eine einstellbare Obergrenze des Backoffs für 529; die neueste Version ist 2.1.304 vom 2026-10-19.
Reihenfolge der Diagnose
Bestätigen Sie, dass der Statuscode wirklich 529 und nicht 429 ist. Die Response-Bodys unterscheiden sich; zählen Sie beide in Ihren Logs getrennt.
Prüfen Sie die Statusseite des Anbieters. Bei einem breiten Vorfall ist jede Änderung auf Client-Seite bestenfalls eine Linderung. Die offizielle Statusseite führt Claude API (api.anthropic.com) und Claude Code als zwei getrennte Komponenten, prüfen Sie also, welche betroffen ist; am 2026-10-20 zeigen alle Komponenten auf der Seite einen funktionierenden Zustand.
Prüfen Sie, ob Ihre eigene Retry-Logik die Überlastung verstärkt: fehlender Jitter, fehlende Obergrenze und sofortige Wiederholung verstärken sie alle. In Claude Code lässt sich seit Version 2.1.292 (2026-10-06) die Basisverzögerung für 529-Wiederholungen mit CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS verlängern; seit 2.1.295 (2026-10-08) begrenzt CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS die Gesamtwartezeit für 429 und 529 im unbeaufsichtigten Wiederholungsmodus; seit 2.1.296 (2026-10-09) lässt sich mit CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS die Obergrenze des Backoffs anheben.
Klären Sie vor dem erneuten Versuch, welchen Code Sie tatsächlich erhalten haben
Was gesichert ist
Ein 529 signalisiert eine serverseitige Kapazitätsüberlastung und hat nichts mit dem Inhalt der Anfrage zu tun – diese Semantik ist in der Dokumentation der Modellhersteller festgehalten. Die offizielle Fehlerreferenz von Claude Code (geprüft am 2026-10-20) zeigt die Meldung „API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary.“ und hält fest: „A 529 is not your usage limit and doesn't count against your quota.“ Ein 529 ist also nicht Ihr Nutzungslimit und wird nicht auf Ihr Kontingent angerechnet. Da die Kapazität pro Modell erfasst wird, können Sie mit /model auf ein anderes Modell wechseln und weiterarbeiten; außerdem betrifft ein 529 alle Nutzer gleichzeitig. Dieselbe Fehlerreferenz nennt die Vorgabewerte für Wiederholungen: CLAUDE_CODE_MAX_RETRIES steht standardmäßig auf 10 (Obergrenze 15 seit 2.1.186), CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS auf 500 ms (anhebbar bis 32000), CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS auf 32000 ms (anhebbar bis 64000), und CLAUDE_CODE_RETRY_WATCHDOG mit dem Wert 1 wiederholt Kapazitätsfehler 429 und 529 ohne feste Obergrenze. Laut Claude-Code-CHANGELOG sendet ein fehlschlagender Modellaufruf seit 2.1.286 mit den Standard-Retry-Einstellungen höchstens 14 Anfragen, 2.1.292 hat CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS hinzugefügt, 2.1.295 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS und 2.1.296 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS. Exponentielles Backoff mit Jitter ist eine vielfach bewährte clientseitige Reaktion.
Nicht als Tatsache behandeln
Für einen 529 nennt die Fehlerreferenz drei umsetzbare Schritte: die Statusseite auf Kapazitätsmeldungen prüfen, in ein paar Minuten erneut versuchen und mit /model auf ein anderes Modell wechseln; sie hält außerdem fest, dass ein 529 alle Nutzer gleichzeitig betrifft und die Kapazität pro Modell geführt wird. Die Annahme, der Anbieter drossle aktive Nutzer stillschweigend, hat keine Grundlage, und wer 529 mit 429 vermischt, greift zur falschen Abhilfe.
Zwei Reaktionen
Nur Backoff auf Client-Seite
Einfach umzusetzen und senkt die Zahl der Fehlschläge messbar. Solange der Modellanbieter jedoch überlastet bleibt, können Sie nur abwarten.
Arbeit auf mehrere Modellfamilien verteilen
Ein überlasteter Anbieter bedeutet nicht mehr automatisch Ausfall. Der Preis dafür: Sie müssen unterschiedliche Eigenheiten der Modelle in Kauf nehmen, und jede Route hat ihre eigenen Fehlerbilder. Mehrere Routen sind eine Abmilderung, keine Beseitigung: Auch der Wechselmechanismus selbst kann ausfallen.
Retries richtig umsetzen
Drei Punkte. Erstens: exponentielles Backoff statt eines festen Intervalls – eine Sekunde warten, dann jedes Mal verdoppeln. Zweitens: zufälligen Jitter hinzufügen – wenn alle Clients gleich lange warten, wiederholen sie synchron in einer Welle, was die Überlastung verlängert. Drittens: Obergrenzen sowohl für die Anzahl der Wiederholungen als auch für die Gesamtwartezeit setzen, sonst wächst Ihre Aufgabenwarteschlange bei einer einzigen Überlastung unbegrenzt. Außerdem gilt: Bricht eine Streaming-Anfrage mittendrin ab, wiederholen Sie nicht blind von vorn, sondern prüfen Sie zuerst, ob sich das bereits Empfangene fortsetzen lässt. Wenn Sie Claude Code nutzen: Laut Dokumentation wiederholt es vorübergehende Fehler automatisch bis zu 10 Mal mit exponentiellem Backoff, bevor es einen Fehler anzeigt (erneut geprüft am 2026-10-20); Version 2.1.286 (GitHub-Release vom 2026-09-30) hat die Zählung der Wiederholungen geändert – laut Changelog deckt ein Limit den ganzen Modellaufruf ab, und mit den Standardeinstellungen sendet ein fehlschlagender Aufruf höchstens 14 Anfragen; Version 2.1.292 (GitHub-Release vom 2026-10-06) hat die Umgebungsvariable CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS eingeführt, um für Wiederholungen nach einem 529 eine längere Basisverzögerung des Backoffs festzulegen; Version 2.1.295 (GitHub-Release vom 2026-10-08) hat CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS eingeführt, die die Gesamtwartezeit für 429 und 529 im unbeaufsichtigten Wiederholungsmodus begrenzt; Version 2.1.296 (GitHub-Release vom 2026-10-09) hat CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS eingeführt, um die Obergrenze des Backoffs bei 529 anzuheben. Die offizielle Fehlerreferenz nennt inzwischen auch die Vorgabewerte: CLAUDE_CODE_MAX_RETRIES steht standardmäßig auf 10 (Obergrenze 15 seit 2.1.186), CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS auf 500 ms (anhebbar bis 32000), CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS auf 32000 ms (anhebbar bis 64000), und CLAUDE_CODE_RETRY_WATCHDOG mit dem Wert 1 wiederholt Kapazitätsfehler 429 und 529 ohne feste Obergrenze.
Was QCode hier leisten kann und was nicht
Was möglich ist: Mit einem Key wechseln Sie bei Überlastung zu einer anderen Modellfamilie, statt auf die Erholung eines einzelnen Modells zu warten. Was nicht möglich ist: Wir sind nicht der Modellhersteller und können dessen Serverkapazität nicht ändern; auch Anfragen über QCode können fehlschlagen. Wir bieten die Möglichkeit, die Modellfamilie zu wechseln, kein Versprechen makelloser Verfügbarkeit.
FAQ
Sollte ich meine Anfrageparameter ändern, wenn ich einen 529 erhalte?
Nein. 529 hat nichts mit dem Inhalt der Anfrage zu tun; weder das Ändern von max_tokens oder von Modellparametern noch das Kürzen des Prompts lässt den Fehler verschwinden. Ändern Sie stattdessen die Retry-Strategie.
Kann ich für 529 und 429 dieselbe Retry-Logik verwenden?
Nicht empfehlenswert. Bei 529 sollten Sie abwarten und dieselbe Anfrage erneut senden; 429 bedeutet, dass Sie Ihre Senderate senken oder Ihre Limits erhöhen müssen – blinde Wiederholungen lösen das Limit immer wieder aus.
Wie lange sollte ich warten?
Üblich ist ein Start bei einer Sekunde, die sich mit jedem Versuch verdoppelt, mit zufälligem Jitter sowie Obergrenzen für die Zahl der Wiederholungen und die Gesamtwartezeit. Die genauen Werte hängen davon ab, wie viel Latenz Ihre Aufgabe verträgt. In Claude Code (offizielle Fehlerreferenz und CHANGELOG, Stand 2026-10-20): CLAUDE_CODE_MAX_RETRIES legt die Zahl der Wiederholungen fest, Standard 10 (Obergrenze 15 seit 2.1.186); seit 2.1.286 sendet ein fehlschlagender Modellaufruf mit den Standardeinstellungen höchstens 14 Anfragen; seit 2.1.292 können Sie mit CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS eine längere Basisverzögerung für Wiederholungen nach einem 529 festlegen (die offizielle Dokumentation nennt 500 ms als Standard, anhebbar bis 32000); seit 2.1.295 begrenzt CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS die Gesamtwartezeit für 429 und 529 im unbeaufsichtigten Wiederholungsmodus; seit 2.1.296 können Sie mit CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS die Obergrenze des Backoffs anheben (die offizielle Dokumentation nennt 32000 ms als Standard, anhebbar bis 64000); mit CLAUDE_CODE_RETRY_WATCHDOG auf 1 werden Kapazitätsfehler 429 und 529 ohne feste Obergrenze wiederholt.
Was ist, wenn eine Streaming-Anfrage mittendrin einen 529 erhält?
Prüfen Sie zuerst, ob das bereits Empfangene brauchbar ist. Wenn ja, setzen Sie fort; nur wenn nicht, wiederholen Sie die gesamte Anfrage. Ein blinder Neustart verursacht doppelte Abrechnung und verschärft die Überlastung.
Bekommt auch QCode 529-Fehler?
Ja, das kann vorkommen. Die Überlastung bei den Modellherstellern ist real, und auch wir sind davor nicht gefeit. Wir können dieselbe Arbeit auf eine andere Modellfamilie verlagern – wir versprechen aber nicht, dass keine Fehler auftreten.
Was bedeutet 529 overloaded, und warum tritt der Fehler auf, obwohl mein Kontingent unverändert ist?
529 Overloaded ist ein Kapazitätszustand beim Modellanbieter: Die offizielle Fehlerreferenz hält fest, dass ein 529 eine für alle Nutzer gleichzeitig volle Kapazität bedeutet, nicht Ihr Nutzungslimit, und nicht auf Ihr Kontingent angerechnet wird – ein unverändertes Kontingent ist also zu erwarten. Die Kapazität wird pro Modell geführt, Sie können mit /model auf ein anderes Modell wechseln und weiterarbeiten; offiziell empfohlen ist, in ein paar Minuten erneut zu versuchen und die Statusseite auf Kapazitätsmeldungen zu prüfen. Ein höheres Kontingent oder andere Parameter lösen das nicht. Mehrere Routen senken die Wahrscheinlichkeit, dass ein einzelner Ausfall Ihre Arbeit stoppt, aber jede Route hat ihre eigenen Fehlerbilder, und auch der Wechselmechanismus selbst kann ausfallen. Das ist eine Abmilderung, keine Beseitigung.
Quellen
Die Semantik der Statuscodes folgt der offiziellen API-Dokumentation des jeweiligen Modellherstellers. Das Retry-Verhalten von Claude Code und CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS sowie CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS stammen aus dem Claude-Code-CHANGELOG von Anthropic (Einträge 2.1.286, 2.1.292, 2.1.295 und 2.1.296), den GitHub-Release-Seiten dieser Versionen, der Fehlerreferenz und der Dokumentation zu den Umgebungsvariablen von Claude Code sowie der offiziellen Statusseite mit Komponentenliste und Vorfallshinweisen, alle am 2026-10-20 abgerufen und geprüft. Verfügbarkeitsquoten von Dritten nennen wir bewusst nicht – solche Zahlen ändern sich im Lauf der Zeit, und wir haben keine verlässliche unabhängige Messung, auf die wir verweisen könnten.
Wenn eine Route überlastet ist, nehmen Sie eine andere
Ein Key für mehrere Modellfamilien – wechseln Sie und arbeiten Sie weiter, wenn eine Route unter Druck steht.
Weiterführende Artikel
Claude Code FAQ und Fehlerbehandlung
Antworten auf häufige Fragen bei der Nutzung von Claude Code: Einstieg, Preise und Kontingente, Fehlersuche.
Claude Code Nutzungslimits
Das 5-Stunden-Fenster vom Wochenkontingent unterscheiden und was nach Erreichen des Limits gilt.
Multi-Modell-Routing
Entscheidungsmatrix für die Wahl und den Wechsel zwischen Modellfamilien mit einem Key.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Die Semantik der Statuscodes folgt hier der offiziellen Dokumentation des jeweiligen Modellherstellers und kann sich zwischen Versionen ändern; die Angaben zu Claude Code wurden am 2026-10-20 mit dem offiziellen CHANGELOG und der Dokumentation abgeglichen, die maßgeblich bleiben. Nichts auf dieser Seite ist eine Verfügbarkeitszusage.