Guide de configuration

Guide de configuration du fournisseur

Consultez les étapes de configuration et le dépannage par outil.

CC-Switch Codex

Cette page explique comment gérer les fournisseurs pour Codex via CC Switch. Ce n'est pas la même chose qu'une configuration directe avec le client Codex ou le CLI Codex : l'objectif ici est d'abord de gérer les fournisseurs dans CC Switch, puis de les appliquer à Codex.

Ce que cette page explique

Codex fonctionne généralement via des interfaces OpenAI ou compatibles OpenAI, veillez donc à vérifier trois éléments : la Base URL, la clé (Key) et le nom du modèle. La nécessité d'inclure ou non /v1 dans la Base URL dépend de ce qui est indiqué dans le tableau de bord du fournisseur.

Vérifications avant de commencer

Éléments à vérifierComment vérifierPourquoi
Codex peut s'ouvrir normalementVérifiez d'abord que le CLI Codex ou le client correspondant s'exécute correctementCC Switch n'installe pas Codex pour vous
Le fournisseur prend en charge les interfaces compatibles OpenAILe tableau de bord indique l'adresse de l'API, la Base URL, la compatibilité OpenAI et d'autres instructionsCodex doit pouvoir envoyer des requêtes à l'interface compatible
Le modèle peut être utilisé dans des scénarios CodexLe nom du modèle disponible est visible dans la liste des modèles du tableau de bordNe mettez pas de noms de modèles Claude/Gemini dans Codex
Le statut de la clé (Key) est normalLe token du tableau de bord n'est pas expiré, n'est pas désactivé et le solde est suffisantLa plupart des erreurs 401 nécessitent de vérifier d'abord la clé

Comment renseigner les champs

ParamètreMéthode de saisieAttention pour les débutants
Provider NameIndiquez le nom du fournisseur ou son utilisationPar exemple, « Fournisseur compatible OpenAI principal »
Target Tool / PresetSélectionnez Codex ou les préréglages associés à OpenAI/CodexNe sélectionnez pas Claude Code ou Gemini
Base URLCopiez le lien de l'API fourni par le tableau de bord du fournisseurIl s'agit généralement de l'adresse API fournie par le fournisseur ; pour savoir s'il faut inclure /v1, suivez l'exemple du tableau de bord
API KeyCopiez la clé complèteN'ajoutez pas d'espaces supplémentaires avant ou après, ne copiez pas le nom de remarque
Model NameCopiez exactement le nom depuis la liste des modèles du tableau de bordSi la récupération de la liste des modèles échoue, ajoutez-le manuellement en copiant fidèlement le nom du tableau de bord

Appliquer à Codex

  1. Ouvrez CC Switch et rendez-vous dans la section de gestion des fournisseurs (Provider).
  2. Ajoutez un nouveau fournisseur ou sélectionnez un fournisseur compatible OpenAI existant.
  3. Sélectionnez Codex ou les préréglages liés à OpenAI/Codex comme outil cible.
  4. Renseignez la Base URL, l'API Key et le nom du modèle, puis enregistrez.
  5. Exécutez Apply / Switch pour appliquer ce fournisseur à Codex.
  6. Fermez la fenêtre du terminal actuelle, rouvrez-la, puis effectuez un nouveau test.

Tester le fonctionnement

Testez d'abord la requête avec la question la plus courte possible pour voir si elle aboutit. Une fois le test réussi, vous pouvez l'utiliser dans votre projet réel.

Test minimal Codex
codex "Please reply only: CC-Switch Codex is active"
Si le modèle renvoyé n'existe pas, vérifiez d'abord le nom du modèle ; si l'accès n'est pas autorisé (unauthorized), vérifiez d'abord la clé ; si la connexion expire (timeout), vérifiez d'abord la Base URL et votre réseau.