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

Claude Code
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üfungWenn jaDann
Andere Anfragen haben vorhin mit derselben Konfiguration funktioniertKapazität des AnbietersErneut versuchen oder Modell wechseln
Nur ein Modell schlägt fehl, andere funktionierenDieses Modell ist ausgelastetVorerst ein anderes Modell nutzen
Jede Anfrage schlägt mit 401, 404 oder Verbindungsfehlern fehlKein 529-ProblemSiehe die verwandten Fehlerseiten unten

Schritt-für-Schritt-Lösung

  1. 1. Erneut versuchen

    Sende die Nachricht nach einer kurzen Pause erneut. Claude Code behält die Konversation, es geht nichts verloren.

  2. 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. 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. 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).

Modellstatus und PreiseSupport kontaktierenDokumentation

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 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.