Fehler 401 authentication_error / invalid x-api-key — was in welcher Reihenfolge zu prüfen ist

Fast jeder 401-Fehler hat eine von vier Ursachen, und nur eine davon lautet „der Schlüssel ist falsch“. Die anderen drei lassen den Schlüssel vollkommen gültig — deshalb ist das erneute Erstellen des Schlüssels oft vertane Mühe.

Der Fehler

Antwort (HTTP 401)

{
  "type": "error",
  "error": { "type": "authentication_error",
             "message": "invalid x-api-key" }
}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Falscher Header für den Host	Anthropic liest x-api-key; die meisten mit OpenAI kompatiblen Gateways lesen Authorization: Bearer. Derselbe Wert im falschen Header kommt wie ein fehlender Wert an.
Alte Umgebungsvariable ist noch vorhanden	Ein vergessenes ANTHROPIC_API_KEY in Ihrem Shell-Profil kann den Schlüssel überschreiben, den Sie gerade exportiert haben.
Basis-URL geändert, Zugangsdaten nicht	Wenn Sie auf einen anderen Host zeigen, wird der Schlüssel des vorherigen Anbieters dort nicht gültig. Host und Zugangsdaten müssen gemeinsam geändert werden.
Leerzeichen, Zeilenumbruch oder Anführungszeichen im Schlüssel	Beim Kopieren aus einem PDF oder Chat werden häufig unsichtbare Zeichen übernommen. Prüfen Sie die Länge der Zeichenkette.

Prüfen Sie, was die Umgebung tatsächlich enthält

Bevor Sie etwas ändern, sehen Sie sich die Variablen in derselben Shell an, in der die Anwendung ausgeführt wird. In überraschend vielen Fällen sind gleichzeitig zwei Zugangsdaten verschiedener Anbieter definiert.

conferir.sh

for v in ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL; do
  printf '%-22s [%s] tamanho=%s\n' \
    "$v" "$(printenv "$v" | cut -c1-10)" "$(printenv "$v" | wc -c)"
done

Testen Sie die Zugangsdaten außerhalb der Anwendung

Eine direkte Anfrage trennt „der Host lehnt den Schlüssel ab“ von „die Anwendung sendet den Schlüssel nicht“. Wenn curl funktioniert und der Code nicht, liegt das Problem nicht bei den Zugangsdaten.

testar.sh

curl -s -o /dev/null -w 'status=%{http_code}\n' \
  "$ANTHROPIC_BASE_URL/v1/models" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

# 200 -> credencial boa; investigue a aplicação
# 401 -> credencial ou cabeçalho errados para este host

401 von 403 und 402 unterscheiden

401 bedeutet „ich weiß nicht, wer Sie sind“: Die Zugangsdaten wurden nicht akzeptiert. 403 bedeutet „ich weiß, wer Sie sind, aber Sie dürfen das nicht“: authentifiziert, jedoch ohne Berechtigung. 402 bedeutet „ich weiß, wer Sie sind, aber Ihr Guthaben reicht nicht“. Nur 401 wird durch eine Änderung der Zugangsdaten behoben.

Wenn Sie Kunavo verwenden

Kunavo akzeptiert den Schlüssel sk-kn- sowohl in Authorization: Bearer als auch in x-api-key. Die Basis-URL ist der Ursprung der Website ohne nachfolgenden Pfad. Verwenden Sie mit Claude Code ANTHROPIC_AUTH_TOKEN zusammen mit ANTHROPIC_BASE_URL, da das Token nicht von der einmaligen Genehmigung abhängt, die ANTHROPIC_API_KEY erfordert. Entfernen Sie ANTHROPIC_API_KEY ausdrücklich — ein alter Wert in dieser Variable ist die häufigste Ursache für eine scheinbar konfigurierte, aber dennoch abgelehnte Sitzung. Die Authentifizierungsanleitung finden Sie in der Authentifizierungsdokumentation.

Häufig gestellte Fragen

Hilft es, den Schlüssel neu zu erstellen?

Nur wenn der Schlüssel tatsächlich widerrufen wurde. Bei den drei anderen häufigsten Ursachen — falschem Header, alter Variable oder geänderter Basis-URL — schlägt auch der neue Schlüssel genau gleich fehl.

Kann 401 durch fehlendes Guthaben verursacht werden?

Nein. Unzureichendes Guthaben erzeugt 402 mit einer Meldung zu Credits. 401 betrifft immer die Identität.

Bei curl funktioniert es, in meinem Code nicht. Warum?

Fast immer liest der Code eine andere Umgebungsvariable oder läuft in einer anderen Shell bzw. einem anderen Container, in dem der Export nicht angekommen ist. Geben Sie die maskierten Zugangsdaten innerhalb des Prozesses aus, um das zu bestätigen.