config.toml de Codex : fournisseur personnalisé, Base URL et API Key

Réponse directe

Pour utiliser un fournisseur personnalisé dans Codex CLI, modifiez le fichier utilisateur ~/.codex/config.toml. Définissez model_provider = "custom", créez [model_providers.custom], utilisez https://www.bettertoken.ai/v1 comme Base URL et définissez wire_api = "responses". Lisez la BetterToken API Key via env_key et copiez le Model ID depuis le fournisseur GPT.

Trouver le bon fichier de configuration

Environnement	Configuration utilisateur
macOS / Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`
Windows + WSL	`~/.codex/config.toml` dans WSL

Dans l’extension Codex pour VS Code, cliquez sur l’icône d’engrenage et choisissez Codex Settings → Open config.toml. Le CLI et l’extension IDE partagent les mêmes couches de configuration.

Les paramètres de fournisseur et d’authentification appartiennent au fichier utilisateur ~/.codex/config.toml. Les fichiers .codex/config.toml du projet peuvent contenir des surcharges de projet, mais Codex y ignore model_provider et model_providers. Placez les instructions du projet dans AGENTS.md.

Configuration minimale fonctionnelle

Définir la variable d’environnement de l’API Key

macOS, Linux ou WSL :

export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

Windows PowerShell :

[Environment]::SetEnvironmentVariable("MODEL_PROVIDER_API_KEY", "YOUR_API_KEY", "User")
$env:MODEL_PROVIDER_API_KEY = "YOUR_API_KEY"

Remplacez YOUR_API_KEY par votre BetterToken API Key. Pour un usage persistant, stockez-la dans un environnement du système d’exploitation protégé, et non dans le dépôt du projet.

Modifier config.toml

model_provider = "custom"
model = "gpt-5.5"

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

model est un exemple. Copiez un Model ID actuellement disponible depuis le fournisseur GPT dans la model plaza.

Redémarrer et tester

Quittez complètement Codex, ouvrez un nouveau terminal et exécutez :

codex

Envoyez une consigne simple. Une réponse normale confirme que le fournisseur, l’authentification et le Model ID sont actifs.

Configuration complète recommandée

Utilisez cette version lorsque vous avez besoin d’un modèle de révision et d’un délai d’inactivité de flux plus long :

model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Fusionnez les champs de niveau supérieur existants et le contenu de [model_providers.custom]. Ne déclarez pas deux fois la même table TOML.

Rôle des champs

Champ	Rôle	Valeur BetterToken
`model_provider`	Sélectionne un ID de fournisseur	`"custom"`
`[model_providers.custom]`	Définit ce fournisseur	Doit correspondre à `model_provider`
`base_url`	Point de terminaison des requêtes de modèle	`https://www.bettertoken.ai/v1`
`env_key`	Nomme la variable d’environnement contenant l’API Key	`MODEL_PROVIDER_API_KEY`
`wire_api`	Protocole du fournisseur	`"responses"`
`requires_openai_auth`	Utilise l’authentification OpenAI officielle	`false` pour une configuration API tierce ordinaire
`model`	Model ID par défaut	Un ID actuel du fournisseur GPT

Pour conserver la connexion officielle de Codex App, les plugins et Remote Control tout en utilisant une API tierce, utilisez la configuration dédiée de connexion officielle et de session unifiée au lieu de cet exemple d’authentification ordinaire.

Erreurs courantes

Symptôme	Cause	Solution
Fournisseur introuvable	`model_provider` ne correspond pas au nom de la table	Utilisez `custom` aux deux endroits
API Key absente au démarrage	La variable d’environnement est absente ou le terminal ne l’a pas rechargée	Définissez `MODEL_PROVIDER_API_KEY` et ouvrez un nouveau terminal
`401` ou `403`	Key erronée ou méthodes d’authentification mélangées	Copiez de nouveau la Key ; conservez le nom `env_key` cohérent et `requires_openai_auth = false`
`404`	La Base URL ne contient pas `/v1` ou utilise le mauvais protocole	Utilisez `https://www.bettertoken.ai/v1`
Modèle introuvable	Le Model ID est indisponible ou n’appartient pas au fournisseur GPT	Copiez un ID actuel depuis la model plaza
Les modifications ne s’appliquent pas	Mauvaise couche de configuration, mauvais chemin ou environnement WSL	Modifiez la configuration utilisateur dans l’environnement qui exécute Codex, puis redémarrez Codex
Erreur d’analyse TOML	Erreur de table dupliquée, de guillemet ou d’imbrication	Supprimez les tables `[model_providers.custom]` dupliquées et vérifiez les guillemets des chaînes

Claude Code

Claude Desktop

Codex

Cursor

Cline

Appels de modèles

Service et sécurité

Coûts et tokens

Concepts

config.toml de Codex : fournisseur personnalisé, Base URL et API Key

Réponse directe

Trouver le bon fichier de configuration

Configuration minimale fonctionnelle

Configuration complète recommandée

Rôle des champs

Erreurs courantes

Documentation associée

Références

​Réponse directe

​Trouver le bon fichier de configuration

​Configuration minimale fonctionnelle

​Configuration complète recommandée

​Rôle des champs

​Erreurs courantes

​Documentation associée

​Références

Réponse directe

Trouver le bon fichier de configuration

Configuration minimale fonctionnelle

Configuration complète recommandée

Rôle des champs

Erreurs courantes

Documentation associée

Références