Die genauen Meldungen und ihre jeweilige Bedeutung
API Error: 429 {"type":"rate_limit_error", ...}/ „Ratenlimit erreicht“ — Sie haben das Limit für Anfragen, Tokens oder Gleichzeitigkeit innerhalb des Zeitfensters überschritten. Warten Sie aufretry-after.rate limit reached for <model>mit einem modellspezifischen Hinweis — Limits gelten pro Modell; ein Wechsel der Stufe mit/modelfunktioniert oft sofort.- „Sie haben Ihr Nutzungslimit erreicht“ / „Limit wird um … zurückgesetzt“ — kein Ratenlimit: Das ist die gleitende Nutzungsobergrenze des Pro/Max-Abonnements. Warten Sie auf die Zurücksetzung oder verwenden Sie einen API-Schlüssel.
529 overloaded_error— es liegt an der Kapazität, nicht an Ihnen. Versuchen Sie es mit zunehmenden Wartezeiten erneut; die Fehleranleitung behandelt dieses Thema.400 … tool use concurrency— zu viele parallele Tool-Aufrufe in einem Schritt; kein 429, tritt aber in denselben Sitzungen auf.
Claude-Ratenlimits: die drei Obergrenzen
Anthropic begrenzt Anfragen pro Minute (RPM), Eingabe- und Ausgabetokens pro Minute (ITPM/OTPM) sowie gleichzeitig laufende Anfragen — pro Modell und Organisation, abgestuft nach Nutzungsstufe. Die Stufe steigt automatisch mit Ihren kumulierten Ausgaben. Gateways setzen entsprechende eigene Limits pro Konto durch. Die Werte sind in der Anthropic-Dokumentation veröffentlicht und werden in Ihrer Konsole angezeigt; für Claude Code sind Gleichzeitigkeit und OTPM entscheidend, weil eine Agentensitzung aus einem Strom langer, paralleler Anfragen mit umfangreichen Ausgaben besteht.
Warum Claude Code das Limit erreicht, ein Chat-Client aber nicht
Ein Chat-Client sendet jeweils nur eine Anfrage. Claude Code streamt jeden Schritt und belegt dabei für dessen gesamte Dauer einen Platz für gleichzeitige Anfragen, führt Subagenten parallel aus, die jeweils einen weiteren Platz belegen, und sendet bei jedem Schritt die gesamte Unterhaltung erneut, wodurch die Tokens pro Minute mit der Sitzungslänge zunehmen. Zehn Subagenten in einem großen Repository bedeuten zehn gleichzeitige Streams und Hunderttausende Tokens pro Minute — das ist der 429.
Lösungen, geordnet nach ihrer Erfolgsquote
- 1. Lassen Sie es erneut versuchen. Claude Code berücksichtigt
retry-after; die meisten 429-Fehler verschwinden innerhalb von Sekunden. - 2. Führen Sie weniger Subagenten parallel aus; erledigen Sie aufwendige Aufgaben nacheinander, statt sie parallel zu verteilen.
- 3.
/compact— weniger Kontext bedeutet weniger Tokens pro Schritt; damit lässt sich TPM beeinflussen. - 4. Wechseln Sie die Stufe mit
/modelfür die aktuelle Aufgabe; Limits gelten pro Modell. - 5. Verlagern Sie Hintergrundaufgaben auf Haiku; behalten Sie Sonnet/Opus für den Hauptzyklus bei.
- 6. Beantragen Sie ein höheres Limit: bei Anthropic über die Ausgabenstufe oder eine Anfrage an den Vertrieb; bei diesem Gateway per E-Mail an den Support mit Angaben zu Ihrem Konto und Ihrer Arbeitslast. Neue Konten beginnen mit vorsichtigen Limits für gleichzeitige Anfragen, damit ein einzelner außer Kontrolle geratener Agent den Pool nicht vollständig auslasten kann; auf Anfrage werden diese Limits erhöht.
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20Ratenlimits bei diesem Gateway
Anfragen werden über Ihr Guthaben oder einen Pauschaltarif abgerechnet; Ratenlimits gelten pro Konto und sind unabhängig vom Preis. Das Gateway bündelt mehrere Konten beim vorgelagerten Anbieter. Daher wird ein modellspezifischer 429 bei einem Konto durch einen Wechsel zu einem anderen abgefangen, statt an Sie weitergegeben zu werden, sofern ein anderes Konto noch Kapazität hat — ein Grund, warum Sitzungen hier weniger 429-Fehler sehen als mit einem einzelnen Konsolenschlüssel. Das Limit für gleichzeitige Anfragen werden Sie am ehesten erreichen; schreiben Sie dem Support, wie viele parallele Agenten Sie ausführen, damit es angepasst wird.
| Plan | Laufzeit | Preis |
|---|---|---|
| Unbegrenzt für 1 Stunde | 1 Stunde | $1 |
| Unbegrenzt für 24 Stunden | 24 Stunden | $10 |
| Unbegrenzt für 1 Woche | 1 Woche | $49 |
| Unbegrenzt für 15 Tage | 15 Tage | $89 |
Zuerst kostenlos ausprobieren
Neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code CLAUDECODE — genug für einen Abend mit Claude Code auf Sonnet — danach Guthaben zum 7.69231-Fachen des Nennwerts.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyHäufig gestellte Fragen
Was bedeutet „API-Fehler: Ratenlimit erreicht“ in Claude Code?
Ein HTTP 429: Sie haben das Limit für Anfragen, Tokens oder gleichzeitige Anfragen pro Minute für dieses Modell überschritten. Claude Code wartet gemäß retry-after und versucht es erneut; falls der Fehler bestehen bleibt, reduzieren Sie die Anzahl paralleler Subagenten und verwenden Sie /compact.
Welche Ratenlimits hat Claude?
Anfragen pro Minute, Eingabe-/Ausgabetokens pro Minute und gleichzeitige Anfragen, jeweils pro Modell, bei Anthropic nach Nutzungsstufe und bei einem Gateway pro Konto abgestuft. Agentensitzungen erreichen vor allem die Limits für Gleichzeitigkeit und Ausgabetokens.
Wie erhalte ich ein höheres Claude-Ratenlimit?
Bei Anthropic: mehr ausgeben, wodurch die Stufen automatisch steigen, oder den Vertrieb kontaktieren. Bei diesem Gateway: dem Support eine E-Mail mit Angaben zu Ihrer Arbeitslast senden; das Limit für gleichzeitige Anfragen wird auf Anfrage erhöht.
Ist „Nutzungslimit erreicht“ dasselbe wie ein Ratenlimit?
Nein. Das ist die gleitende Obergrenze des Pro/Max-Abonnements. Ein Ratenlimit gilt pro Minute und wird von selbst wieder frei; eine Nutzungsobergrenze wird nach ihrem Zeitplan zurückgesetzt.
Claude Code über das Gateway nutzen
Dieselben Modelle, zwei Umgebungsvariablen, Guthaben zum 7.69231-Fachen des Nennwerts — oder ein unbegrenzter Pauschaltarif. Neue Konten: $5 kostenloses API-Guthaben mit dem Code CLAUDECODE.
API-Schlüssel erhalten Unbegrenzte Tarife ansehenAI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.