Your credit balance is too low to access the Anthropic API: Lösungen

„Your credit balance is too low to access the Anthropic API“ bedeutet, dass Ihr vorausbezahltes Guthaben nicht ausreicht, um die Nutzung der Claude API zu bezahlen. In Claude Code erscheint der Fehler als „Credit balance is too low“. Wenn Sie dachten, Sie nutzen einen Plan wie Pro oder Max, und der Fehler trotzdem auftaucht, liegt es meist daran, dass der API-Schlüssel in der Umgebungsvariable ANTHROPIC_API_KEY Vorrang vor Ihrer Plan-Anmeldung hat und Sie deshalb auf API-Abrechnung umgestellt wurden.

400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

Ein Beispiel für die API-Antwort. In dieser Form taucht sie in Logs auf, die Nutzer im GitHub-Repository von Claude Code gepostet haben (ein Bericht vom April 2025, ein Bericht vom August 2026). Die Liste der API-Fehler von Anthropic enthält genau diesen Satz nicht.

Auf Grundlage der offiziellen Dokumentation von Claude Code und des Hilfe-Centers von Anthropic (geprüft am 26. Oktober 2026) erklärt dieser Artikel, was der Fehler bedeutet, wie Sie die Ursachen unterscheiden, die beiden Lösungen und wie er sich von den monatlichen API-Credits für Max und Team sowie von den „Nutzungs-Credits“ Ihres Plans unterscheidet. Die Ursachen sind farblich markiert als A Guthaben und B API-Schlüssel.

1. Was der Fehler bedeutet und wie er erscheint

Die Claude API ist vorausbezahlt, außer bei Organisationen mit Vertriebsvertrag, die am Monatsende eine Rechnung erhalten. Laut dem Hilfeartikel von Anthropic wird die Nutzung der API, des Playground und von Claude Code über eine Claude-Console-Organisation von vorab gekauftem Guthaben abgezogen, und sobald das Guthaben aufgebraucht ist, können Sie die API erst wieder aufrufen, wenn Sie neues hinzufügen. Dieser Fehler zeigt an, dass Sie diesen Zustand „nicht genug Guthaben“ erreicht haben.

„Plans & Billing“ am Ende der Meldung meint die Abrechnungsseite der Console. In der heutigen Console sehen Sie Ihr Guthaben und kaufen Credits auf der Seite Billing (platform.claude.com/settings/billing).

Quellen: Anthropic, „How do I pay for my Claude API usage?“; Claude Code, „Error reference: Credit balance is too low“. Die ältere Meldung stammt aus einem Bericht auf GitHub. Geprüft am 26. Oktober 2026.

Die offizielle Fehlerreferenz von Claude Code nennt zwei Ursachen: Das vorausbezahlte Guthaben Ihrer Console-Organisation ist aufgebraucht, oder Sie wollten ein Abonnement nutzen, aber die Anfragen werden mit einem Console-API-Schlüssel gesendet. Das sind die Ursachen A und B oben.

2. Drei Fragen, um die Ursache zu finden

Beantworten Sie sie der Reihe nach, dann wissen Sie, welcher Lösung Sie folgen.

1. F1 Wollen Sie Claude Code mit einem Pro-, Max-, Team- oder Enterprise-Plan nutzen?

   Ja Weiter mit F2. Wenn Sie über Ihren Plan laufen, sollte dieser Fehler nicht auftreten

   Nein (API-Schlüssel oder eigene App) Weiter mit F3

2. F2 Zeigt /status einen API-Schlüssel an?

   JaUrsache B Ein von Ihnen genehmigter ANTHROPIC_API_KEY hat Vorrang vor Ihrem Plan → Abschnitt 4

   Nein Prüfen Sie die Zeile zur Anmeldemethode. Sind Sie mit einem Console-Konto angemeldet, zahlen Sie aus dem Console-Guthaben → melden Sie sich mit /login erneut mit Ihrem Plan-Konto an (Schritt 5 in Abschnitt 4)

3. F3 Hat die Organisation des Schlüssels unter Billing in der Console ein Guthaben?

   Keins oder wenigUrsache A Guthaben kaufen → Abschnitt 3

   Ja Prüfen Sie, ob der Schlüssel zu einer anderen Organisation gehört, ob Sie das Guthaben gerade erst gekauft haben und ob Sie nur monatliche Max- oder Team-Credits haben und diese für etwas nutzen, das sie nicht abdecken → FAQ

Grundlage für F2: Die Fehlerreferenz von Claude Code fordert Plan-Nutzer, die diesen Fehler sehen, auf, die Zeile zum API-Schlüssel in /status zu prüfen. Zum Wechsel bei Anmeldung über die Console siehe Anthropic, „Use Claude Code with your Pro or Max plan“ (wenn Sie über ein nutzungsbasiert abgerechnetes Console-Konto angemeldet sind, wechseln Sie mit /login zu Ihrem Plan).

Was Sie für einen Plan wie Claude Pro bezahlen, kann nicht für die API verwendet werden. Laut der Hilfe von Anthropic sind die Pläne und die Console getrennte Produkte, und die API wird separat abgerechnet (Why is Claude API usage billed separately from my paid Claude plan?). Auch mit einem Plan brauchen Sie ein Console-Guthaben, solange Sie über einen API-Schlüssel laufen.

3. Ursache A Guthaben aufladen

Das ist die Lösung für alle, die einen API-Schlüssel nutzen. Nur Mitglieder mit der Rolle Admin oder Billing in der Console-Organisation können Guthaben kaufen. Gehört die Organisation Ihrem Unternehmen, wenden Sie sich an einen Administrator.

1. Seite Billing öffnen Melden Sie sich in der Console an und öffnen Sie Billing. Das Guthaben der Organisation und der verbrauchte Betrag stehen auf derselben Seite. Wenn Sie mehreren Organisationen angehören, achten Sie darauf, die Organisation ausgewählt zu haben, in der der fehlschlagende Schlüssel erstellt wurde. Guthaben gilt pro Organisation, und alle API-Schlüssel derselben Organisation greifen auf dasselbe Guthaben zu.
2. Guthaben kaufen Klicken Sie auf „Buy credits“, geben Sie einen Betrag ein und bestätigen Sie. Laut dem Hilfeartikel ist gekauftes Guthaben sofort verfügbar.
3. Automatische Aufladung einschalten (optional) Geben Sie im Bereich Credit balance über „Set up auto-reload“ das Guthaben ein, bei dem aufgeladen wird (When credit balance reaches), und das Guthaben, auf das aufgeladen wird (Bring credit balance back up to), und klicken Sie dann auf „Turn on“. Liegt Ihr Guthaben bereits auf oder unter diesem Betrag, wird die Schaltfläche zu „Turn on and purchase“ und der Kauf erfolgt sofort.
4. Fehlgeschlagenes wiederholen Senden Sie in Claude Code dieselbe Anweisung erneut.

Quelle: Anthropic, „How do I pay for my Claude API usage?“ (Kaufschritte, sofortige Verfügbarkeit, Einrichtung der automatischen Aufladung, Ablauf ein Jahr nach dem Kauf, keine Erstattung). Geprüft am 26. Oktober 2026.

Gekauftes Guthaben verfällt ein Jahr nach dem Kaufdatum und wird nicht erstattet. Nur so viel zu kaufen, wie Sie verbrauchen, und bei niedrigem Stand die automatische Aufladung nachfüllen zu lassen, dürfte weniger verschwenden. Die Fehlerreferenz von Claude Code empfiehlt außerdem, in der Console Ausgabenlimits pro Workspace festzulegen, damit ein einzelnes Projekt nicht das Guthaben der ganzen Organisation aufbraucht.

4. Ursache B API-Schlüssel entfernen und den Plan nutzen

Das ist die Lösung für alle, die einen Pro-, Max-, Team- oder Enterprise-Plan nutzen wollen. Sind mehrere Anmeldedaten vorhanden, wählt Claude Code eine davon in fester Reihenfolge, und die Umgebungsvariable ANTHROPIC_API_KEY sowie apiKeyHelper in einer Einstellungsdatei stehen über der Plan-Anmeldung, die Sie mit /login eingerichtet haben. Wird der Schlüssel verwendet, wird laut der Hilfe von Anthropic nutzungsbasiert über die Organisation dieses Schlüssels abgerechnet, und hat diese Organisation kein Guthaben, werden Sie mit diesem Fehler gestoppt.

1. Mit /status prüfen Führen Sie in Claude Code /status aus und sehen Sie sich die Zeile zum API-Schlüssel an. Sind sowohl eine Anmeldung als auch ein API-Schlüssel vorhanden, ist der nicht verwendete markiert.
2. Aus der aktuellen Shell entfernen Entfernen Sie die Variable aus dem geöffneten Terminal (Befehle unten).
3. Die Quelle des Schlüssels entfernen Suchen und löschen Sie die Zeile export ANTHROPIC_API_KEY=... in der Konfigurationsdatei Ihrer Shell, die Benutzer-Umgebungsvariable unter Windows und jeden Eintrag in Ihrem PowerShell-Profil ($PROFILE). Sonst lädt das nächste Terminal, das Sie öffnen, ihn erneut. Laut der offiziellen Fehlerreferenz können Werkzeuge wie direnv oder das Terminal einer IDE den Schlüssel aus der .env-Datei eines Projekts laden, prüfen Sie also auch die .env in Ihrem Projektordner. Wie Sie ihn in env oder apiKeyHelper der Einstellungsdateien von Claude Code finden, steht in unserem Artikel zu „claude.ai connectors are disabled“.
4. Terminal neu öffnen und claude starten Die offizielle Hilfe nennt das Ändern von Umgebungsvariablen ohne Neuöffnen des Terminals als häufigen Fehler.
5. Bei Bedarf /login, dann erneut /status Sind Sie noch nicht mit Ihrem Plan-Konto angemeldet, führen Sie /login aus. Sobald /status bestätigt, dass kein API-Schlüssel verwendet wird, sind Sie fertig.

# macOS / Linux: prüfen, ob sie gesetzt ist
env | grep ANTHROPIC
# Aus der aktuellen Shell entfernen
unset ANTHROPIC_API_KEY
# Herausfinden, welche Konfigurationsdatei sie setzt
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

# Windows (PowerShell): prüfen, ob sie gesetzt ist
Get-ChildItem Env:ANTHROPIC*
# Aus der aktuellen Shell entfernen
Remove-Item Env:ANTHROPIC_API_KEY

# Windows (Eingabeaufforderung): prüfen, ob sie gesetzt ist
echo %ANTHROPIC_API_KEY%
# Aus der aktuellen Shell entfernen
set ANTHROPIC_API_KEY=

Unter Windows entfernen Sie dauerhafte Einstellungen aus den Benutzervariablen unter „Systemeigenschaften“ → „Erweitert“ → „Umgebungsvariablen“. Quellen: Anthropic, „Manage API key environment variables in Claude Code“; Claude Code, „Authentication precedence“ und „Error reference“ (die Prüfbefehle und .env stehen im Eintrag „Invalid API key“). Geprüft am 26. Oktober 2026.

Wenn Sie den Schlüssel nicht löschen möchten, können Sie stattdessen Ihre Genehmigung widerrufen. Wird Claude Code interaktiv gestartet, fragt es beim ersten Fund einmal, ob ANTHROPIC_API_KEY verwendet werden soll, und merkt sich Ihre Antwort. Um sie später zu ändern, schalten Sie „Use custom API key“ in /config um (diese Option erscheint nur, solange die Variable gesetzt ist). Mit claude -p (nicht interaktiv) wird der Schlüssel jedoch immer verwendet, wenn er vorhanden ist. Brauchen andere Skripte den Schlüssel, übergeben Sie ihn nur beim Ausführen dieser Befehle.

Wenn der Fehler in der VS-Code-Erweiterung erscheint

In der Claude-Code-Erweiterung für VS Code prüfen Sie dasselbe. Geben Sie im Panel /status ein, um Ihr Konto und weitere Angaben zu sehen (Claude Code v2.1.280 oder neuer). Laut der offiziellen Dokumentation übernimmt VS Code, wenn es aus einem Terminal mit code . gestartet wird, die Umgebungsvariablen dieser Shell. Steht der Schlüssel in der Konfigurationsdatei Ihres Terminals, kann er also auch die Erweiterung erreichen. Schließen und öffnen Sie VS Code nach dem Entfernen des Schlüssels neu, bevor Sie prüfen.

Umgebungsvariablen lassen sich auch in der Einstellung claudeCode.environmentVariables der Erweiterung setzen. Prüfen Sie in den Einstellungen unter Erweiterungen → Claude Code, dass ANTHROPIC_API_KEY dort nicht gesetzt ist.

Quelle: Claude Code, „Use Claude Code in VS Code“ (Übernahme von Umgebungsvariablen, Einstellung environmentVariables, /status). Geprüft am 26. Oktober 2026.

5. Womit Ihre Nutzung bezahlt wird

Drei Dinge heißen „Credits“, und wer sie verwechselt, deutet diesen Fehler falsch: in der Console gekaufte API-Credits, die monatlichen API-Credits für Max und Team und Nutzungs-Credits, die Nutzung über die Limits Ihres Pro- oder Max-Plans hinaus bezahlen. Hier sehen Sie, womit jede Art der Nutzung bezahlt werden kann.

Quellen: Anthropic, „Monthly API credits for Max and Team plans“ (interaktives Claude Code und Nutzungs-Credits nicht abgedeckt; selbst mit API-Schlüssel ausgeführtes claude -p und Agent SDK abgedeckt); „Manage usage credits for paid Claude plans“ (Nutzungs-Credits gelten nach den Plan-Limits sowohl für Claude als auch für Claude Code und sind von den monatlichen API-Credits getrennt); „Manage API key environment variables in Claude Code“ (ist ein API-Schlüssel vorhanden, wird nutzungsbasiert über die Organisation dieses Schlüssels abgerechnet); „How do I pay for my Claude API usage?“. Geprüft am 26. Oktober 2026.

Für diesen Fehler zählen die beiden rechten Spalten (das Guthaben Ihrer Console-Organisation). Aus der Tabelle folgen drei Dinge.

• Sehen Sie den Fehler, obwohl Sie glauben, über Ihren Plan zu laufen, befinden Sie sich in einer der Zeilen mit API-Schlüssel. Aufstocken von Plan oder Nutzungs-Credits (die beiden linken Spalten) behebt ihn nicht, egal wie viel Sie hinzufügen (Ursache B).
• Die monatlichen API-Credits von Max und Team sind für interaktives Claude Code nicht nutzbar. Auch wenn die Credits Ihres Plans noch auf der Guthabenseite der Console stehen, können sie interaktives Claude Code mit API-Schlüssel nicht bezahlen. Wie Sie sie einlösen und in welcher Reihenfolge sie verbraucht werden, steht in unserem Artikel zu den API-Credits von Max und Team.
• Nutzungs-Credits sind ein separates Guthaben in den Einstellungen von claude.ai (Einstellungen → Nutzung). Da sie vom Console-Guthaben getrennt sind, hilft Aufladen nicht bei der Nutzung über einen API-Schlüssel.

6. Ähnliche, aber andere Fehler

Auch andere Fehler betreffen Guthaben oder Limits. Unterscheiden Sie sie am Anfang der Meldung.

Quellen: Claude API, „Rate limits“ (die beiden Fehler zu Ausgabenlimits); Claude Code, „Error reference“. Geprüft am 26. Oktober 2026.

Eine Liste weiterer Fehler in Claude Code finden Sie unter Häufige Claude-Code-Fehler und ihre Lösungen.

Zusammenfassung

FAQ

F. Gibt es ein kostenloses Kontingent für die Claude API?

A. Die offizielle Hilfe erwähnt kein kostenloses Kontingent. Nach dem Anlegen einer Console-Organisation lautet der Hinweis, „dem Guthaben Ihrer Organisation Credits hinzuzufügen, um die API und den Playground zu nutzen“ (I created a Claude Console organization - how do I start using the Claude API?). Die Ausnahme sind die monatlichen API-Credits für die Pläne Max und Team; die Pläne Free, Pro und Enterprise sind nicht berechtigt.

F. Ich habe Claude Pro. Warum bekomme ich diesen Fehler?

A. Weil Claude Code über einen API-Schlüssel läuft. Die Gebühr Ihres Plans kann die API nicht bezahlen, und hat die Organisation des API-Schlüssels kein Guthaben, erhalten Sie diesen Fehler. Prüfen Sie mit /status, ob ein API-Schlüssel verwendet wird, und entfernen Sie ihn mit den Schritten in Abschnitt 4.

F. Ich habe Guthaben gekauft, aber der Fehler bleibt.

A. Laut dem Hilfeartikel ist gekauftes Guthaben sofort verfügbar. Prüfen Sie zuerst, ob die Organisation, in der Sie den Schlüssel erstellt haben, dieselbe ist, für die Sie das Guthaben gekauft haben. Die Statusseite von Anthropic verzeichnet für den 1. September 2026 (UTC) einen Vorfall, bei dem gekauftes Guthaben bei Nutzern mit einem Guthaben von null verzögert gutgeschrieben wurde und einige API-Anfragen fälschlich „credit balance is too low“ zurückgaben (Delays in credit purchases). Am 1. Oktober desselben Jahres gab es einen weiteren Vorfall, bei dem Käufe verzögert gutgeschrieben wurden (Delayed credits on the Claude Platform). Stimmt die Organisation und wird das Guthaben angezeigt, prüfen Sie auf status.claude.com, ob gerade ein Vorfall läuft.

F. Ich habe noch monatliche Max-API-Credits, bekomme aber diesen Fehler in Claude Code.

A. Monatliche API-Credits sind für interaktives Claude Code nicht nutzbar, weder im Terminal noch in der IDE, der Desktop-App oder im Web (die Tabelle in Abschnitt 5). Um Ihren Plan zu nutzen, entfernen Sie den API-Schlüssel und verwenden Ihre Anmeldung; um einen API-Schlüssel zu nutzen, kaufen Sie Guthaben in der Console.