Skip to main content
Codex est un agent de programmation lancé par OpenAI. En plus de l’interface CLI terminal, il propose également une extension VS Code, permettant de discuter dans la barre latérale de l’éditeur, lire des fichiers, référencer le contexte, générer des modifications et prévisualiser les changements. Cet article explique comment configurer et utiliser l’extension Codex dans VS Code via l’agent compatible OpenAI Responses d’Ace Data Cloud. L’extension Codex VS Code et le CLI Codex utilisent le même système de configuration local, il suffit donc de pointer ~/.codex/config.toml vers Ace Data Cloud pour que Codex dans VS Code utilise https://api.acedata.cloud/v1.

​
Processus de demande

Pour utiliser Codex, commencez par obtenir votre API Token sur la console Ace Data Cloud, à conserver pour usage ultérieur. Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inscrire et vous connecter, puis vous reviendrez automatiquement à cette page. Un quota gratuit est offert lors de la première inscription, permettant d’essayer gratuitement le service Codex.

​
Installation de l’extension Codex

Dans le marketplace des extensions VS Code, recherchez Codex et installez l’extension Codex - OpenAI’s coding agent publiée par OpenAI. Son ID Marketplace est :
Vous pouvez également l’installer via la ligne de commande :
Après installation, redémarrez ou rechargez VS Code. Si vous ne voyez pas l’entrée Codex, ouvrez la palette de commandes (macOS : Cmd+Shift+P, Windows/Linux : Ctrl+Shift+P), recherchez et exécutez :
Par défaut, Codex apparaît dans la barre latérale droite de VS Code. Vous pouvez aussi le glisser vers la barre d’activités à gauche.

​
Installation du CLI Codex (pour vérification)

La documentation officielle indique que l’extension Codex VS Code et le CLI Codex partagent la même couche de configuration. Pour vérifier la validité de votre API Token et modèle avant de configurer VS Code, il est recommandé d’installer également le CLI Codex. Une méthode recommandée est l’installation via npm, nécessitant Node.js 18 ou supérieur :
Les utilisateurs macOS peuvent aussi installer via Homebrew :
Après installation, vérifiez que la commande est disponible dans le terminal :
Si vous souhaitez uniquement utiliser l’extension VS Code, vous pouvez passer l’étape de vérification CLI ; la configuration ~/.codex/config.toml reste la même.

​
Configuration de l’API Ace Data Cloud

L’extension Codex VS Code et le CLI Codex partagent le fichier de configuration. Par défaut, Codex invite à se connecter avec un compte officiel OpenAI ou à configurer une clé API officielle. Pour utiliser Ace Data Cloud, il faut configurer l’API Token et le fichier ~/.codex/config.toml.

​
Première étape : définir la variable d’environnement

Il est recommandé d’écrire l’API Token dans le fichier de configuration du shell, par exemple ~/.zshrc, ~/.bashrc ou ~/.bash_profile :
Remplacez {token} par l’API Token copié depuis la console Ace Data Cloud. Après configuration, rouvrez le terminal ou exécutez la commande source correspondante pour appliquer immédiatement la configuration :
Si VS Code est déjà ouvert, redémarrez ou rechargez-le pour que l’extension prenne en compte la nouvelle variable d’environnement.

​
Deuxième étape : éditer le fichier de configuration Codex

Le fichier de configuration utilisateur de Codex se trouve à ~/.codex/config.toml. S’il n’existe pas, créez-le :
Écrivez la configuration suivante :
Explications des champs : Vous pouvez aussi ouvrir ce fichier directement depuis VS Code en cliquant sur l’icône d’engrenage en haut à droite de l’extension Codex, puis Codex Settings > Open config.toml.

​
Configuration au niveau du projet

Si vous souhaitez qu’un projet utilise une configuration différente, créez un fichier .codex/config.toml à la racine du projet. Codex chargera prioritairement cette configuration projet, à condition que le projet soit marqué comme trusted. Exemple :
Il est conseillé de stocker les tokens personnels dans les variables d’environnement et non dans le dépôt du projet. La soumission du fichier .codex/config.toml projet dépendra des pratiques de votre équipe.

​
Nettoyer la connexion OpenAI mise en cache

Si vous vous êtes déjà connecté avec un compte OpenAI officiel dans l’extension Codex, un état de connexion peut être conservé localement. Avant de passer à l’agent Ace Data Cloud, exécutez dans le terminal :
Si la commande n’est pas disponible, supprimez manuellement le fichier de cache local :
Puis redémarrez ou rechargez VS Code.

​
Utilisation de base

Une fois la configuration terminée, ouvrez le panneau Codex à gauche ou à droite dans VS Code et saisissez directement votre demande. Par exemple :
L’extension Codex peut utiliser les fichiers ouverts et le code sélectionné dans l’éditeur comme contexte. Vous pouvez aussi référencer un fichier avec @ dans la zone de saisie, par exemple :
Si vous sélectionnez un morceau de code, vous pouvez l’ajouter au fil de discussion via la palette de commandes :
Ou ajouter le fichier entier :

​
Changer de modèle et d’intensité de raisonnement

L’extension Codex VS Code permet de changer de modèle et d’ajuster l’effort de raisonnement via le sélecteur sous la zone de saisie. Avec le fournisseur personnalisé Ace Data Cloud, la méthode la plus fiable est de définir un modèle par défaut dans ~/.codex/config.toml, puis de changer à la volée dans l’interface si besoin. Voici les recommandations par scénario : Si le modèle souhaité n’apparaît pas dans l’interface, modifiez directement le champ model dans ~/.codex/config.toml puis redémarrez ou rechargez VS Code. La liste complète des modèles est disponible dans la documentation OpenAI d’Ace Data Cloud.

​
Choix du mode de travail

L’extension Codex supporte différents modes de travail. Les modes courants sont : L’usage quotidien recommande le mode Agent avec approval_policy = "on-request". Ainsi, Codex demandera confirmation avant d’exécuter des commandes sensibles, d’accéder à des chemins hors de l’espace de travail ou au réseau.

​
Vérification de la configuration

Vous pouvez vérifier dans le terminal si Codex fonctionne via Ace Data Cloud avec cette commande :
Si la configuration est correcte, vous devriez voir une réponse similaire :
Ensuite, dans VS Code, ouvrez le panneau Codex et posez une question simple :
Vous pouvez aussi consulter l’historique des requêtes et les détails de facturation via la console Ace Data Cloud - Historique d’utilisation, et vérifier le quota restant via la console Ace Data Cloud - Liste des applications.

​
Fonctionnement interne

L’extension Codex VS Code ne possède pas une configuration de modèle indépendante. Elle utilise le CLI Codex natif et partage la couche de configuration Codex :
  1. L’extension VS Code lance Codex et lit la configuration utilisateur ~/.codex/config.toml.
  2. Si le projet est trusted et contient un fichier .codex/config.toml, Codex charge aussi la configuration projet.
  3. Quand model_provider est acedatacloud, Codex récupère l’API Token depuis ACEDATACLOUD_API_KEY.
  4. Les requêtes sont envoyées via le protocole OpenAI Responses à https://api.acedata.cloud/v1/responses.
  5. Ace Data Cloud authentifie, vérifie le quota, relaie la requête et enregistre l’utilisation.
Ainsi, la configuration CLI et VS Code est généralement unique. Une fois la vérification terminal réussie, l’extension VS Code utilise la même configuration.

​
Pour en savoir plus