Rate Limits in Claude Code: Abo-Limits und API-429 unterscheiden

Was ein Rate Limit in Claude Code bedeutet

Claude Code unterstützt zwei grundsätzlich verschiedene Anmeldemethoden:

• Abo (Pro, Max, Team oder Enterprise): Anmeldung über Claude.ai OAuth. Claude Code und andere Claude-Oberflächen nutzen den gemeinsamen Pool des Plans; aktuelle Zeitfenster und weitere Einschränkungen stehen in /usage und den Kontoeinstellungen.
• API-Key (ANTHROPIC_API_KEY in der Umgebung): Anfragen gehen direkt an api.anthropic.com. Es gelten die RPM-, ITPM- und OTPM-Limits der Workspace-Stufe in der Anthropic Console.

Ist ANTHROPIC_API_KEY gesetzt, hat er Vorrang vor dem Abo. Claude Code verwendet dann den API-Key, auch wenn Sie mit einem Abo angemeldet sind – eine häufige Ursache für Verwirrung.

Müssen Sie wissen, ob die Anfrage einen Drittanbieter-Endpunkt erreicht hat? BetterToken fügt eine weitere Diagnoseebene hinzu: Im Dashboard sehen Sie Anfragestatus, Modell, Input-/Output-/Cache-Token und die zugehörige Belastung. So lässt sich ein Provider-Limit von einem Anthropic-API-Fehler unterscheiden. Hinweise zur Einrichtung von Base URL und API-Key finden Sie in der BetterToken-Dokumentation; gleichen Sie die Konfiguration mit Ihrem aktuellen Workflow ab.

So erkennen Sie ein Abo-, Anthropic-API- oder anderes Endpunkt-Limit

Führen Sie zuerst /status in Claude Code aus. Die Ausgabe zeigt die aktuelle Anmeldung: Abo-Konto oder API-Key. Davon hängt ab, wo Sie weiter suchen.

• Pro-/Max-/Team-Abo: /status zeigt ein Abo, und die Meldung nennt ein Sitzungs- oder Wochenlimit samt Rücksetzzeit. Die Plan-Nutzung ist aufgebraucht. Warten Sie auf das Zurücksetzen und prüfen Sie /usage, bei Verfügbarkeit auch /usage-credits.
• Anthropic API 429: /status zeigt einen API-Key, ANTHROPIC_API_KEY ist in der Umgebung vorhanden, und die Antwort enthält HTTP 429 oder rate_limit_error. RPM, ITPM oder OTPM der gewählten Stufe sind begrenzt. Prüfen Sie zuerst retry-after und verringern Sie die Parallelität.
• Endpunkt eines Drittanbieters: Eine eigene Base URL und ein Provider-Key sind aktiv; Code und Antwortformat können von Anthropic abweichen. Die Quote des jeweiligen Providers ist begrenzt. Lesen Sie zuerst die Antwort und prüfen Sie dann Statusseite und Quotenbedingungen des Providers.

Behandeln Sie 500 api_error, 504 timeout_error und 529 overloaded_error getrennt. Das sind serverseitige oder vorübergehende Fehler, kein Beleg für ein erschöpftes Abo. Verwenden Sie begrenztes exponentielles Backoff. Jede Anthropic-Antwort enthält im Header eine request-id; Fehler enthalten zusätzlich request_id im JSON. Bewahren Sie diese Kennung für den Support auf.

Schrittweise Diagnose ohne API-Key preiszugeben

Schritt 1. Anmeldemethode prüfen

In einer Claude-Code-Sitzung:

/status

Prüfen Sie „Login method“ oder „Auth token“. Ist ANTHROPIC_API_KEY gesetzt, Sie möchten aber das Abo verwenden, entfernen Sie die Variable zuerst:

unset ANTHROPIC_API_KEY

Starten Sie Claude Code neu und prüfen Sie /status erneut.

Schritt 2. Die vollständige Fehlermeldung lesen

Der genaue Wortlaut ist das wichtigste Diagnosesignal:

• „Resets at [Zeit]“ → Abo-Limit; bis zum Reset warten
• rate_limit_error zusammen mit einem retry-after-Header → API 429; Anthropic Console prüfen
• api_error, timeout_error oder overloaded_error → vorübergehender 5xx-/529-Fehler; mit Backoff wiederholen
• Ein providerspezifisches Format plus nicht standardmäßige Base URL → Problem auf Providerseite

Speichern Sie zusammen mit dem Code einen sicheren Diagnosesatz: Zeit, error.type, request-id/request_id, Claude-Code-Version und gewählten Endpunkt. Fügen Sie weder API-Key noch Authorization-Header oder Inhalte aus .env bei.

Schritt 3. Aktuelle Nutzung prüfen

Für ein Abo:

/usage

Das zeigt die Pro-/Max-Nutzungsanzeigen: was bis zum Reset des Fünf-Stunden-Fensters und bis zur wöchentlichen Obergrenze bleibt. Ein Modellwechsel mit /model stellt bereits verbrauchte Rechenzeit nicht wieder her; die Nutzung wird modellübergreifend geteilt.

Für die API öffnen Sie Anthropic Console → Settings → Limits. Dort sehen Sie Stufe, aktuelle RPM-/ITPM-/OTPM-Limits und Nutzung.

Bei BetterToken öffnen Sie das Dashboard und suchen die Anfrage über die Uhrzeit. Sie können Modell, Status, Input-/Output-/Cache-Token und Belastung prüfen. Das Dashboard zeigt, ob eine Anfrage BetterToken erreicht hat; die Kennung aus Antworttext oder Header sollten Sie trotzdem separat sichern.

Schritt 4. Offiziellen Status prüfen

https://status.anthropic.com/

Ein Vorfall bei Claude Code oder der API erklärt das Problem unabhängig von Ihren Limits.

Schritt 5. Konfigurationskonflikte prüfen

Wenn gleichzeitig ANTHROPIC_API_KEY und ANTHROPIC_BASE_URL gesetzt sind, kann das zu unerwartetem Verhalten führen. Halten Sie nicht zwei Variablensätze für unterschiedliche Anmeldeschemata in derselben Umgebung.

Geben Sie bei einer Support-Anfrage niemals Authorization-Header, x-api-key oder .env-Inhalte in Logs oder Screenshots weiter. Fehlermeldung, HTTP-Code, claude --version und /status ohne Schlüsselwerte reichen aus.

Was nach der Ursachenbestimmung zu tun ist

Abo-Limit (Pro/Max/Team):

• Auf den in /usage und der Fehlermeldung genannten Reset warten.
• Bezieht sich die Meldung auf ein bestimmtes Modell, mit /model ein verfügbares Modell auswählen; das setzt die gesamte Plan-Nutzung nicht zurück.
• Falls Usage Credits verfügbar sind, /usage-credits ausführen und die Einstellungen prüfen.
• Zwischen unabhängigen Aufgaben /clear verwenden, um Kontext zurückzusetzen und den Verbrauch späterer Anfragen zu verringern.

Anthropic API 429 (rate_limit_error):

• retry-after aus der Antwort lesen und genau diesen Zeitraum abwarten.
• Parallelität reduzieren: Gleichzeitige Agent-Aufgaben verbrauchen RPM, ITPM und OTPM schneller.
• Aktuelle Stufe und Limits unter Anthropic Console → Settings → Limits prüfen, statt sich auf alte feste Zahlen zu verlassen.
• Für dauerhaft höheren Bedarf über die Console eine Limiterhöhung bei Anthropic anfragen.

Endpunkt eines Drittanbieters:

• Statusseite des Providers öffnen.
• Aktuelle Quote und Fehlerformat beim Provider erfragen.
• Falls nötig zur direkten Anthropic API oder zu einem anderen Provider wechseln.

5xx / 529:

• Für 500, 504 und 529 begrenztes exponentielles Backoff verwenden; das offizielle SDK wiederholt einige vorübergehende Fehler bereits selbst.
• status.anthropic.com auf einen Vorfall prüfen.
• Hält der Fehler an, dem Support request-id, Zeit und Fehlertyp senden – aber keine Geheimnisse.

Wann warten, Last ändern oder den Support kontaktieren?

• Abo-Limit mit Rücksetzzeit: warten, Modell wechseln oder /clear verwenden.
• API 429 mit retry-after: den angegebenen Zeitraum warten und Parallelität reduzieren.
• Häufige API 429 ohne retry-after: Stufe prüfen und bei Bedarf ein höheres Limit anfragen.
• 500 / 504 / 529: begrenztes exponentielles Backoff anwenden, Servicestatus prüfen und request-id sichern.
• Fehler eines Drittanbieter-Endpunkts: diesen Provider kontaktieren.
• Unklares Limit bei aktivem Abo: Claude.ai-Support kontaktieren.
• Unklares Limit bei aktivem API-Key: Anthropic-Console-Support kontaktieren.

Der Abo-Support und der API-Support sind getrennte Teams. Das Anthropic-API-Console-Team kann ein Pro-/Max-Abo-Limit nicht beheben – und umgekehrt.

FAQ

Warum sehe ich unmittelbar nach Beginn einer Sitzung „rate limit“?

Mögliche Ursachen: (1) Die Umgebung enthält einen ANTHROPIC_API_KEY einer niedrigen Stufe, der Vorrang vor dem Abo hat – prüfen Sie /status. (2) Eine frühere Sitzung hat einen großen Teil des rollierenden Fensters verbraucht; ein Neustart von Claude Code setzt es nicht zurück. (3) Mehrere Geräte oder Agent-Aufgaben verwenden dasselbe Konto, sodass ihre Nutzung zusammengezählt wird.

Hilft ein Modellwechsel mit /model?

Teilweise bei Abos. „You've hit your Opus limit“ bedeutet, dass das Opus-Kontingent erschöpft ist; ein Wechsel zu Sonnet kann die Fortsetzung in derselben Sitzung ermöglichen. Das gemeinsame wöchentliche und Fünf-Stunden-Rechenbudget wird durch den Modellwechsel jedoch nicht wiederhergestellt.

Sollte ich vollständige Logs an den Support schicken?

Nein. Vollständiger Fehlertext, HTTP-Code, /status ohne Schlüsselwerte, claude --version, Zeitpunkt und der damalige Zustand von status.anthropic.com genügen.

Welche dynamischen Limits ändern sich am häufigsten?

API-Stufenlimits (RPM, ITPM und OTPM) sowie die Parameter von Abo-Zeitfenstern können sich ändern. Aktuelle Werte stehen ausschließlich auf den offiziellen Seiten:

• Kosten und Nutzung: code.claude.com/docs/en/costs
• API-Fehler und Rate Limits: platform.claude.com/docs/en/api/errors
• Servicestatus: status.anthropic.com

Vertrauen Sie keinen Zahlen aus Tutorials oder Foren; sie veralten schnell.