Configuration des Coding Agents

Extension Codex VS Code : API tierce et connexion officielle

Configurez config.toml pour l’extension Codex VS Code avec BetterToken Responses. Conservez la connexion officielle, les plugins et Remote Control.

L’extension Codex VS Code partage ~/.codex/config.toml avec Codex CLI/App. Utilisez cette page si vous devez conserver la connexion officielle, les plugins ou Remote Control.

Paramètres principaux

Champ	Valeur
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

Prérequis

Installez la dernière version de l’extension Codex VS Code
Terminez la connexion officielle dans l’extension ou Codex App
Créez une BetterToken API Key
Copiez un Model ID depuis le model plaza ou la boîte de dialogue Setup de la Key

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Installation

Installez l’extension depuis VS Code Marketplace, puis redémarrez VS Code.

Configuration manuelle

Si vous avez défini un CODEX_HOME personnalisé, modifiez le fichier config.toml de ce répertoire. Sinon, utilisez ~/.codex/config.toml sur macOS / Linux ou %USERPROFILE%\.codex\config.toml sur Windows.

Quittez complètement Codex, puis sauvegardez les fichiers config.toml et auth.json existants. Mettez à jour les paramètres du fournisseur existant sans ajouter une table de fournisseur en double.

Configurer l’extension

Modifiez ~/.codex/config.toml :

model_provider = "bettertoken"
model = "gpt-6-astra"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
supports_websockets = false

Paramètres de configuration

Paramètre	Rôle et emplacement	Valeurs par défaut et exemples
`model_provider`	Racine du fichier utilisateur ; sélectionne l’ID défini ci-dessous.	Par défaut `openai` ; ici `bettertoken`.
`model`	Racine ; Model ID complet de la place des modèles.	Exemple : `gpt-6-astra`, à remplacer au besoin.
`name`	Table du provider ; nom affiché uniquement.	`BetterToken` n’est pas un Model ID.
`base_url`	Table du provider ; Base URL de l’API du modèle.	Utilisez `https://bettertoken.ai/v1` ; Codex ajoute `/responses`.
`wire_api`	Table du provider ; protocole des requêtes.	Seul `responses` est actuellement accepté ; c’est aussi la valeur par défaut.
`requires_openai_auth`	Table du provider ; authentification OpenAI et stockage associé.	Par défaut `false` ; ici `true`. Ce n’est pas un bouton de conservation du fichier de connexion.
`experimental_bearer_token`	Table du provider ; Bearer Key pour les requêtes tierces.	Indiquez votre BetterToken API Key ; le cache de connexion officiel reste intact. Stockage en clair ; OpenAI déconseille ce champ.
`supports_websockets`	Table du provider ; prise en charge de Responses WebSocket.	Par défaut `false` ; cette configuration conserve HTTP/SSE.

Conservez les identifiants du compte officiel ; ne les remplacez pas par du JSON API Key. requires_openai_auth = true utilise l’authentification officielle ; experimental_bearer_token du provider actuel fournit la clé tierce aux requêtes du modèle. Avec le premier activé, Codex ignore env_key ; ne le substituez donc pas directement au Bearer Key. Ne partagez pas de fichier contenant une clé.

Pour une autre configuration des identifiants, consultez les instructions d’OpenAI sur l’authentification par variable d’environnement ou commande. Ces modes d’authentification sont distincts : n’ajoutez pas de table auth au fournisseur en même temps que env_key, experimental_bearer_token ou requires_openai_auth, et ne remplacez pas le mécanisme de cet exemple qui conserve la connexion officielle par env_key.

Couches de configuration et anciennes clés

Ne placez pas modèle ou raisonnement dans [projects."<path>"]. Un modèle propre au projet peut utiliser les clés racine de .codex/config.toml dans un projet approuvé ; provider et authentification restent dans le fichier utilisateur. Les profils actuels utilisent NAME.config.toml sous CODEX_HOME, choisi avec codex --profile NAME, pas les anciennes tables [profiles.NAME] ni le sélecteur racine profile.

Enregistrez le fichier, exécutez Developer: Reload Window dans VS Code, puis rouvrez le panneau Codex.

Vérifier la connexion

Créez une nouvelle session Extension et envoyez une courte tâche. Une réponse de gpt-6-astra alors que les plugins et Remote Control restent disponibles confirme la configuration.

Changer de modèle

Modifiez model et, si nécessaire, review_model, puis exécutez Developer: Reload Window. Utilisez un Model ID de la boîte de dialogue Setup ou du model plaza.

Erreurs courantes

Erreur	Correction
L’extension vous demande de vous reconnecter	Restaurez la connexion officielle et conservez `requires_openai_auth = true`.
`401` ou `403`	Copiez à nouveau `experimental_bearer_token` ; n’écrasez pas `auth.json`.
Table dupliquée	Supprimez l’autre table `[model_providers.bettertoken]` et conservez un seul mode d’authentification.
Model not found	Remplacez `gpt-6-astra` par un Model ID actuel et complet.
Configuration non appliquée	Enregistrez le fichier et exécutez Developer: Reload Window.

Advanced setup

Guides associés

Références officielles

Détails techniques

Protocole Responses

L’extension envoie les requêtes du modèle à https://bettertoken.ai/v1 via OpenAI Responses.