Claude Code: Ratenlimits, 500-Fehler, 529-Überlastung und API-Schlüssel prüfen
Ein Leitfaden zu API-Schlüsseln, Pro oder Max im Vergleich zur API-Abrechnung, Messages-kompatiblen Endpunkten, Ratenlimits, Serverfehlern und überlasteten Routen.
Fragen für die Fehlerdiagnose
Community-Diskussionen liefern Anhaltspunkte. Tatsächliche Limits, Kontostatus und Fehlerbedeutung prüfen Sie anhand offizieller Dokumentation und Ihrer Anfrageprotokolle.
Ratenlimit während der Programmierung erreicht
Kommt das Limit vom Konto, Arbeitsbereich, Modellpfad oder Gateway?
Kontolimits prüfen, dann Parallelität und Kontext verringern und erneut versuchen.API-Schlüssel oder Pro-/Max-Abonnement
Verwendet die aktive Authentifizierung das Abonnement oder die API-Abrechnung?
Abonnementzugang und API-Abrechnung getrennt prüfen, sofern der Anbieter sie nicht ausdrücklich verknüpft.500 oder 529 in Agentenschleifen
Ist der Anbieter überlastet, die Gateway-Route gestört oder die Wiederholungsschleife fehlerhaft?
Vor Änderungen Status, Anfrage-ID, Route, Modell, Tokenmenge und Wiederholungen protokollieren.Beim Statuscode beginnen
Schlüssel- und Berechtigungsprobleme, Kontingente, Serverfehler und Überlastung unterscheiden, bevor Sie eine Maßnahme wählen.
Ratenlimit erreicht
Konto, Arbeitsbereich, Modell oder Route überschreitet ein Anfrage- oder Tokenlimit.
- Weniger parallele Agenten
- Langen Kontext kürzen
- Mit wachsender Wartezeit wiederholen
- Kontingent und Modelllimits prüfen
API-Serverfehler
Anbieter oder Route meldet einen serverseitigen Fehler. Wiederholte Fehler erfordern Routenprotokolle.
- Anfrage-ID festhalten
- Nach Wartezeit einmal wiederholen
- Bei Wiederholung andere Route vergleichen
- Nicht zuerst Prompts umschreiben
Überlastung
Der Upstream-Dienst ist stark ausgelastet. Ein neuer API-Schlüssel behebt dies normalerweise nicht.
- Warten und Abstände erhöhen
- Ersatzmodell versuchen
- Anfrage verkleinern
- Status- und Supportkanäle prüfen
API-Schlüssel oder Berechtigung
Der aktive Schlüssel ist möglicherweise falsch oder nicht für Modell oder Endpunkt berechtigt.
- ANTHROPIC_API_KEY prüfen
- Basis-URL kontrollieren
- Modellzugriff bestätigen
- Aktive Abrechnungsquelle prüfen
Vor Codeänderungen die Fakten sammeln
- Exakten Fehler, HTTP-Status, Modell, Endpunkt und Zeitpunkt notieren.
- Direkten Anthropic-Schlüssel oder kompatibles Gateway als Zugang klären.
- API-Abrechnung und Kontingent getrennt vom Pro-/Max-Abonnement prüfen.
- Bei 429 zuerst Parallelität und Kontextgröße senken.
- Bei 500 oder 529 nach Wartezeit einmal wiederholen, dann andere Route oder Ersatzmodell vergleichen.
- Beim Gateway Messages-Endpunkt, Modellroute, Cache-Verhalten und Supporthinweise prüfen.
Pro-/Max-Zugang ist nicht die API-Abrechnung
Aktiven Schlüssel, Basis-URL und Abrechnungsquelle prüfen. Abonnementzugang und API-Guthaben teilen nicht automatisch denselben Saldo.
API-Zugang erhaltenGateway im Einsatz? Messages-Endpunkt prüfen
Claude-kompatible Clients benötigen den passenden Messages-Endpunkt, einen gültigen Schlüssel und eine für die Aufgabe geeignete Modellroute.
Dokumentation prüfenClaude-Code-API-Fehler
Warum meldet Claude Code ein Ratenlimit?
Ein Anfrage-, Token- oder Modellroutenlimit wurde überschritten. Aktiven Schlüssel, Arbeitsbereich, Route, Kontext und parallele Agenten prüfen.
Enthält Pro oder Max einen API-Schlüssel?
Abonnementzugang und API-Abrechnung getrennt betrachten, sofern die offizielle Kontoseite nichts anderes angibt. Aktive Authentifizierung und Abrechnungsquelle prüfen.
Was tun bei API Error 500?
Anfrage-ID notieren und nach Wartezeit einmal wiederholen. Bei weiteren Fehlern Route vergleichen oder Support mit Zeitpunkt, Modell und Anfrage-ID kontaktieren.
Was bedeutet 529 overloaded?
Der Upstream-Dienst ist überlastet. Warten, Abstände erhöhen, Anfrage verkleinern oder Ersatzroute nutzen. Ein anderer Schlüssel behebt die Überlastung selbst meist nicht.
Aktuelle Regeln überprüfen
Offizielle Dokumentation ist maßgeblich für Limits und Fehlerbedeutungen. Community-Diskussionen liefern Hinweise, ersetzen aber keine geprüften Fakten.