Claude Code · Fehlerbehebung
Claude Code API-Fehler 529 overloaded: Ursachen und Lösungen
Ein 529 bedeutet, dass die Anfrage die API erreicht hat, das Modell aber in diesem Moment keine freie Kapazität hatte. Es ist kein Problem mit deinem Schlüssel oder deiner Konfiguration und verschwindet in der Regel von selbst. So unterscheidest du ihn von anderen Fehlern und arbeitest weiter.
Zuletzt geprüft
Der Fehlertext
API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}Was er bedeutet
Die API hat deinen Schlüssel und deine Anfrage akzeptiert, aber das Modell war überlastet und konnte sie nicht annehmen. Lastspitzen sind kurz und an ein bestimmtes Modell gebunden, weshalb ein Modellwechsel oder eine Minute Wartezeit in der Regel hilft.
| Prüfung | Wenn ja | Dann |
|---|---|---|
| Andere Anfragen haben vorhin mit derselben Konfiguration funktioniert | Kapazität des Anbieters | Erneut versuchen oder Modell wechseln |
| Nur ein Modell schlägt fehl, andere funktionieren | Dieses Modell ist ausgelastet | Vorerst ein anderes Modell nutzen |
| Jede Anfrage schlägt mit 401, 404 oder Verbindungsfehlern fehl | Kein 529-Problem | Siehe die verwandten Fehlerseiten unten |
Schritt-für-Schritt-Lösung
1. Erneut versuchen
Sende die Nachricht nach einer kurzen Pause erneut. Claude Code behält die Konversation, es geht nichts verloren.
2. Modell wechseln
Führe /model aus und wähle ein anderes Claude-Modell (zum Beispiel Sonnet statt Opus), um die Aufgabe abzuschließen, und wechsle später zurück.
3. Kanal wechseln
Auf aicodewith zeigt jede Modellseite den Kanalstatus. Wenn ein Kanal ausgelastet ist, wähle für deinen Schlüssel einen anderen.
4. Endpoint prüfen
Führe /status aus und bestätige, dass der Endpoint api.aicodewith.ai ist. Ein falscher Endpoint zeigt andere Fehler, aber es ist sinnvoll, ihn auszuschließen.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }
So vermeidest du es
- Nutze Sonnet oder Haiku für Routineaufgaben und hebe Opus für schwierige Probleme auf; Lastspitzen treffen zuerst die größten Modelle.
- Führe in Stoßzeiten weniger parallele Subagenten aus.
- Lass CI-Jobs mit Backoff erneut versuchen, anstatt den Job beim ersten 529 fehlschlagen zu lassen.
Werden fehlgeschlagene Anfragen berechnet?
Fehlgeschlagene Anfragen (4xx/5xx, Timeouts, unterbrochene Verbindungen) werden nicht berechnet – abgerechnet werden nur Anfragen, die erfolgreich abgeschlossen werden. Wenn ein Fehler des Anbieters automatisch erneut versucht wird und gelingt, wird nur einmal abgerechnet.
Schlägt es weiterhin fehl?
- Prüfe die Modellseite auf aicodewith: Dort siehst du den aktuellen Status jedes Kanals.
- Schau die Anfrage in deinem Dashboard unter den Nutzungsaufzeichnungen nach, um Modell, Status und Kosten zu sehen.
- Sende eine E-Mail an support@aicodewith.com mit dem Zeitpunkt des Fehlers, dem Modell und dem Fehlertext (niemals deinen vollständigen API-Schlüssel).
FAQ
Was bedeutet der Fehler 529 in Claude Code?
Das Modell war überlastet und konnte die Anfrage in diesem Moment nicht annehmen. Dein Schlüssel und deine Konfiguration sind in Ordnung; versuche es erneut, wechsle das Modell mit /model oder wechsle den Kanal.
Ist 529 dasselbe wie 429?
Nein. 529 bedeutet Kapazitätsmangel auf der Modellseite. 429 bedeutet, dass deine eigenen Anfragen ein Rate- oder Parallelitätslimit überschritten haben.
Kann ich eine weniger ausgelastete Option wählen?
Ja. Jede Modellseite listet ihre Kanäle mit aktuellem Status auf; wähle einen Kanal, der nicht überlastet ist, oder ein anderes Modell.
Wie lange dauert ein 529 an?
Meist Sekunden bis Minuten. Wenn es bei einem Modell anhält, wechsle zu einem anderen Modell oder Kanal.
Wiederholt Claude Code das automatisch?
Ja, Claude Code wiederholt überlastete Fehler selbstständig. Der Fehler wird angezeigt, wenn die Wiederholungsversuche aufgebraucht sind.
Werden mir fehlgeschlagene Anfragen berechnet?
Fehlgeschlagene Anfragen (4xx/5xx, Timeouts, unterbrochene Verbindungen) werden nicht berechnet – abgerechnet werden nur Anfragen, die erfolgreich abgeschlossen werden. Wenn ein Fehler des Anbieters automatisch erneut versucht wird und gelingt, wird nur einmal abgerechnet.
Bereit zum Ausprobieren?
Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben. Es gelten Limits für Rate und Parallelität, und du kannst für jeden API-Schlüssel tägliche, monatliche oder gesamte Ausgabenlimits festlegen.
Ähnliche Themen
Quellen
- Claude-Code-Dokumentation: Fehler
- Claude-Code-Dokumentation: Einstellungen
- Anthropic-API-Dokumentation: Fehler
Claude und Claude Code sind Marken von Anthropic PBC. aicodewith ist eine unabhängige Plattform und nicht mit Anthropic verbunden oder von Anthropic befürwortet. Die Fehlerformate werden aus Claude Code zitiert und können sich ändern. Geprüft am 2026-10-10.