Réponse courte
model_provider indique à Codex CLI quel fournisseur utiliser. Sa valeur doit correspondre à un ID de fournisseur défini sous [model_providers.<id>].
base_url est le point de terminaison API vers lequel les requêtes de modèles sont envoyées. Pour un fournisseur compatible OpenAI, il pointe généralement vers un point de terminaison de type /v1.
wire_api indique à Codex quel format de protocole utiliser pour communiquer avec ce fournisseur. Dans la référence de configuration Codex, responses est une valeur de protocole de fournisseur prise en charge.
Quand cela importe
- Vous configurez un fournisseur personnalisé compatible OpenAI
- Codex indique que le fournisseur est introuvable ou que les requêtes de modèles échouent
- Vous ne savez pas en quoi
model_provider diffère de model
- Vous placez BetterToken, OpenAI ou un autre fournisseur dans un même fichier
config.toml
- Vous devez distinguer Base URL, API Key et Model ID
Relations entre les champs
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.
Modèle recommandé
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.
Redémarrez et vérifiez
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.
Dépannage
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.
Documentation associée
Références
