401-Authentifizierungsfehler in Codex CLI beheben

Ein Codex-CLI-401-Fehler bedeutet, dass der Server, der die Anfrage verarbeitet, die Authentifizierung abgelehnt hat. Die schnellste hilfreiche Prüfung umfasst Zielhost, ausgewählten Anbieter und Quelle der Zugangsdaten. Eine leere Umgebungsvariable ist eine mögliche Ursache, aber nicht die Erklärung für jeden 401-Fehler. Folgen Sie dem Zweig, der zu Ihrer Einrichtung passt.

Zuerst feststellen, welche Verbindung fehlgeschlagen ist

Fehlerstelle	Wahrscheinlicher Bereich	Erste Prüfung
ChatGPT-Anmeldung oder Token-Erneuerung	Gespeicherte Kontositzung	Aktive Anmeldung und vorgesehener Workspace
Anfrage an die OpenAI API	Plattformzugangsdaten und Projekt	Gültigkeit des Schlüssels und Projektzugriff
Anfrage an ein benutzerdefiniertes Gateway	Konfiguration dieses Anbieters	Host, Anbieter-ID und benannte Umgebungsvariable
Nur ein MCP- oder externes Tool schlägt fehl	Separate Anmeldung dieses Tools	Name und Authentifizierung des Tools

Speichern Sie Status, Fehlermeldung, Zeitstempel und, falls vorhanden, die Anfrage-ID. Entfernen Sie Autorisierungsheader, Schlüssel und Token, bevor Sie Details weitergeben. Fügen Sie auth.json nicht in ein Support-Ticket ein: Es kann Zugangsdaten enthalten. Ein Fehler in einer Integration beweist nicht, dass die Modellverbindung unterbrochen ist.

1. CLI und Anmeldemethode prüfen

Schreibgeschützte Authentifizierungsprüfungen

codex --version
codex login status

# POSIX shell: report presence only, without printing the secret
if [ -n "${KUNAVO_API_KEY:-}" ]; then
  printf 'KUNAVO_API_KEY is set\n'
else
  printf 'KUNAVO_API_KEY is missing or empty\n'
fi

Führen Sie die Prüfungen in demselben Terminal aus, in dem Codex gestartet wird. Ersetzen Sie den Variablennamen in der Prüfung auf Vorhandensein, wenn Ihr Anbieter eine andere env_key verwendet. „Set“ bestätigt lediglich, dass ein Wert vorhanden ist; es kann nicht nachweisen, dass der Wert aktuell ist oder vom Ziel akzeptiert wird.

Wenn eine persönliche ChatGPT-Anmeldung nicht mehr aktualisiert wird, verwenden Sie codex logout gefolgt von codex login und schließen Sie anschließend den Browserablauf für das vorgesehene Konto ab. Dadurch wird der gespeicherte Anmeldestatus geändert; für nicht standardmäßige Anbieterfehler ist dies nicht immer erforderlich. Befolgen Sie bei verwalteter Automatisierung stattdessen die Authentifizierungsmethode des Administrators. Siehe den offiziellen Authentifizierungsleitfaden.

2. Einen API-Schlüssel seinem Aussteller und Ziel zuordnen

Ein OpenAI-Platform-Schlüssel gehört zur OpenAI-API-Route. Ein Kunavo-Schlüssel gehört zur Kunavo-Route. Eine erfolgreiche ChatGPT-Browseranmeldung validiert keinen Gateway-Schlüssel, und ein Gateway-Guthaben ist kein OpenAI-Platform-Guthaben. Prüfen Sie den tatsächlichen Host in der Fehlermeldung, bevor Sie etwas ersetzen.

Bestätigen Sie im Dashboard des Ausstellers, dass der Schlüssel noch vorhanden und aktiv ist. Prüfen Sie das zugehörige Projekt und etwaige Zugriffsbeschränkungen. Die OpenAI API error reference führt ungültige Zugangsdaten, Organisationsmitgliedschaft und IP-Allowlist-Fehler unter Authentifizierungsfehlern auf. Verwenden Sie die begleitende Meldung, um die Korrektur auszuwählen; wiederholtes Erstellen von Schlüsseln behebt keine Konto- oder Netzwerkrichtlinie.

3. Die von Codex verwendete Anbieterkonfiguration prüfen

Zu überprüfende Anbieterfelder

# Compare these non-secret fields with your intended provider.
model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"

Der ausgewählte model_provider muss zum Anbieterblock passen. Das Feld env_key benennt die Variable; es enthält nicht das Geheimnis. Prüfen Sie die aktive Konfiguration sowie Profil- oder Befehlszeilenüberschreibungen und starten Sie Codex nach der Korrektur neu. Kopieren Sie keinen unabhängigen Anbieterblock über Ihre funktionierende Konfiguration.

OpenAIs configuration reference dokumentiert das Responses-Protokoll. Eine Base-URL, die auf /v1 endet, unterscheidet sich von einer vollständigen /v1/responses-Anfrage-URL. Ein falscher Pfad erfordert in der Regel eine Endpunktdiagnose, selbst wenn die Authentifizierung erfolgreich ist. Prüfen Sie außerdem requires_openai_auth: Wenn diese Option aktiviert ist, hat die OpenAI-Authentifizierung Vorrang vor env_key, wie im Authentifizierungsleitfaden beschrieben.

4. Eine Änderung vornehmen und eine kleine Aufgabe erneut versuchen

Bewahren Sie die Fehlerdetails auf und ermitteln Sie die ausgewählte Route.
Korrigieren Sie die Anmeldung, Zugangsdaten oder das Anbieterfeld, auf die die Belege hinweisen.
Starten Sie den betroffenen CLI- oder Editorprozess neu, damit er die neue Einstellung übernimmt.
Führen Sie eine kleine Anfrage aus, bevor Sie eine längere Programmieraufgabe neu starten.
Wenn der Fehler bestehen bleibt, senden Sie dem Anbieter eine bereinigte Fehlermeldung und die Anfrage-ID, nicht die Zugangsdaten.

Ein späterer 429-Fehler, ein Guthabenhinweis oder ein Fehler wegen eines fehlenden Modells ist ein neuer Diagnosezweig. Behalten Sie die Authentifizierungskorrektur bei und bearbeiten Sie das nächste Problem, statt alle Einstellungen rückgängig zu machen. Der Codex limits guide trennt diese Fälle. Verwenden Sie für eine Kunavo-Einrichtung die vollständige Codex integration und verwalten Sie Schlüssel in Ihrem Dashboard.

Häufig gestellte Fragen

Was bedeutet ein Codex-CLI-401-Fehler?

Der Server, der die Anfrage empfängt, hat die Authentifizierung abgelehnt. Ursache können eine veraltete Kontositzung, ein ungültiger oder widerrufener Schlüssel, an den falschen Anbieter gesendete Zugangsdaten oder Kontobeschränkungen sein. Ermitteln Sie das Ziel und den aktiven Authentifizierungsweg, bevor Sie Zugangsdaten ändern.

Kann codex login status einen Schlüssel eines benutzerdefinierten Anbieters überprüfen?

Der Befehl meldet den Anmeldestatus der CLI, beweist jedoch nicht, dass ein umgebungsvariabler benutzerdefinierter Anbieter seinen Schlüssel akzeptiert. Prüfen Sie für diesen Weg den ausgewählten Anbieter, dessen env_key-Variable im startenden Prozess und die Kontoeinstellungen des Anbieters.

Warum funktioniert der Schlüssel in einem Terminal, aber nicht in meiner IDE?

Die Prozesse können unterschiedliche Umgebungsvariablen, Profile oder Konfigurationen verwenden. Ein Editor, der vor dem Setzen einer Variable gestartet wurde, übernimmt sie möglicherweise nicht. Vergleichen Sie den ausgewählten Anbieter und die Startumgebung und starten Sie den betroffenen Prozess nach der Korrektur der relevanten Einstellung neu.

Soll ich meine Codex-Konfiguration löschen, um die Authentifizierung zu reparieren?

Beginnen Sie mit der konkreten fehlerhaften Anmelde- oder Anbietereinstellung. Das Löschen der gesamten Konfiguration kann unabhängige Einstellungen entfernen, ohne die abgelehnten Zugangsdaten zu korrigieren. Bewahren Sie Ihre Konfiguration auf und nehmen Sie jeweils eine gezielte Änderung vor.

Offizielle Dokumentation und lokale CLI-Hilfe geprüft am 17. September 2026. Für diese Prüfungen müssen keine Zugangsdaten weitergegeben werden.