Skip to main content
Codex CLI et Codex App partagent config.toml et auth.json pour les tâches locales. Cette configuration utilise une BetterToken API Key via OpenAI Responses.

​
Paramètres principaux

​
Prérequis

​
Installation

​
Localisez les fichiers et sauvegardez-les

Si vous avez défini un CODEX_HOME personnalisé, modifiez config.toml et auth.json dans ce répertoire. Sinon, utilisez ~/.codex sur macOS / Linux ou %USERPROFILE%\.codex sur Windows. CLI et App doivent utiliser le même répertoire. WSL possède son propre répertoire utilisateur. Quittez complètement Codex avant toute modification. Sauvegardez les deux fichiers dans un emplacement privé. Créez les fichiers manquants. Remplacez les paramètres existants sans dupliquer les clés ni les tables ; conservez les autres paramètres.
Cette configuration remplace la connexion ChatGPT par l’authentification avec une API Key. Elle ne conserve pas l’accès au compte officiel. Protégez auth.json et ses sauvegardes ; ne les partagez pas et ne les ajoutez pas au dépôt.

​
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.
Après l’installation, comparez les deux fichiers à la configuration manuelle ci-dessous et corrigez les différences avant de lancer Codex.

​
Configuration manuelle

​
Modifiez config.toml

Placez model_provider, model et cli_auth_credentials_store au niveau racine, avant toutes les tables TOML, et non dans un profil. L’ID du fournisseur doit correspondre au nom de sa table. Pour cette authentification par fichiers, retirez env_key et experimental_bearer_token du fournisseur sélectionné.
L’exemple utilise GPT-6 Astra (gpt-6-astra). Pour un autre modèle, copiez son ID complet depuis la model plaza et remplacez model. GPT, Kimi et GLM utilisent la même structure d’authentification par fichiers ; la configuration automatique est disponible pour GPT.

​
Modifiez auth.json

auth.json se trouve dans le même répertoire que config.toml. Si auth.json n’existe pas, créez ce fichier dans ce répertoire. Utilisez le JSON suivant comme contenu du fichier, remplacez YOUR_API_KEY par votre BetterToken API Key, puis enregistrez le fichier.

​
Vérifier la connexion

Enregistrez les deux fichiers. Lancez une nouvelle session Codex CLI directement dans le terminal :
Quittez complètement Codex App, y compris les processus en arrière-plan. Rouvrez l’application et créez une nouvelle tâche locale. Envoyez une courte consigne dans chaque client utilisé. Une réponse normale vérifie la connexion de ce client.

​
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

En cas de 401, 403 ou de demande de connexion, vérifiez le répertoire actif, la Key dans auth.json, auth_mode = apikey, cli_auth_credentials_store = file et requires_openai_auth = true. Pour une erreur de fournisseur ou de modèle, vérifiez l’ID du fournisseur, https://bettertoken.ai/v1, wire_api = responses et la disponibilité du modèle. Si les changements ne s’appliquent pas, vérifiez les paramètres prioritaires et assurez-vous que CLI et App utilisent le même CODEX_HOME.

​
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.

​
Questions associées

​
Référence officielle

​
Détails techniques

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