Codex
Configurer Codex pour appeler les modèles via TokenHub.
Codex peut appeler les modèles TokenHub via l’interface OpenAI compatible. 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. |
Dernière mise à jour le