Ratenlimit während einer Coding-Sitzung
Konto, Workspace, Modell oder Route sendet mehr Anfragen oder Tokens als zulässig.
Parallele Agenten reduzieren · Langen Kontext kürzenClaude Code API-Fehlersuche
Beheben Sie Limits, 500-Fehler, 529-Überlastung und API-Schlüsselprobleme
Ein Ablauf für API-Schlüssel, Pro oder Max im Vergleich zur API-Abrechnung, Messages-kompatible Endpunkte, Limits, Serverfehler und überlastete Routen.
claude-code-diagnostics
$ claude-code run --model claude-sonnetAPI-Fehler: Ratenlimit erreichtstatus=429 route=messages tokens=128k retries=3weiter: Parallelität senken, Schlüssel prüfen, mit Backoff erneut versuchen
4 Fehlergruppen1 Ablauf0 dünne Seiten
Signale der Community
Was Entwickler in öffentlichen Diskussionen immer wieder fragen
Wiederkehrende Muster aus Reddit und X werden zu stabilen, überprüfbaren Diagnosehinweisen.
API-Schlüssel gegenüber Pro- oder Max-Abo
Prüfen Sie aktiven Schlüssel, Base URL und Abrechnungsquelle. Abo und API-Guthaben müssen nicht denselben Saldo nutzen.
Modellzugriff prüfen · Abo-Anmeldung und API-Abrechnung trennen500 oder 529 in Agentenschleifen
Anbieter oder Route meldet einen Serverfehler. Ein Versuch kann helfen; wiederholte Fehler benötigen Routing-Belege. Der Upstream-Dienst ist stark ausgelastet. Ein anderer API-Schlüssel behebt das meist nicht.
Request-ID erfassen · Backoff anwendenFehlerübersicht
Beginnen Sie mit dem Statuscode, nicht mit Gerüchten
Am schnellsten ist die Trennung von Schlüssel-, Kontingent-, Server- und Überlastungsproblemen.
429
Ratenlimit erreicht
Konto, Workspace, Modell oder Route sendet mehr Anfragen oder Tokens als zulässig.
- Parallele Agenten reduzieren
- Langen Kontext kürzen
- Mit Backoff erneut versuchen
- Kontingent und Modelllimits prüfen
500
API-Serverfehler
Anbieter oder Route meldet einen Serverfehler. Ein Versuch kann helfen; wiederholte Fehler benötigen Routing-Belege.
- Request-ID erfassen
- Einmal erneut versuchen
- Bei Wiederholung Route wechseln
- Prompts nicht als Erstes umschreiben
529
Überlastet
Der Upstream-Dienst ist stark ausgelastet. Ein anderer API-Schlüssel behebt das meist nicht.
- Backoff anwenden
- Ausweichmodell nutzen
- Anfrage verkleinern
- Support-/Statuskanäle prüfen
401/403
API-Schlüssel- oder Berechtigungsproblem
Claude Code nutzt nicht den erwarteten Schlüssel oder dieser hat keinen Zugriff auf Modell oder Endpunkt.
- ANTHROPIC_API_KEY bestätigen
- Base URL prüfen
- Modellzugriff prüfen
- Abo-Anmeldung und API-Abrechnung trennen
Ablauf
Sammeln Sie diese Fakten, bevor Sie Code ändern
- Notieren Sie Fehlertext, HTTP-Status, Modell, Endpunkt und Zeitpunkt.
- Prüfen Sie, ob Claude Code einen direkten Anthropic-Schlüssel oder die Base URL eines kompatiblen Gateways nutzt.
- Prüfen Sie API-Abrechnung und Kontingent getrennt vom Claude Pro- oder Max-Status.
- Reduzieren Sie bei 429 Parallelität und Kontext, bevor Sie den Anbieter wechseln.
- Versuchen Sie bei 500 oder 529 einmal mit Backoff erneut und vergleichen Sie dann Route oder Ausweichmodell.
- Prüfen Sie beim Gateway Messages-Endpunkt, Modellroute, Cache und Supportseite.
Pro oder Max ist nicht dasselbe wie API-Abrechnung
Prüfen Sie aktiven Schlüssel, Base URL und Abrechnungsquelle. Abo und API-Guthaben müssen nicht denselben Saldo nutzen.
API-Zugang erhaltenGateway im Einsatz? Messages-Endpunkt prüfen
Claude Code-artige Clients benötigen meist einen Messages-kompatiblen Endpunkt, einen gültigen API-Schlüssel und eine passende Modellroute.
Dokumentation prüfenHäufige Fragen
Claude Code API-Fehler
Warum meldet Claude Code ein erreichtes Ratenlimit?
Konto, Workspace, Modell oder Route sendet mehr Anfragen oder Tokens als zulässig. Parallele Agenten reduzieren · Langen Kontext kürzen · Mit Backoff erneut versuchen · Kontingent und Modelllimits prüfen
Enthält Claude Pro oder Max einen API-Schlüssel?
Prüfen Sie aktiven Schlüssel, Base URL und Abrechnungsquelle. Abo und API-Guthaben müssen nicht denselben Saldo nutzen.
Was ist bei API-Fehler 500 zu tun?
Anbieter oder Route meldet einen Serverfehler. Ein Versuch kann helfen; wiederholte Fehler benötigen Routing-Belege. Request-ID erfassen · Einmal erneut versuchen · Bei Wiederholung Route wechseln · Prompts nicht als Erstes umschreiben
Was bedeutet Überlastung 529?
Der Upstream-Dienst ist stark ausgelastet. Ein anderer API-Schlüssel behebt das meist nicht. Backoff anwenden · Ausweichmodell nutzen · Anfrage verkleinern · Support-/Statuskanäle prüfen
Quellen
Wo die aktuellen Regeln geprüft werden
Limits und Fehlerbedeutungen sind in offiziellen Dokumenten zu prüfen. Community-Threads zeigen Nachfrage, sind aber nicht die maßgebliche Quelle.