Résolution des problèmes Codex
Le point clé du dépannage de Codex réside dans l'interface compatible OpenAI. En règle générale, procédez au dépannage dans cet ordre : Base URL, clé API, nom du modèle, et vérification que le provider actuel est bien actif.
Que faut-il vérifier en premier ?
| Éléments à vérifier | Comment vérifier | Pourquoi |
|---|---|---|
| Le provider prend en charge les interfaces compatibles OpenAI | Le tableau de bord peut afficher l'adresse API, la Base URL, la compatibilité OpenAI et d'autres instructions | Codex doit pouvoir envoyer des requêtes à l'interface compatible |
| Base URL | Copiez le lien API fourni par le provider | Pour savoir si /v1 est requis, fiez-vous à l'exemple du tableau de bord, ne devinez pas vous-même |
| Statut de la clé | La clé n'est ni désactivée ni expirée, et le solde du compte est normal | Pour une erreur 401, commencez généralement par vérifier la clé |
| Nom du modèle | Copiez-le d'après la liste des modèles du tableau de bord | Une erreur dans le nom du modèle, la casse, les tirets ou le numéro de version provoquera un échec |
Erreurs courantes
| Symptôme | Vérification prioritaire | Solutions |
|---|---|---|
| 401 / Unauthorized | Clé API | Régénérez ou copiez la clé, et confirmez qu'elle n'est ni désactivée ni expirée, et que le solde du compte est normal. |
| 404 / model not found | Nom du modèle | N'écrivez pas les noms de modèles de mémoire ; copiez-les selon la liste des modèles du tableau de bord du provider. Si la récupération de la liste des modèles est prise en charge, obtenez d'abord la liste ; en cas d'échec, ajoutez-le manuellement. |
| Erreurs liées à la Base URL | Le lien API est-il complet | La Base URL est le lien API fourni par le provider. Pour savoir si /v1 est requis, suivez l'exemple du tableau de bord, ne devinez pas. |
| La requête n'aboutit pas alors que la clé est normale | Le protocole correspond-il | Vérifiez que le provider actuel propose une interface compatible OpenAI, et non Claude, Gemini ou une interface prenant uniquement en charge le chat web. |
| Aucun effet après l'utilisation de CC-Switch | Sélection de l'outil cible | Assurez-vous que le provider est bien appliqué à Codex et non à Claude Code ; redémarrez le terminal ou le client avant de tester à nouveau. |
Test minimal
Faites d'abord un test avec la question la plus courte possible pour confirmer que la requête aboutit avant de vous attaquer au vrai projet.
Test minimal de Codex
codex "Please reply only: Codex configuration test successful"Modèle de message pour le support
Lorsque vous contactez le provider, écrivez comme ceci
Tool: Codex System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened