Qu’est-ce que la CLI du Codex ?
Codex CLI est l'agent de codage d'OpenAI permettant de travailler avec des référentiels, de modifier des fichiers, d'exécuter des commandes et d'effectuer des tâches de développement à partir du terminal.
Ce guide explique comment configurer Codex CLI avec un fournisseur d'API personnalisé TokenHub. Il préserve le flux de travail du Codex tout en centralisant les clés API, les modèles compatibles, les journaux de requêtes et l'utilisation des jetons dans TokenHub. Les fournisseurs personnalisés du Codex utilisent l'API OpenAI Responses plutôt que les complétions de chat ordinaires, la sélection du modèle doit donc tenir compte du comportement des réponses, du streaming et des appels d'outils. Validez le fournisseur dans un référentiel hors production, commencez par des tâches d'inspection et d'explication, puis autorisez les modifications ou les commandes shell.
Codex peut acheminer ses requêtes de modèle via la passerelle API OpenAI compatible de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.
L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/responses.
Quand l’utiliser
Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.
Installer ou ouvrir l’outil
Suivez la documentation officielle Codex pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.
Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :
codex --versionPréparer les identifiants TokenHub
Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.
export TOKENHUB_API_KEY="sk-..."Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.
Configurer le fournisseur TokenHub
Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.
Valeurs du provider
| Champ | Valeur |
|---|---|
| Fournisseur | OpenAI Compatible ou Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | La valeur de TOKENHUB_API_KEY |
| Modèle | gpt-4.1 ou un autre model ID TokenHub |
Emplacements des réglages
| Champ | Valeur |
|---|---|
| User config | ~/.codex/config.toml |
| Provider section | model_providers.tokenhub |
| Secret source | env_key = "TOKENHUB_API_KEY" |
model = "gpt-4.1"
model_provider = "tokenhub"
[model_providers.tokenhub]
name = "TokenHub"
base_url = "__API_BASE_URL__/v1"
env_key = "TOKENHUB_API_KEY"
wire_api = "responses"Codex uses the Responses wire API for this provider, so choose a TokenHub model that supports https://us-api.tokenhub.com/v1/responses.
Si votre version installée écrit un schéma légèrement différent, utilisez d’abord la configuration interactive, puis gardez les mêmes valeurs TokenHub : Base URL, API key et model ID.
Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.
Variables temporaires pour le diagnostic
Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.
export TOKENHUB_API_KEY="sk-..."Vérifier la connexion
Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.
Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.
Dépannage
| Symptôme | Correction |
|---|---|
| 401 ou échec d’authentification | Vérifiez que TOKENHUB_API_KEY est valide et enregistré dans le même terminal, IDE ou profil client. |
| 404 ou modèle introuvable | Utilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi. |
| Endpoint incorrect | Gardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement /v1; les outils compatibles Claude non. |
| Timeout | Vérifiez le réseau vers https://us-api.tokenhub.com, les paramètres proxy et l’allowlist de l’espace de travail. |
| L’outil utilise un autre modèle | Revérifiez tous les emplacements chat, edit, apply, fast ou autocomplete. |
Choisir un modèle
FAQ sur l'API personnalisée Codex CLI
Pourquoi l'URL de base du Codex a-t-elle besoin de /v1 ?
Le Codex ajoute le chemin des réponses au fournisseur base_url, le fournisseur TokenHub doit donc utiliser la racine de l'API suivie de /v1.
Puis-je remplacer wire_api par chat_completions ?
Conservez wire_api = "responses" pour le fournisseur personnalisé Codex actuel. Si le modèle ne prend pas en charge les réponses, choisissez un autre modèle plutôt que d'utiliser une valeur de protocole non vérifiée.
Pourquoi le Codex signale-t-il toujours une clé API manquante ?
Vérifiez que env_key dans config.toml correspond exactement à TOKENHUB_API_KEY et démarrez Codex à partir d'un nouveau terminal contenant la variable.
En quoi Codex CLI est-il différent de Claude Code ?
Les deux sont des agents de codage, mais leurs protocoles de fournisseur personnalisé diffèrent : Codex utilise les réponses OpenAI tandis que Claude Code utilise les messages anthropiques. Comparez le flux de travail, la fiabilité des outils, le contexte, la latence et le coût.
Comment l'utilisation du Codex est-elle facturée via TokenHub ?
TokenHub facture l'entrée, la sortie et l'utilisation du cache applicable du modèle sélectionné. Il n'y a pas de prix unique pour le modèle Codex CLI, alors vérifiez la page de détails du modèle actuel avant utilisation.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。