Ein 401-Fehler von Claude hat immer eine von fünf Ursachen: falscher Header, falscher Schlüsseltyp für den Endpunkt, fehlerhafte Umgebungsvariable, widerrufener Schlüssel oder falsche Base-URL für diesen Schlüssel. Führen Sie die folgende Diagnose aus; in weniger als einer Minute finden Sie die Ursache.
Der Fehler
{
"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 Endpunkt | Anthropics native API erwartet x-api-key + anthropic-version; OpenAI-kompatible Endpunkte erwarten Authorization: Bearer. |
| Schlüssel-/Endpunkt-Mismatch | sk-ant-…-Schlüssel funktionieren ausschließlich mit api.anthropic.com; Gateway-Schlüssel (z. B. sk-kn-…) funktionieren ausschließlich mit ihrer eigenen Gateway-URL. |
| Leerzeichen oder Anführungszeichen in die Umgebungsvariable eingeschleust | Ohne Anführungszeichen/Zeilenumbrüche erneut exportieren; len(key) ausgeben, um ein abschließendes \n vom Kopieren und Einfügen zu erkennen. |
| Schlüssel widerrufen oder Workspace deaktiviert | Erstellen Sie in der Konsole einen neuen Schlüssel und wechseln Sie ihn in Ihrem Secret Manager aus. |
Mit rohem curl reproduzieren (SDK aus der Gleichung entfernen)
Wenn curl funktioniert, Ihre App aber nicht, liegt der Fehler in Ihrer Umgebungsvariablen-Verkabelung, nicht im Schlüssel:
# Native Anthropic wire (works on api.anthropic.com and Kunavo /v1/messages)
curl -s https://api.kunavo.com/v1/messages \
-H "x-api-key: $KUNAVO_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
# OpenAI-compatible wire (Bearer header instead)
curl -s https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
# Check the key isn't carrying whitespace
python3 -c "import os; k=os.environ['KUNAVO_API_KEY']; print(repr(k[:12]), len(k))"Schlüsselpräfix an die Base-URL anpassen
sk-ant-… → api.anthropic.com. sk-kn-… → api.kunavo.com/v1. Einen Gateway-Schlüssel an Anthropic zu senden (oder umgekehrt) führt immer zu 401 — die Fehlermeldung sagt nie „falscher Host“, weshalb diese Ursache leicht übersehen wird.
Schlüssel austauschen, wenn er jemals ein Repository oder Log berührt hat
Wenn der Schlüssel korrekt ist und weiterhin abgelehnt wird, gehen Sie von einem Widerruf aus (automatisierte Scanner widerrufen geleakte Schlüssel schnell). Erstellen Sie einen neuen Schlüssel und speichern Sie ihn in einem Secret Manager statt in .env-Dateien, die committed werden.
Wenn Sie Kunavo verwenden
Kunavo-Schlüssel (sk-kn-…) authentifizieren sich an jedem Endpunkt mit beiden Headern — Authorization: Bearer, wie ihn die OpenAI-SDKs senden, oder x-api-key, wie es die Anthropic-SDKs tun — daher ändert sich unabhängig vom verwendeten SDK nur die Base-URL. Schlüssel werden im Dashboard sofort erstellt und widerrufen. Sobald der Schlüssel authentifiziert ist, finden Sie die Abrechnungssätze unter Preisliste der Anthropic-Claude-API.
Häufig gestellte Fragen
Warum funktioniert mein Schlüssel mit curl, aber nicht in meiner App?
Fast immer liegt es an der Umgebungsvariablen-Verkabelung: ein abschließender Zeilenumbruch vom Kopieren und Einfügen, mitgespeicherte Anführungszeichen, die Variable wurde nicht in den Prozess exportiert oder in der Produktion wird eine andere Umgebung geladen. Geben Sie Repräsentation und Länge des Schlüssels innerhalb des fehlschlagenden Prozesses aus.
Kann ich meinen Anthropic-Console-Schlüssel an einem OpenAI-kompatiblen Gateway verwenden?
Nein. Jeder Dienst authentifiziert ausschließlich seine eigenen Schlüssel: sk-ant-Schlüssel gehören zu api.anthropic.com, Gateway-Schlüssel gehören zum Gateway. Besorgen Sie sich einen Schlüssel von der Base-URL, die Sie aufrufen.
Weitere Informationen zur Fehlersemantik finden Sie unter Fehlerreferenz; einen Schlüssel erhalten Sie in einer Minute über Registrierung und die Authentifizierungsanleitung.