Claude API „credit balance is too low“ / 402 insufficient_quota

Dieser Fehler hat nichts mit Ihrem Code zu tun: Das Prepaid-Guthaben hinter dem Schlüssel ist leer (oder Ihr monatliches Ausgabenlimit wurde erreicht). Hier erfahren Sie, wie sich die Abrechnungsmodelle von Anthropic Console und Gateways unterscheiden und welche Warnungen verhindern, dass dies um 2 Uhr morgens erneut passiert.

Der Fehler

response (HTTP 400 / 402)

// Anthropic Console (HTTP 400):
{"type":"error","error":{"type":"invalid_request_error",
 "message":"Your credit balance is too low to access the Anthropic API..."}}

// OpenAI-compatible gateways, e.g. Kunavo (HTTP 402):
{"error":{"message":"Wallet balance is too low for this request. Top up at https://kunavo.com/app/billing",
 "type":"insufficient_quota","code":"insufficient_quota","param":null}}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Prepaid-Guthaben tatsächlich auf null	Laden Sie Guthaben auf. Bei Anthropic: Console → Plans & billing. Bei Kunavo: /app/billing (Guthaben verfällt nie).
Automatisches Aufladen deaktiviert (oder die Karte ist abgelaufen)	Aktivieren Sie das automatische Aufladen bzw. aktualisieren Sie die Karte, damit Spitzen den Saldo nicht unbemerkt auf null senken.
Monatliches Ausgabenlimit erreicht	Erhöhen oder entfernen Sie das Limit pro Schlüssel bzw. Workspace, wenn die Ausgabe legitim war.
Schlüssel des falschen Workspace	Schlüssel belasten den Workspace, der sie erstellt hat – ein finanziertes Unternehmen finanziert nicht den Schlüssel eines anderen Workspace.

Bestätigen Sie, dass es um Guthaben und nicht um Authentifizierung geht

401 = Schlüsselproblem; 400 „credit balance too low“ / 402 insufficient_quota = Geldproblem. Rotieren Sie bei einem Abrechnungsfehler nicht die Schlüssel – der neue Schlüssel liest dasselbe leere Wallet.

Laden Sie Guthaben auf und prüfen Sie anschließend mit einem günstigen Aufruf

Guthaben wird bei Anthropic und Kunavo sofort angewendet – kein erneutes Deployment erforderlich. Prüfen Sie dies mit einer minimalen Anfrage, bevor Sie Ihre Worker wieder aktivieren:

verify.sh

curl -s https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'

Wird der Fehler in Claude Code angezeigt?

Claude Code zeigt diese Meldung an, wenn es mit einem Anthropic-API-Schlüssel ausgeführt wird, dessen Console-Guthaben leer ist — bei einer Pro- oder Max-Anmeldung greifen stattdessen Nutzungslimits, und diese Meldung wird nie angezeigt. Laden Sie die Console auf oder arbeiten Sie weiter mit einem Pay-as-you-go-Endpunkt: Claude Code liest ANTHROPIC_BASE_URL nativ, daher erfordert der Wechsel nur einige Umgebungsvariablen. Behalten Sie die vier Modellzeilen bei — der Standardwert von Claude Code sowie seine Opus- und Sonnet-Aliase folgen den neuesten Modellen von Anthropic, und der Sonnet-Alias fordert Sonnet 5.5 an, das Kunavo nicht anbietet.

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Machen Sie den nächsten Vorfall langweilig

Richten Sie eine Benachrichtigung bei niedrigem Guthaben per E-Mail ein und, sofern Ihr Anbieter dies unterstützt, ein automatisches Aufladen mit einem sinnvollen Monatslimit. Ein Abrechnungsfehler bei geschlossenem Guthabenfluss ist korrekt – Sie möchten nur die Warnung vor der Wand erhalten, nicht erst an der Wand stehen.

Wenn Sie Kunavo verwenden

Kunavo schlägt bei null mit einem ausdrücklichen 402 insufficient_quota fehl (niemals mit einem vagen 500), fehlgeschlagene Anfragen werden nicht berechnet, und aktive Konten erhalten eine E-Mail bei niedrigem Guthaben mit ihrer individuellen Reichweite auf Grundlage der Verbrauchsrate, bevor sie an ihre Grenze stoßen. Das Guthaben ist ein Prepaid-Wallet ab $10, verfällt nie und kann unter /app/billing mit Karten, außerhalb Indiens mit Apple Pay, Google Pay oder Link oder mit einer lokalen Zahlungsmethode aufgeladen werden, die Stripe in Ihrer Währung anzeigt, etwa Pix, WeChat Pay, UPI oder KakaoPay. Wie weit eine bestimmte Aufladung reicht, hängt vollständig davon ab, welches Modell Sie auswählen; die Tarife pro Modell finden Sie in der Preisliste der Anthropic-Claude-API.

Häufig gestellte Fragen

Ich habe Guthaben aufgeladen – warum erhalte ich den Fehler weiterhin?

Prüfen Sie, ob Sie dasselbe Konto bzw. denselben Workspace aufgeladen haben, der den Schlüssel erstellt hat, und ob nicht ein monatliches Ausgabenlimit die eigentliche Sperre darstellt. Die Anwendung des Guthabens selbst erfolgt bei Anthropic und Kunavo sofort.

Hat die Claude API eine kostenlose Ebene?

Nein – Anthropic berechnet jeden API-Aufruf ab dem ersten Token (Claude.ai-Verbraucherpläne sind von API-Guthaben getrennt). Gateways funktionieren ebenfalls nach dem Pay-as-you-go-Prinzip; Kunavo beginnt mit einer Aufladung von 10 $ und Tarifen unter dem Listenpreis.

„Credit balance is too low“ in Claude Code – aber ich bezahle für Pro. Warum?

Weil Claude Code einen API-Schlüssel und nicht Ihr Abonnement verwendet. Solange ANTHROPIC_API_KEY oder ANTHROPIC_AUTH_TOKEN gesetzt ist, rechnet Claude Code den Schlüssel ab und pausiert den Pro- oder Max-Login; der Schlüssel greift auf ein separates Prepaid-Guthaben in der Console zu. Führen Sie /status aus, um die aktive Zugangsdaten zu sehen; entfernen Sie die Variable, um zum Plan zurückzukehren, oder laden Sie das Guthaben des Schlüssels auf.

OpenClaw meldet „API provider returned a billing error“ – ist das dasselbe?

Ja. Das ist OpenClaws Formulierung für eine Abrechnungsablehnung des Modellanbieters: Dem API-Schlüssel sind die Credits ausgegangen oder sein Guthaben reicht nicht aus. Laden Sie bei diesem Anbieter Guthaben auf oder wechseln Sie OpenClaw zu einem anderen Anbieter – die zugehörigen Leitfäden weiter unten vergleichen die Optionen.

Claude API „credit balance is too low“ / 402 insufficient_quota – die Lösung