Fehlersuche · Stand 20. November 2026

Claude Code 401 mit eigener Basis-URL: Invalid API key und AUTH_TOKEN der Reihe nach geprüft

Stand 20. November 2026 ist ein 401, nachdem Sie Claude Code auf eine eigene API-Adresse zeigen lassen, eines von vier Dingen: Schlüssel und Endpunkt gehören zu verschiedenen Diensten, ANTHROPIC_API_KEY und ANTHROPIC_AUTH_TOKEN sind vertauscht, ein alter Wert steht noch im env-Block der Einstellungsdatei, oder die Adresse hat ein zusätzliches /v1. Führen Sie zuerst /status aus und lesen Sie die Zeilen Anthropic base URL und Auth token, dann behalten Sie genau eine dazu passende Variable für die Anmeldeinformation.

Aktualisiert 2026-11-20

Ein Key für Claude, GPT, DeepSeek und Qwen — Abrechnung pro Token auf Prepaid-Basis, in wenigen Minuten startklar.

#401 Invalid API key#ANTHROPIC_BASE_URL#AUTH_TOKEN vs API_KEY#veralteter env-Wert in den Einstellungen

Vier Werte, die Sie zuerst kennen sollten

401

Die Anmeldeinformation wurde abgelehnt, nicht das Netzwerk

Die Fehlerreferenz der Anthropic-API definiert 401 als authentication_error: Der Schlüssel selbst ist fehlerhaft, widerrufen oder abgelaufen. Wenn die Adresse auf ein Gateway zeigt, wurde der Text nach 401 von diesem Gateway geschrieben, nicht von Anthropic.

x-api-key

ANTHROPIC_API_KEY wird in diesem Header übertragen

Die Authentifizierungsreferenz gibt an, dass er für den direkten Zugriff auf die Anthropic-API als Header X-Api-Key gesendet wird. Wenn Sie zusätzlich eine Abo-Anmeldung haben, hat ein genehmigter API-Schlüssel Vorrang davor, weshalb eine angemeldete Sitzung trotzdem an den Anmeldeinformationen scheitern kann.

Bearer

ANTHROPIC_AUTH_TOKEN wird in diesem Header übertragen

Sein Wert erhält das Präfix Bearer und wird als Header Authorization gesendet, gedacht für Gateways oder Proxys, die mit Bearer-Tokens authentifizieren. Die offizielle Empfehlung: Wenn Ihnen niemand gesagt hat, welchen der beiden Sie verwenden sollen, beginnen Sie mit diesem.

/status

Sehen Sie die wirksame Adresse und Anmeldeinformation

Die Gateway-Anleitung zeigt die Zeile Anthropic base URL nur, wenn eine Gateway-Adresse gesetzt ist. Eine Zeile Auth token oder API key bedeutet, dass eine Gateway-Anmeldeinformation aktiv ist; eine Zeile Login method bedeutet, dass Ihre Anmeldung aktiv ist.

Was ein 401 bei einer eigenen Adresse tatsächlich ist

Ein 401 bei einer eigenen API-Adresse ist selten ein Netzwerkproblem: Die Anmeldeinformation, die an die Anfrage angehängt wird, wird auf der anderen Seite nicht akzeptiert. Die offizielle Fehlerseite erklärt Invalid API key als die Variable ANTHROPIC_API_KEY oder ein apiKeyHelper-Skript, das einen Schlüssel zurückgibt, den die API abgelehnt hat, oder als Claude Code, das diesen Schlüssel vor dem Senden blockiert hat.

Die andere Meldung, API Error: 401 Invalid authentication credentials, ist genauer: Die API hat das Format der Anmeldeinformation erkannt, aber das dahinterstehende Konto oder die Organisation abgelehnt, ein abgelaufenes Token ist also nicht die Ursache. Es gibt einen dritten Fall: Wenn die Adresse auf ein Gateway zeigt, ist der Text nach 401 die eigene Fehlermeldung des Gateways und /login kann ihn nicht ändern, weil das Gateway eine andere Anmeldeinformation verlangt. Alle drei beginnen gleich: Führen Sie /status aus und sehen Sie, welche Adresse und welche Anmeldeinformation wirksam sind.

Zwei Änderungen zu diesem 401, Stand 20. November 2026

1. Eine weitere Quelle für 401 liegt auf der Gateway-Seite: Die offizielle Fehlerseite sagt, dass Sie, wenn jede Anfrage mit einem 401 scheitert, sobald Ihr Gateway die erwartete Anmeldeinformation hat, prüfen sollten, ob das Gateway Tool-Search-Felder akzeptiert; vor v2.1.304 war Tool Search hinter einem Gateway aus, sofern Sie es nicht mit ENABLE_TOOL_SEARCH eingeschaltet haben. 2.

Fehler von apiKeyHelper sehen jetzt anders aus: Wenn das Skript keinen Schlüssel zurückgibt, erreicht die Anfrage die API mit einer Platzhalter-Anmeldeinformation und wird mit 401 abgelehnt, und vor v2.1.208 verbrauchte Claude Code das gesamte Wiederholungsbudget damit, diese Anfrage mit der Platzhalter-Anmeldeinformation erneut zu senden, und meldete dann einen allgemeinen 401 authentication error statt des Skriptfehlers; ab v2.1.208 erscheint bei einem Skript, das einen Fehler wirft, in eine Zeitüberschreitung läuft oder nichts ausgibt, innerhalb von drei Versuchen Your apiKeyHelper script is failing.

Drei Daten: welche Variable wohin gehört, der Weg über die Einstellungsdatei und der 401 auf der Gateway-Seite

2026-07-05

Häufige Erfahrung in Diskussionen zur Fehlersuche in der Community: Ein eigener Endpunkt nimmt ANTHROPIC_AUTH_TOKEN, eine direkte Verbindung zu api.anthropic.com nimmt ANTHROPIC_API_KEY. Bei dieser Aufteilung können eine Gateway-Adresse mit einem Anthropic-Schlüssel oder eine direkte Adresse mit einem Gateway-Schlüssel die Anfrage-Header nicht treffen, sodass die Gegenseite nur mit 401 antworten kann.

2026-11-11

Häufige Erfahrung in Diskussionen zur Fehlersuche in der Community: Schreiben Sie die Adresse und den Gateway-Schlüssel in den env-Block von ~/.claude/settings.json, statt sie nur im Terminal zu exportieren. Zwei Regeln wiederholen sich: Tragen Sie die Adresse nur bis zum Host ein und lassen Sie /v1 weg, und wenn dieselbe Variable zweimal existiert, gewinnt die Einstellungsdatei.

2026-11-20

Wenn das Gateway bereits die richtige Anmeldeinformation hat und jede Anfrage weiterhin 401 zurückgibt, prüfen Sie, ob das Gateway Tool-Search-Felder akzeptiert; vor v2.1.304 war diese Funktion hinter einem Gateway aus und musste mit ENABLE_TOOL_SEARCH eingeschaltet werden. Dieselben Unterlagen merken an, dass die Zeile Anthropic base URL in /status nur erscheint, wenn eine Gateway-Adresse gesetzt ist.

Was die offiziellen Unterlagen bestätigen vs. Community-Aussagen und nicht veröffentlichte Details

Bestätigt durch die Fehler-, Authentifizierungs-, Umgebungsvariablen-, Gateway- und Einstellungsdokumentation von Claude Code sowie die Fehlerreferenz der Anthropic-API

1. Beide Meldungen: Invalid API key · Fix external API key bedeutet, dass ANTHROPIC_API_KEY oder ein apiKeyHelper-Skript einen Schlüssel geliefert hat, den die API abgelehnt hat, oder dass Claude Code ihn vor dem Senden blockiert hat; API Error: 401 Invalid authentication credentials bedeutet, dass das Format erkannt, aber das Konto oder die Organisation abgelehnt wurde, ein abgelaufenes Token ist also nicht die Ursache. 2.

Header: Der Wert von AUTH_TOKEN erhält das Präfix Bearer und wird als Authorization gesendet; API_KEY wird als X-Api-Key gesendet. 3. Rangfolge: AUTH_TOKEN steht über API_KEY, und eine Anmeldung steht unter beiden; im interaktiven Modus braucht ein API-Schlüssel einmal Ihre Zustimmung, im -p-Modus wird der Schlüssel verwendet, wann immer er vorhanden ist. 4.

Gateway-Fall: Wenn die Adresse auf ein Gateway zeigt, ist der Text nach 401 die Meldung des Gateways und /login ändert sie nicht; die Anmeldeinformation gehört in AUTH_TOKEN, API_KEY oder apiKeyHelper, je nachdem, was das Gateway verlangt. 5. Einstellungsdateien: Der env-Block gilt überall, wo Claude Code läuft, die benutzerseitige ~/.claude/settings.json deckt alle Ihre Projekte ab, die projektlokale .claude/settings.local.json deckt ein Projekt ab, und die .claude/settings.json eines Projekts wird eingecheckt, dort gehören keine Anmeldeinformationen hinein. 6.

Nachbarn: 403 ist unzureichende Berechtigung, 429 ist ein Raten- oder Ausgabenlimit, 529 ist eine überlastete API, und keiner davon ist ein Problem mit den Anmeldeinformationen.

Community-Aussagen und was die offiziellen Unterlagen nicht sagen

1. Das Hinzufügen von /v1 zur Adresse ist sicherer: In Community-Diskussionen heißt es, /v1 am Ende der Adresse wegzulassen, da /v1/messages für Sie angehängt wird; die offizielle Verifizierungsanfrage lautet $ANTHROPIC_BASE_URL/v1/messages, was zeigt, dass /v1 nicht Teil der Variable ist. Bei QCode lautet der Wert https://api.qcode.cc/api, und ein zusätzliches /v1 am Ende erzeugt weiterhin ein doppeltes /v1/v1/messages. 2.

Ein export im Terminal ist immer wirksam: Die offizielle Dokumentation warnt, dass direnv, dotenv-Shell-Plugins und IDE-Terminals einen veralteten Schlüssel aus einer .env-Datei des Projekts laden können, und Community-Beiträge berichten, dass die Einstellungsdatei den Vorrang hat, wenn beide dieselbe Variable setzen; lesen Sie daher /status, bevor Sie die Shell bearbeiten. 3.

Ein neues /login ersetzt einen API-Schlüssel: Das tut es nicht. Die Dokumentation besagt, dass ein genehmigter API-Schlüssel Vorrang vor Ihrer Anmeldung hat und /login ihn nicht ersetzt; entfernen Sie ihn oder rotieren Sie den Schlüssel.

Zwei Wege: API_KEY direkt zu Anthropic vs. AUTH_TOKEN über ein Gateway

ANTHROPIC_API_KEY: ein Console-Schlüssel für den direkten Zugriff auf die Anthropic-API

Er wird als Header X-Api-Key gesendet und stammt aus der Claude Console. Im interaktiven Modus stimmen Sie einmal zu, und die Wahl wird gespeichert; im -p-Modus wird er verwendet, wann immer er vorhanden ist. Er hat Vorrang vor Ihrer Abo-Anmeldung, weshalb ein weiterhin aktiver Plan immer wieder 401 zurückgeben kann: Wechseln Sie den Schlüssel in der Console oder heben Sie ihn auf und fallen Sie auf das Abo zurück.

ANTHROPIC_AUTH_TOKEN: die Bearer-Anmeldeinformation, die ein Gateway erwartet

Ihr Wert erhält das Präfix Bearer und wird als Authorization gesendet, für Gateways, die mit Bearer-Tokens authentifizieren. Bei QCode lautet die Adresse https://api.qcode.cc/api ohne /v1, und die Zugangsdaten sind der Schlüssel, der mit cr_ beginnt; führen Sie unset ANTHROPIC_API_KEY aus, damit nie zwei Zugangsdaten nebeneinander bestehen. Offizielle Empfehlung: Wenn ein Gateway nicht angibt, welche Art es erwartet, beginnen Sie mit AUTH_TOKEN und bestätigen Sie es mit einer Verifizierungsanfrage.

Sechs Schritte: von der genauen Fehlerzeile zum neu gestarteten, geprüften Client

1. Lesen Sie die genaue Zeile und ordnen Sie sie einem von drei Fällen zu: Invalid API key · Fix external API key bedeutet, dass der Schlüssel abgelehnt oder vor dem Senden blockiert wurde; API Error: 401 Invalid authentication credentials bedeutet, dass das Format in Ordnung war und das Konto oder die Organisation abgelehnt wurde; wenn die Adresse auf ein Gateway zeigt, gehört der Text nach 401 zum Gateway, ändern Sie also die dort verlangten Zugangsdaten, statt /login auszuführen. 2.

Führen Sie /status aus: Prüfen Sie, ob die Zeile Anthropic base URL vorhanden ist und welche Adresse sie nennt, und lesen Sie dann die Zeile Auth token oder API key, um zu sehen, welche Zugangsdaten wirksam sind. 3. Öffnen Sie ~/.claude/settings.json und suchen Sie im env-Block nach einem veralteten ANTHROPIC_BASE_URL oder einem alten Schlüssel; wenn dieselbe Variable auch in der Einstellungsdatei gesetzt ist, wirkt der im Terminal geänderte Wert möglicherweise nicht.

Legen Sie Zugangsdaten niemals in einer projektbezogenen .claude/settings.json ab, die eingecheckt wird. 4. Behalten Sie eine Zugangsdaten-Variable: Setzen Sie für ein Gateway ANTHROPIC_AUTH_TOKEN und führen Sie unset ANTHROPIC_API_KEY aus; für den direkten Anthropic-Zugriff machen Sie es umgekehrt, behalten ANTHROPIC_API_KEY und entfernen AUTH_TOKEN. 5.

Prüfen Sie die Adresse: Die Claude-Code-Adresse von QCode ist https://api.qcode.cc/api ohne /v1, während Codex https://api.qcode.cc/openai verwendet; vermischen Sie die beiden nicht. 6. Starten Sie claude neu und senden Sie eine minimale Anfrage mit curl: POST $ANTHROPIC_BASE_URL/v1/messages mit Authorization: Bearer $ANTHROPIC_AUTH_TOKEN und anthropic-version: 2023-06-01.

Ein 401 bedeutet, wechseln Sie zur anderen Variable und versuchen Sie es erneut; ein JSON-Body bedeutet, Adresse und Zugangsdaten sind beide richtig.

Die QCode-Seite: eine Adresse, eine Variable

QCode ist ein unabhängiger API-Zugangsdienst ohne Verbindung zu Anthropic, OpenAI oder anderen Anbietern. Claude-Modelle laufen ausschließlich über den Anthropic-Messages-Endpunkt: Setzen Sie ANTHROPIC_BASE_URL auf https://api.qcode.cc/api ohne /v1, setzen Sie ANTHROPIC_AUTH_TOKEN auf den Schlüssel, der mit cr_ beginnt, und führen Sie unset ANTHROPIC_API_KEY aus, damit nie zwei Zugangsdaten nebeneinander bestehen.

Schreiben Sie beide Zeilen in den env-Block von ~/.claude/settings.json, starten Sie claude neu und prüfen Sie dann die Zeilen Anthropic base URL und Auth token in /status. Codex verwendet eine andere Adresse, https://api.qcode.cc/openai, mischen Sie sie also nicht mit Claude Code. Die Abrechnung erfolgt pro Token; die aktuellen Preise für jedes Modell finden Sie auf /models.

Noch nicht bereit für einen Monatsplan? Nutzungspakete beginnen bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen verbrauchen; wenn Sie bereits einen Privatplan haben, fügen Sie ein Booster-Pack hinzu, wenn Sie mehr Kontingent benötigen.

Häufige Fragen

Ich habe ANTHROPIC_AUTH_TOKEN in meinem Terminal exportiert, und Claude Code gibt trotzdem 401 zurück. Warum?

Führen Sie zuerst /status aus und lesen Sie, welche Zugangsdaten die Zeile Auth token oder API key nennt und welche Adresse die Zeile Anthropic base URL zeigt; das ist der offizielle Weg, die wirksame Quelle der Zugangsdaten zu sehen. Drei übliche Ursachen. Erstens ein veralteter Wert in der Einstellungsdatei: Alles, was in den env-Block von ~/.claude/settings.json geschrieben wird, gilt überall, wo Claude Code läuft, und wird nicht unbedingt durch den neuen Wert in Ihrem Terminal überschrieben. Zweitens ein Schlüssel, der von anderswo geladen wird: Die Dokumentation warnt, dass direnv, dotenv-Shell-Plugins und IDE-Terminals einen Schlüssel aus einer projektbezogenen .env-Datei laden können, den Sie nie ausdrücklich gesetzt haben; führen Sie deshalb env | grep ANTHROPIC in derselben Shell aus. Drittens ein Schlüssel von einem anderen Dienst als der Endpunkt: ein eigener Endpunkt mit einem Anthropic-Schlüssel oder eine direkte Adresse mit einem Gateway-Schlüssel.

Was ist der Unterschied zwischen ANTHROPIC_AUTH_TOKEN und ANTHROPIC_API_KEY?

Der Header und der Einsatzzweck. Dem AUTH_TOKEN-Wert wird Bearer vorangestellt, und er wird als Authorization gesendet, für Gateways oder Proxys, die mit Bearer-Tokens authentifizieren. ANTHROPIC_API_KEY wird als X-Api-Key gesendet und ist für einen Claude-Console-Schlüssel beim direkten Anthropic-API-Zugriff gedacht. Die offizielle Rangfolge setzt AUTH_TOKEN vor API_KEY, sind also beide vorhanden, wird AUTH_TOKEN verwendet: Behalten Sie hinter einem Gateway diesen und entfernen Sie den anderen, beim direkten Zugriff umgekehrt. Wenn Sie nicht wissen, welchen ein Gateway erwartet, empfiehlt die Dokumentation, mit AUTH_TOKEN zu beginnen und es mit einer Verifizierungsanfrage zu bestätigen.

Sollte ANTHROPIC_BASE_URL /v1 enthalten?

Nein. Hängen Sie /v1 nicht an das Ende der Adresse an; /v1/messages wird von Claude Code selbst angehängt, und die offizielle Verifizierungsanfrage lautet $ANTHROPIC_BASE_URL/v1/messages, was zeigt, dass /v1 nicht Teil des Werts ist. Ein zusätzliches Segment am Ende erzeugt /v1/v1/messages, das Gateway kann diesen Pfad nicht routen, und die Antwort sieht oft wie ein Problem mit den Anmeldedaten aus. Bei QCode lautet der Wert https://api.qcode.cc/api, wobei /api Teil der Adresse selbst ist und kein doppeltes /v1. Dieselbe Regel gilt nicht für jeden Client: OpenAI-kompatible SDKs und Codex verwenden Adressen mit /openai oder /openai/v1.

Was ist der Unterschied zwischen 401 und 403?

401 betrifft die Zugangsdaten selbst: Die API-Referenz definiert ihn als authentication_error, das heißt, der Schlüssel ist fehlerhaft, widerrufen oder abgelaufen. 403 ist permission_error: Der Schlüssel ist gültig, hat aber keine Berechtigung für die angeforderte Ressource, prüfen Sie also die Zugriffseinstellungen von Organisation und Workspace in der Console. Eine Ausnahme sollten Sie sich merken: Wenn der 401-Text mit CORS requests are not allowed for this Organization beginnt, sind nicht die Zugangsdaten das Problem, denn die Anfrage trug einen Origin-Header aus einem Browser und muss stattdessen von Ihrem eigenen Backend gesendet werden; ein anderer Schlüssel ändert daran nichts.

Sind 429 und 529 Probleme mit dem Schlüssel?

Nein. Keine der beiden Zahlen betrifft die Zugangsdaten, und ein neuer Schlüssel behebt sie nicht. 429 ist rate_limit_error: Die Organisation hat ein Ratenlimit, die monatliche Ausgabengrenze ihrer Nutzungsstufe oder eine Ausgabengrenze im Claude-Code-Workspace erreicht; ein solcher 429 kann weiter scheitern, bis der Zugriff wieder möglich ist, und kann ohne retry-after-Header ankommen. 529 ist overloaded_error: Die API ist vorübergehend überlastet, was laut Dokumentation vorkommen kann, wenn der Verkehr über alle Nutzer hinweg hoch ist. Das offizielle SDK versucht diese vorübergehenden Fehler automatisch erneut, standardmäßig zweimal, und beachtet dabei retry-after.

Was mache ich, wenn apiKeyHelper fehlschlägt oder Anfragen weiterhin 401 zurückgeben?

Führen Sie das Skript zuerst allein aus und bestätigen Sie, dass es einen gültigen Schlüssel auf stdout ausgibt; das ist der erste offizielle Schritt zur Fehlersuche. Wenn das Skript keinen Schlüssel zurückgibt, erreicht die Anfrage die API mit Platzhalter-Zugangsdaten und wird mit 401 abgelehnt: Vor v2.1.208 verbrauchte Claude Code das volle Wiederholungsbudget damit, die Anfrage mit den Platzhalter-Zugangsdaten erneut zu senden, und meldete dann einen allgemeinen 401 authentication error statt des Skriptfehlers; ab v2.1.208 erscheint bei einem Skript, das einen Fehler auslöst, in eine Zeitüberschreitung läuft oder nichts ausgibt, innerhalb von drei Versuchen die Meldung Your apiKeyHelper script is failing. Wenn es länger als 10 Sekunden dauert, bis ein Schlüssel zurückkommt, erscheint ein Hinweis mit der verstrichenen Zeit in der Eingabezeile. Wenn das Skript in Ordnung ist und Sie weiterhin 401 erhalten, prüfen Sie in /status, ob seine Ausgabe die wirksamen Zugangsdaten sind, denn AUTH_TOKEN und API_KEY stehen vor apiKeyHelper, und eine übrig gebliebene Variable bedeutet, dass der Schlüssel des Skripts nie verwendet wird. Beachten Sie, dass Claude Desktop und Cloud-Sitzungen apiKeyHelper nicht aufrufen und diese Umgebungsvariablen nicht lesen.

Quellen

Claude-Code-Fehlerreferenz code.claude.com/docs/en/errors (geprüft am 2026-11-20); Authentifizierung und Vorrang code.claude.com/docs/en/authentication (geprüft am 2026-11-20); Umgebungsvariablen code.claude.com/docs/en/env-vars (geprüft am 2026-11-20); LLM-Gateway-Verbindung code.claude.com/docs/en/llm-gateway-connect (geprüft am 2026-11-20); Einstellungsdateien code.claude.com/docs/en/settings (geprüft am 2026-11-20); Anthropic-API-Fehler platform.claude.com/docs/en/api/errors (geprüft am 2026-11-20); Community-Aussagen stammen aus öffentlichen Diskussionsbeiträgen und sind im Text als solche gekennzeichnet. Alle geprüft am 2026-11-20.

Richten Sie Adresse und Zugangsdaten aufeinander aus und prüfen Sie dann mit /status und einer Anfrage

Erstellen Sie ein Konto für einen cr_-Schlüssel, setzen Sie ANTHROPIC_BASE_URL=https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN in Claude Code und rufen Sie Modelle auf, die pro Token abgerechnet werden, mit Preisen auf /models.

Unsicher, womit Sie anfangen sollen?

Eine Woche ausprobieren

Kleinpaket für $4: $30 Kontingent, 7 Tage gültig

Täglich im Einsatz

Starter für $9.00 pro Monat mit $5 Kontingent pro Tag: nur etwa $0.060 pro $1 Kontingent, beim Mittelpaket etwa $0.113