Versions applicables : CC Switch 3.16.0 et ultérieures. Cet article est organisé à partir de la documentation et du code du dépôt, en utilisant DeepSeek comme exemple d'interface compatible OpenAI Chat Completions. Les captures d'écran proviennent de l'interface frontend actuelle, générées à l'aide de données d'exemple anonymisées pour éviter de divulguer de véritables clés API ou soldes de comptes.
Pourquoi un routage local est nécessaire
La nouvelle version de Codex CLI est orientée vers l'API OpenAI Responses, tandis que de nombreux fournisseurs comme DeepSeek, Kimi, MiniMax et SiliconFlow exposent en réalité le format OpenAI Chat Completions, qui est /chat/completions. Les corps de requête, les événements de streaming et les structures de retour de ces deux protocoles sont différents. Remplir directement une interface Chat dans la configuration de Codex entraîne souvent des listes de modèles incorrectes, des erreurs 404/400 ou des réponses en streaming que Codex ne peut pas analyser correctement.
L'approche de CC Switch est de faire en sorte que Codex se connecte toujours à une route locale, tout en envoyant les requêtes via l'API Responses ; la route identifie en interne si le fournisseur actuel est au format Chat, réécrit la requête en Chat Completions pour l'envoyer en amont, et finalement convertit la réponse Chat au format Responses pour la retourner à Codex.
Cette chaîne se divise principalement en quatre étapes :
- Lorsque Codex prend le relais, la configuration locale est écrite comme
http://127.0.0.1:15721/v1, etwire_api = "responses"est forcé. - Le
meta.apiFormat = "openai_chat"du fournisseur indique à la route : le véritable amont est Chat Completions. - La route réécrit
/responsesou/v1/responsesen/chat/completionset convertit le corps de la requête Responses en un corps de requête Chat. - Après le retour en amont, la route reconvertit le JSON ou SSE Chat en JSON/SSE Responses que Codex peut comprendre.
Préparation
Vous devez d'abord préparer trois choses :
- CC Switch installé et prêt à démarrer.
- Codex CLI installé et exécuté au moins une fois pour que la structure de répertoire
~/.codex/config.tomlexiste. - Une clé API pour DeepSeek ou un fournisseur Chat Completions similaire.
La documentation officielle de DeepSeek indique actuellement que l'URL de base compatible OpenAI est https://api.deepseek.com (d'autres fournisseurs utilisent souvent une URL de base avec un suffixe /v1), et le chemin de l'API Chat est /chat/completions ; le préréglage DeepSeek de CC Switch est déjà configuré avec ces informations, veuillez donc privilégier l'utilisation du préréglage plutôt que d'assembler manuellement les chemins d'interface.
Étape 1 : Ajouter un fournisseur Codex
Ouvrez CC Switch, basculez vers l'onglet Codex en haut, et cliquez sur le signe plus dans le coin supérieur droit pour ajouter un fournisseur.
Sélectionnez DeepSeek dans les préréglages intégrés ; vous n'avez que deux choses à faire :
- Saisir la clé API DeepSeek.
- Enregistrer le fournisseur.
Le préréglage inclut déjà l'adresse de requête de DeepSeek, le modèle par défaut, le menu des modèles et les paramètres de réflexion/raisonnement, et activera automatiquement « Nécessite un mappage de routage local ». Vous pouvez ajuster le modèle par défaut ou le nom d'affichage du modèle selon vos besoins ; la conversion de protocole est gérée par la couche de routage.
Étape 2 : Activer le routage local et prendre le relais de Codex
Allez dans la page Routage dans les paramètres, développez Routage local, et effectuez deux basculements :
- Activez l'interrupteur principal de routage pour démarrer le service local. L'adresse par défaut est
127.0.0.1:15721. - Activez Codex dans l'activation de routage. Si vous souhaitez que seul Codex passe par la route, vous pouvez laisser Claude et Gemini désactivés.
Après la prise de relais, CC Switch pointera la configuration en direct de Codex vers la route locale et gérera l'authentification avec des espaces réservés. La véritable clé DeepSeek est toujours enregistrée dans la configuration du fournisseur CC Switch et injectée par la route locale lors du transfert, vous n'avez donc pas besoin d'exposer la clé dans la configuration en direct de Codex.
Étape 3 : Changer de fournisseur et redémarrer Codex
Revenez à la liste des fournisseurs Codex et cliquez sur Activer pour le fournisseur DeepSeek. Si vous voyez une étiquette « Nécessite une route », cela signifie que ce fournisseur doit être utilisé pendant que la route est en cours d'exécution ; si la route n'est pas démarrée, CC Switch affichera une invite indiquant « Le service de routage est nécessaire pour une utilisation normale ».
Après le changement, il est recommandé de redémarrer la session terminal Codex actuelle car :
- Le processus Codex a peut-être déjà lu l'ancien
config.toml. - Après la génération de
modelcatalogjson, le menu/modelnécessite généralement un nouveau processus pour se rafraîchir.
Une fois dans Codex, vous pouvez utiliser /model pour vérifier si le modèle actuel provient du préréglage DeepSeek, comme DeepSeek V4 Flash. Actuellement, l'application Codex ne prend pas en charge la sélection personnalisée de plusieurs modèles et utilisera par défaut le premier modèle dans la configuration.
Comment gérer les autres fournisseurs Chat
Les fournisseurs courants au format Chat comme DeepSeek, Kimi, MiniMax et SiliconFlow ont déjà des préréglages dans CC Switch ; privilégiez leur utilisation. Seuls les fournisseurs qui ne sont pas dans les préréglages nécessitent de choisir une configuration personnalisée ; dans ce cas, remplissez la clé API, l'URL de base et le modèle selon leur documentation, et définissez le format d'API sur OpenAI Chat Completions (nécessite un routage).
Si l'amont prend directement en charge l'API OpenAI Responses, vous n'avez pas besoin d'activer « Nécessite un mappage de routage local » ; dans ce cas, CC Switch peut se connecter directement via Responses sans conversion Chat.
FAQ
Codex signale une erreur 404 ou ne peut pas trouver /responses
Généralement, cela est dû au fait que la prise de relais de Codex n'est pas activée, ou que vous avez écrit manuellement l'URL de base Chat amont directement dans Codex. Vérifiez si ~/.codex/config.toml pointe vers http://127.0.0.1:15721/v1.
L'amont DeepSeek signale une erreur 404
Si vous utilisez le préréglage DeepSeek intégré, confirmez d'abord que le fournisseur actuel provient bien du préréglage et que le routage Codex est activé. Ce n'est que lorsque vous utilisez un fournisseur personnalisé que vous devez revérifier l'URL de base : elle doit être l'adresse racine du service, pas le chemin d'interface complet avec /chat/completions.
/model n'affiche pas les modèles DeepSeek
Redémarrez Codex après avoir enregistré le fournisseur. CC Switch génère cc-switch-model-catalog.json et écrit le chemin dans modelcatalogjson, mais un processus Codex en cours d'exécution peut ne pas recharger à chaud le répertoire des modèles.
Actuellement, l'application Codex ne prend pas en charge la sélection de plusieurs modèles et utilise par défaut le premier modèle.
La route est activée mais les requêtes vont toujours au mauvais fournisseur
Confirmez que trois états sont cohérents : le fournisseur actuel sous l'onglet Codex est DeepSeek ; le service de routage local est en cours d'exécution ; et l'interrupteur Codex dans l'activation de routage est activé.
Puis-je utiliser le compte officiel OpenAI Codex via le routage local ?
Non recommandé. CC Switch empêche de basculer vers des fournisseurs officiels en mode de prise de relais de routage local car utiliser un proxy pour accéder à l'API officielle peut présenter des risques pour le compte. Le routage est principalement destiné aux scénarios de tiers, d'agrégation ou de conversion de protocole.
Liens de référence
- Manuel utilisateur CC Switch : Ajout de fournisseurs
- Manuel utilisateur CC Switch : Service proxy
- Manuel utilisateur CC Switch : Routage d'application
- Documentation API DeepSeek : Votre premier appel API
- Documentation API DeepSeek : Créer une complétion de chat
- Documentation API DeepSeek : Conversation multi-tours
