Erreur 401 de Codex CLI : corriger la bonne voie d'authentification

Une erreur 401 du CLI Codex signifie que l’authentification a été rejetée par le serveur qui traite la requête. La vérification la plus utile et la plus rapide consiste à examiner ensemble l’hôte de destination, le provider sélectionné et la source des identifiants. Une variable d’environnement vide est une possibilité ; ce n’est pas l’explication de toutes les erreurs 401. Suivez la branche correspondant à votre configuration.

Identifiez d’abord la connexion qui a échoué

Enregistrez l’état, le texte de l’erreur, l’horodatage et l’ID de requête lorsqu’ils sont disponibles. Supprimez les en-têtes d’autorisation, les clés et les jetons avant de partager les détails. Ne collez pas auth.json dans un ticket d’assistance : il peut contenir des identifiants. Une erreur d’une intégration ne permet pas d’établir que la connexion au modèle est défaillante.

1. Vérifiez la CLI et la méthode de connexion

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

Effectuez les vérifications dans le même terminal que celui qui lance Codex. Remplacez le nom de variable dans la vérification de présence si votre fournisseur en utilise une autre env_key. « Défini » confirme seulement qu’une valeur existe ; cela ne prouve pas qu’elle est à jour ou acceptée par la destination.

Pour une connexion personnelle à ChatGPT qui a cessé de s’actualiser, utilisez codex logout suivi de codex login, puis terminez le parcours dans le navigateur pour le compte souhaité. Cela modifie l’état de connexion enregistré ; ce n’est pas une étape requise pour chaque erreur de fournisseur personnalisé. Dans une automatisation gérée, suivez plutôt la méthode d’authentification de l’administrateur. Consultez le guide officiel d’authentification.

2. Associez une clé API à son émetteur et à sa destination

Une clé de la plateforme OpenAI doit être utilisée sur la route de l’API OpenAI. Une clé Kunavo doit être utilisée sur la route Kunavo. Une connexion réussie à ChatGPT dans le navigateur ne valide pas une clé de passerelle, et le solde d’une passerelle n’est pas un solde de la plateforme OpenAI. Vérifiez l’hôte réel indiqué dans l’erreur avant de remplacer quoi que ce soit.

Dans le tableau de bord de l’émetteur, confirmez que la clé existe toujours et qu’elle est active. Vérifiez le projet associé et les éventuelles restrictions d’accès. La référence des erreurs de l’API OpenAI inclut les identifiants invalides, l’appartenance à une organisation et les échecs de liste blanche d’adresses IP parmi les erreurs d’authentification. Utilisez le message associé pour choisir la correction ; créer des clés à répétition ne répare ni un compte ni une politique réseau.

3. Vérifiez la configuration du fournisseur utilisée par Codex

# 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"

Le model_provider sélectionné doit correspondre au bloc du fournisseur. Le champ env_key nomme la variable ; il ne contient pas le secret. Vérifiez la configuration active ainsi que tout remplacement de profil ou de ligne de commande, puis redémarrez Codex après la correction. Évitez de copier un bloc de fournisseur sans rapport par-dessus votre configuration fonctionnelle.

La référence de configuration d’OpenAI documente le protocole Responses. Une URL de base se terminant par /v1 est différente d’une URL complète de requête /v1/responses. Un chemin incorrect nécessite généralement un diagnostic du point de terminaison, même après la réussite de l’authentification. Vérifiez également requires_openai_auth : lorsqu’il est activé, l’authentification OpenAI est prioritaire sur env_key, comme indiqué dans le guide d’authentification.

4. Modifiez un seul élément et réessayez une petite tâche

1. Conservez les détails de l’erreur et identifiez la route sélectionnée.
2. Corrigez la connexion, l’identifiant ou le champ du fournisseur indiqué par les éléments disponibles.
3. Redémarrez le processus de la CLI ou de l’éditeur concerné afin qu’il reçoive le nouveau paramètre.
4. Effectuez une petite requête avant de relancer une longue tâche de codage.
5. Si l’échec persiste, envoyez au fournisseur une erreur expurgée et l’ID de requête, pas l’identifiant.

Un 429 ultérieur, un avertissement de solde ou une erreur de modèle introuvable constitue une nouvelle branche de diagnostic. Conservez la correction d’authentification et traitez le problème suivant au lieu d’annuler tous les paramètres. Le guide des limites de Codex distingue ces cas. Pour une configuration Kunavo, utilisez l’intégration Codex complète et gérez les clés dans votre tableau de bord.

Questions fréquentes

Documentation officielle et aide locale de la CLI vérifiées le 17 septembre 2026. Aucun identifiant n’a besoin d’être partagé pour effectuer ces vérifications.