Skip to main content
Codex CLI et Codex App se connectent à BetterToken via OpenAI Responses. Le fichier de configuration est ~/.codex/config.toml et l’API Key est fournie par BETTERTOKEN_API_KEY.

Paramètres principaux

Prérequis

Installation

Configuration par la ligne de commande

Le script de configuration automatique BetterToken écrit la configuration du fournisseur Codex. Il nécessite Node.js et demande l’API Key ou le Model ID s’ils ne sont pas transmis en arguments.
Une fois le script terminé, ouvrez ~/.codex/config.toml (ou %USERPROFILE%\.codex\config.toml sous Windows), vérifiez que model, review_model et le fournisseur BetterToken sont correctement définis, puis redémarrez complètement Codex.

Configuration manuelle

GPT, Kimi et GLM utilisent la même structure config.toml. Remplacez uniquement YOUR_MODEL_ID par un Model ID actuel du fournisseur sélectionné. La configuration en un clic par la ligne de commande est actuellement disponible uniquement pour GPT.

Définir l’API Key

Ajoutez cette ligne à ~/.zshrc ou ~/.bashrc pour conserver la variable.
Ne placez pas de BetterToken API Key dans ~/.codex/auth.json. Ce fichier est réservé à la connexion officielle de Codex ; un fournisseur personnalisé doit lire la variable d’environnement via env_key.

Configurer config.toml

Modifiez ~/.codex/config.toml :
model_provider = "custom" doit correspondre à la table [model_providers.custom]. Remplacez les deux valeurs YOUR_MODEL_ID par un Model ID complet et actuel.

Vérifier la connexion

Ouvrez un nouveau terminal et exécutez :
Envoyez une courte tâche. Une réponse en Streaming sans demande de connexion, erreur 401 ni erreur de modèle confirme la configuration.

Changer de modèle

Modifiez model et, si nécessaire, review_model. Enregistrez le fichier, arrêtez le processus Codex en cours et relancez-le. Utilisez le Model ID de la boîte de dialogue Setup ou du model plaza.

Erreurs fréquentes

Configuration avancée

Fournisseurs compatibles

Les états concernent la méthode de configuration de BetterToken décrite sur cette page.
  • Configuration en ligne de commande et manuelle : utilisez une commande générée ou suivez toutes les étapes manuelles.
  • Configuration manuelle : saisissez l’API Key, la Base URL et le Model.
  • Non compatible : aucune méthode de connexion directe vérifiée n’est disponible pour le moment.

Extension Codex

L’extension Codex pour VS Code partage le fichier config.toml, mais la conservation de la connexion officielle nécessite une autre configuration d’authentification. Consultez le guide de configuration de l’extension Codex.
La configuration CLI/App et celle de l’extension avec connexion officielle sont deux options distinctes. Ne collez pas deux tables [model_providers.custom] dans le même fichier TOML.

Questions associées

Référence officielle

Détails techniques

Codex utilise OpenAI Responses. Définissez base_url sur https://www.bettertoken.ai/v1 et conservez wire_api = "responses". Codex ajoute /responses.