Claude Code · Fehlerbehebung
Claude Code API-Fehler 429 Ratenlimit: So beheben Sie ihn
Ein 429 bedeutet, dass Anfragen schneller oder mehr gleichzeitig eingegangen sind, als es die Raten- und Parallelitätslimits zulassen. Es geht darum, wie Sie Anfragen senden, nicht um Ihr Guthaben oder Ihren Schlüssel.
Zuletzt geprüft
Der Fehlertext
API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"..."}}Was es bedeutet
Pay-as-you-go API-Nutzung hat kein 5-Stunden- oder Wochenkontingent, aber sie hat Raten- und Parallelitätslimits. Wenn eine Anfragespitze diese überschreitet, erhalten die zusätzlichen Anfragen 429 und können kurz darauf erneut versucht werden.
| Nachricht | Was es ist |
|---|---|
| API Error: 429 rate_limit_error | Raten- oder Parallelitätslimit für die API |
| You've hit your session limit · resets ... | Claude Plan-Kontingent; Claude Code ist immer noch mit Ihrem Plan-Login verbunden |
| API Error: 529 overloaded_error | Modellkapazität, nicht Ihre Anfragenrate |
Schritt-für-Schritt-Lösung
1. Parallelität reduzieren
Schließen Sie zusätzliche Claude Code Sitzungen und fordern Sie weniger parallele Subagenten an. Skripte und CI-Jobs, die denselben Schlüssel verwenden, zählen ebenfalls.
2. Warten und erneut versuchen
Machen Sie eine kurze Pause und senden Sie die Nachricht erneut.
3. Schlüssel aufteilen
Geben Sie jedem Teammitglied oder jeder Pipeline einen eigenen Schlüssel, damit ein beschäftigter Job in den Nutzungsdaten leicht zu erkennen ist.
4. Guthaben und Limits prüfen
Wenn der Fehler stattdessen auf ein Guthaben oder ein Ausgabenlimit hinweist, laden Sie auf oder erhöhen Sie das Limit des Schlüssels.
Wie man es vermeidet
- Halten Sie die Anzahl gleichzeitiger Agenten moderat.
- Fügen Sie Wiederholungsversuche mit Backoff zu Skripten und CI hinzu.
- Verwenden Sie /compact und /clear, damit jede Runde weniger Kontext sendet.
Werden fehlgeschlagene Anfragen berechnet?
Fehlgeschlagene Anfragen (4xx/5xx, Timeouts, abgebrochene Verbindungen) werden nicht berechnet — Sie zahlen nur für Anfragen, die erfolgreich abgeschlossen werden. Wenn ein Upstream-Fehler automatisch erneut versucht wird und erfolgreich ist, wird er einmal berechnet.
Immer noch fehlgeschlagen?
- Überprüfen Sie die Modellseite auf aicodewith: Sie zeigt den aktuellen Zustand für jeden Kanal an.
- Suchen Sie die Anfrage in den Nutzungsdaten Ihres Dashboards, um Modell, Status und Kosten zu sehen.
- E-Mail an support@aicodewith.com mit der Uhrzeit des Fehlers, dem Modell und dem Fehlertext (niemals Ihr vollständiger API-Schlüssel).
FAQ
Was bedeutet der Claude Code Fehler 429?
Ihre Anfragen haben ein Raten- oder Parallelitätslimit überschritten. Führen Sie weniger Agenten parallel aus, warten Sie einen Moment und versuchen Sie es erneut.
Gibt es eine feste Anzahl von Anfragen pro Minute?
Raten- und Parallelitätslimits gelten für jedes Konto und können sich ändern. Wenn Sie schwere parallele Arbeitslasten planen, lesen Sie die Dokumentation oder kontaktieren Sie den Support.
Ist 429 dasselbe wie das Erreichen meines Claude Plan-Limits?
Nein. Plan-Limits zeigen Meldungen wie "You've hit your session limit". Ein 429 rate_limit_error kommt von den Ratenlimits der API.
Zählen Skripte, die denselben Schlüssel verwenden, zum Limit?
Ja. Jede Anfrage vom Konto zählt, daher kann ein beschäftigter CI-Job 429s in Ihrer interaktiven Sitzung verursachen. Getrennte Schlüssel machen dies leicht erkennbar.
Entfernt ein größeres Guthaben 429-Fehler?
Nicht von allein. 429 bezieht sich auf die Anfragenrate und Parallelität, nicht auf das Guthaben.
Werden fehlgeschlagene Anfragen berechnet?
Fehlgeschlagene Anfragen (4xx/5xx, Timeouts, abgebrochene Verbindungen) werden nicht berechnet — Sie zahlen nur für Anfragen, die erfolgreich abgeschlossen werden. Wenn ein Upstream-Fehler automatisch erneut versucht wird und erfolgreich ist, wird er einmal berechnet.
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 steht nicht mit Anthropic in Verbindung und wird nicht von Anthropic unterstützt. Fehlerformate sind von Claude Code zitiert und können sich ändern. Geprüft am 2026-10-10.