Startseite › Claude Code › Fehler › 401 / 403 Authentifizierung
ÜberblickInstallationCLI-ReferenzPreise und LimitsAgent SDKSkills und PluginsGitHubWeb, Desktop und IDEModelleFehlerOpen Source?TutorialFür StudierendeQA-AutomatisierungVergleich mit CursorVergleich mit Codex und OpenCodeSubagentenHooksMCPÖkosystemVS CodeOpenRouterAnfragelimitsChinesischer Leitfaden
Zuletzt aktualisiert: 11. Oktober 2026

Claude Code 401 und 403: ungültige Authentifizierungsdaten, ungültiger API-Schlüssel, „Nicht angemeldet“, host_not_allowed

401 bedeutet, dass die von Claude Code gesendeten Anmeldedaten nicht akzeptiert wurden; 403 bedeutet, dass sie akzeptiert wurden, die Anfrage aber nicht zulässig war. Fast jeder 401-Bericht im Issue-Tracker läuft darauf hinaus, *welche* Anmeldedaten gesendet wurden, denn Claude Code kann drei gleichzeitig speichern: eine OAuth-Anmeldung, einen ANTHROPIC_API_KEY in der Umgebung und einen apiKeyHelper in den Einstellungen. Finden Sie zunächst heraus, welche davon aktiv sind.

TLDR

  • /status zeigt die aktive Authentifizierungsmethode und den Endpunkt an. Ein API-Schlüssel in der Umgebung hat immer Vorrang vor /login.
  • invalid x-api-key / Invalid API key · Fix external API key — der Schlüssel gehört nicht zum Endpunkt in ANTHROPIC_BASE_URL.
  • 401 Invalid authentication credentials nach /login — das OAuth-Token wurde widerrufen oder fehlerhaft aktualisiert; melden Sie sich ab, löschen Sie die gespeicherten Anmeldedaten und melden Sie sich erneut an.
  • 403 — ein Proxy, eine Egress-Regel der Sandbox oder die Organisationsmitgliedschaft hat die Anfrage blockiert; die Anmeldedaten sind in Ordnung.

Die Meldungen

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}
API Error: 401 invalid x-api-key
Invalid API key · Fix external API key
Not logged in · Please run /login
Login expired · Please run /login
API Error: 403 x-deny-reason: host_not_allowed
Error: Poll: Access denied (403): Account is no longer a member of the organization associated with this token.

Schritt 1: Welche Anmeldedaten werden gesendet?

claude
/status                       # auth method, endpoint, model
echo $ANTHROPIC_API_KEY | cut -c1-12
echo $ANTHROPIC_BASE_URL
grep -n apiKeyHelper ~/.claude/settings.json

Die Rangfolge ist einfach, sobald man sie kennt: Ein ANTHROPIC_API_KEY in der Umgebung (oder der von apiKeyHelperzurückgegebene Wert) wird anstelle der OAuth-Anmeldung verwendet. Ein veralteter Schlüssel, der vor Monaten in .bashrc exportiert wurde, oder ein Schlüssel von einem anderen Gateway ist die klassische Ursache für einen 401, der auch nach jedem /loginbestehen bleibt. Entfernen Sie die Variable oder setzen Sie den richtigen Schlüssel.

401 mit einem API-Schlüssel: Schlüssel und Endpunkt passen nicht zusammen

invalid x-api-key und Invalid API key · Fix external API key bedeuten, dass der Endpunkt den Schlüssel nicht erkannt hat. Ein Schlüssel gehört zu genau einem Endpunkt: Ein Schlüssel aus der Anthropic-Konsole funktioniert nur mit api.anthropic.com; ein Gateway-Schlüssel funktioniert nur mit dem ANTHROPIC_BASE_URLdieses Gateways. Wenn Sie einen Konsolenschlüssel an https://aiprimetech.io oder einen Gateway-Schlüssel an Anthropic senden, wird in beiden Fällen 401 zurückgegeben. Prüfen Sie auch, ob beim Einfügen ein abschließender Zeilenumbruch oder ein Anführungszeichen in die Variable gelangt ist und ob der Schlüssel im Dashboard widerrufen oder rotiert wurde.

curl -s https://aiprimetech.io/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" | head -c 300
# a JSON list = key accepted; authentication_error = wrong key for this host

401 nach /login: das OAuth-Token

API Error: 401 Invalid authentication credentials direkt nach einer erfolgreichen Browser-Anmeldung ist das am häufigsten gemeldete Muster (#69706, offen, Windows, aktives Pro-Abonnement; #44265, Token unmittelbar nach der Anmeldung als abgelaufen gemeldet).

Ein Kommentator im ersten Thread stellte fest, dass der gespeicherte refreshToken in ~/.claude/.credentials.jsoneine leere Zeichenfolge war, wodurch jede Anfrage 401 auslöst, bis die Datei durch eine erneute Anmeldung ersetzt wird. #54443 dokumentiert, dass der Server Sitzungen vor dem lokal gespeicherten Ablaufzeitpunkt ablehnt und der Aufruf zur Token-Aktualisierung 400 zurückgibt, sodass Please run /login alle paar Stunden wieder auftritt; mehrere Claude Code-Instanzen mit einem Konto verschärfen das Problem, weil sie gleichzeitig versuchen, dasselbe Token zu aktualisieren. #44585: /login gibt *Anmeldung erfolgreich* aus und wechselt sofort wieder zu *Nicht angemeldet*.

  • /logout, löschen Sie dann die gespeicherten Anmeldedaten (~/.claude/.credentials.json unter Linux und Windows; den Eintrag *Claude Code-credentials* in der Schlüsselbundverwaltung unter macOS), dann /login in einem Browser ohne die Erweiterung Claude in Chrome.
  • Schließen Sie vor der Anmeldung andere Claude Code-Fenster, die Desktop-App und IDE-Erweiterungen; sie aktualisieren dasselbe Token. Die Seite zu OAuth-Fehlern behandelt *OAuth-Token konnte nicht aktualisiert werden: Ein anderer Claude Code-Prozess aktualisiert es gerade*.
  • claude update: #54235 führte einen 401 auf eine bestimmte Version und eine Umgebungsvariable für ein Beta-Flag zurück; Regressionen bei der Authentifizierung werden schnell behoben.
  • Rechner ohne grafische Oberfläche oder per SSH: claude setup-token auf einem Rechner, auf dem die Browser-Anmeldung funktioniert, und verwenden Sie das Token dann dort.
  • Jetzt arbeiten zu können ist besser als Fehlersuche: Wenn ANTHROPIC_API_KEY gesetzt ist, greift Claude Code nie auf OAuth zu.

403: Authentifizierung erlaubt, Aktion nicht erlaubt

  • `x-deny-reason: host_not_allowed` — ein vorgeschalteter Proxy verweigert das Ziel der Anfrage. Beobachtet bei der Egress-Freigabeliste der Web-/Desktop-Sandbox (#93562, offen: Hosts außerhalb einer integrierten Liste erhalten 403 bei CONNECT, selbst wenn *Alle Domains* ausgewählt ist) und bei Unternehmens-Proxys. Fügen Sie den Host zur Freigabeliste hinzu oder führen Sie die CLI außerhalb der Sandbox aus.
  • Git-Proxy der Sandbox 403 bei git push auf einen bestehenden Branch (#57356) — die Richtlinie des Git-Proxys der Sandbox, nicht GitHub. Pushen Sie aus einem normalen Terminal.
  • `Account is no longer a member of the organization associated with this token` — das Token wurde für eine Organisation ausgestellt, die Sie verlassen haben oder die sich geändert hat; claude remote-control brachte früher jede Sitzung damit zum Absturz (#53563). Melden Sie sich ab und erneut an, um ein Token für die aktuelle Organisation zu erstellen.
  • 403 von einem Gateway — der Schlüssel ist gültig, aber das Konto ist deaktiviert, das Guthaben für dieses Modell reicht nicht aus oder das Modell ist nicht in Ihrem Tarif enthalten; der Antwortinhalt nennt den Grund. Prüfen Sie das Dashboard, bevor Sie auf Clientseite etwas ändern.
  • `/feedback` gibt 403 zurück (#55348) — eine dienstseitige Störung dieses einen Endpunkts; sie betrifft das Modell nicht.

Der Weg über einen API-Schlüssel

unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL   # back to the subscription login
# or: bypass OAuth entirely
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Ein Gateway-Schlüssel ist ein einfacher API-Schlüssel: kein OAuth, keine Token-Aktualisierung, keine Organisationsmitgliedschaft, und bei der 401-Fehlerfamilie bleibt nur die Frage: *Passt der Schlüssel zum Host?* Wenn Sie in einer /login Schleife feststecken und heute noch ausliefern müssen, ist das der schnellste Ausweg; Ihre erste Krypto-Aufladung wird verdoppelt (+50 %).

Müde vom ständigen Kampf mit diesem Problem?

Nutzen Sie Claude Code stattdessen über das Gateway von AI Prime Tech: dieselben Claude-Modelle auf den eigenen Upstream-Konten des Gateways, zwei Umgebungsvariablen für den Wechsel, und neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code FIXIT — ohne Kreditkarte.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Konto mit dem Code FIXIT erstellen

Häufig gestellte Fragen

Wie behebe ich „API-Fehler: 401 Ungültige Authentifizierungsdaten“ in Claude Code?

Prüfen Sie mit /status, welche Zugangsdaten aktiv sind. Entfernen Sie eine veraltete ANTHROPIC_API_KEY, oder führen Sie /logout aus, löschen Sie ~/.claude/.credentials.json (auf macOS den Eintrag im Schlüsselbund) und melden Sie sich mit /login erneut an, während alle anderen Claude Code-Instanzen geschlossen sind. Als Umgehungslösung überspringt ein API-Schlüssel OAuth vollständig.

Warum meldet Claude Code einen ungültigen API-Schlüssel?

Der Schlüssel gehört nicht zum Endpunkt in ANTHROPIC_BASE_URL. Ein Konsolenschlüssel benötigt api.anthropic.com; ein Gateway-Schlüssel benötigt die URL dieses Gateways. Prüfen Sie außerdem, ob beim Einfügen Leerzeichen übernommen wurden oder der Schlüssel widerrufen wurde.

Warum fordert Claude Code mich immer wieder auf, /login auszuführen?

Das OAuth-Token wird vor seinem lokalen Ablauf abgelehnt oder die Aktualisierung schlägt fehl, häufig weil mehrere Claude Code-Prozesse dasselbe Token verwenden. Schließen Sie die anderen Prozesse, melden Sie sich ab, löschen Sie die gespeicherten Zugangsdaten, melden Sie sich erneut an und aktualisieren Sie die CLI.

Was bedeutet 403 x-deny-reason: host_not_allowed?

Ein Proxy (die Freigabeliste für ausgehende Sandbox-Verbindungen oder ein Unternehmensproxy) hat den Zielhost abgelehnt. Ihre Zugangsdaten sind in Ordnung; geben Sie den Host frei oder führen Sie die Anwendung außerhalb der Sandbox aus.

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 FIXIT.

API-Schlüssel erhalten Unbegrenzte Tarife ansehen

AI 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.

Weitere Leitfäden zu Claude Code

Fehler in Claude Code und wie Sie sie behebenClaude Code „API-Fehler: 500“: Was er bedeutet und was wirklich hilftClaude-Fehler „Überlastet“ (API-Fehler 529): Was er bedeutet und was Sie tun könnenClaude Code API-Fehler 400: Prompt zu lang, gleichzeitige Tool-Nutzung und weitere UrsachenClaude Code OAuth-Fehler: Zeitüberschreitung von 15000ms und Statuscode 500„Claude Code-Prozess mit Code 1 beendet“: So finden und beheben Sie den eigentlichen FehlerClaude „Prompt ist zu lang“, „Eingabe ist für das angeforderte Modell zu lang“ und „Kontextlimit erreicht“: Was das Fenster füllt und wie Sie wieder Platz schaffenClaude-Nutzungslimit erreicht: Sitzungs-, Wochen- und Opus-Limits, „festgelegte API-Nutzungslimits“, „Guthaben ist zu niedrig“ — und was Sie tun könnenClaude Code-Verbindungsfehler: ECONNRESET, Verbindung während der Antwort unterbrochen, „Warten auf API-Antwort“, „Verbindung zur API nicht möglich“, SSL-ZertifikatfehlerClaude Code hängt, bleibt stecken oder reagiert nicht mehr: So finden Sie heraus, wo es festhängt, und beheben das ProblemClaude.ai funktioniert nicht: „Etwas ist schiefgelaufen“, Kapazitätsengpässe, „5-Stunden-Limit erreicht“, „Fehler bei der Anmeldung“ und weitere Probleme