Configuration Codex

1. Présentation d’OpenAI Codex CLI et prérequis système

OpenAI Codex CLI est un agent de codage local fourni par OpenAI. Il peut comprendre un dépôt, modifier du code et exécuter des commandes dans le terminal. Il peut aussi être utilisé avec des éditeurs comme VS Code, Cursor ou Windsurf.

Avant de commencer, préparez l’environnement suivant :

• Un terminal fonctionnel
• Node.js 16 ou une version ultérieure
• Une clé API créée dans la console RouteAPI
• Un modèle au protocole OpenAI disponible dans la console RouteAPI

À propos du protocole

Codex utilise actuellement le protocole Responses compatible OpenAI. Pour se connecter à RouteAPI, utilisez https://www.routeapi.ai/v1 et choisissez dans la console un modèle compatible avec le protocole OpenAI.

2. Installer OpenAI Codex CLI

Installation globale

npm install -g @openai/codex

Si vous utilisez Homebrew, vous pouvez aussi l’installer ainsi :

brew install --cask codex

Vérifier l’installation

codex --version

Si un numéro de version s’affiche, l’installation a réussi.

3. Configurer RouteAPI

Le fichier de configuration utilisateur de Codex est par défaut ~/.codex/config.toml. Sous Windows, il correspond généralement à %USERPROFILE%\.codex\config.toml.

3.1 Configurer la variable d’environnement de clé API

Si vous utilisez bash, zsh ou sh sous macOS / Linux / WSL :

export ROUTEAPI_KEY="votre clé RouteAPI"

Si vous utilisez Windows PowerShell :

$env:ROUTEAPI_KEY="votre clé RouteAPI"

3.2 Écrire config.toml

model = "votre nom de modèle"
model_provider = "routeapi"

[model_providers.routeapi]
name = "RouteAPI"
base_url = "https://www.routeapi.ai/v1"
env_key = "ROUTEAPI_KEY"
wire_api = "responses"

Dans cette configuration :

• model : renseignez le nom d’un modèle au protocole OpenAI disponible dans la console RouteAPI.
• model_provider : indique que la session actuelle utilise le provider personnalisé routeapi.
• base_url : renseignez toujours https://www.routeapi.ai/v1.
• env_key : indique que Codex lit la clé depuis la variable d’environnement ROUTEAPI_KEY.

Recommandation d'intégration

L’intégration via un provider personnalisé est plus directe et convient mieux à une maintenance d’équipe unifiée. Codex lit alors directement le ROUTEAPI_KEY configuré, sans passer par le flux de connexion du compte OpenAI.

3.3 Lancer Codex

codex

Si vous souhaitez un comportement par défaut plus prudent, vous pouvez aussi ajouter ces deux options dans config.toml :

approval_policy = "on-request"
sandbox_mode = "workspace-write"

4. Configuration de l’intégration IDE

Une fois le config.toml ci-dessus terminé, l’extension IDE de Codex peut généralement réutiliser la même configuration. Il n’est donc pas nécessaire de saisir à nouveau l’adresse RouteAPI et la clé dans l’éditeur.

VS Code / Cursor / Windsurf

1. Installez l’extension IDE officielle Codex.
2. Redémarrez l’éditeur.
3. Ouvrez le projet et lancez Codex.
4. Si l’extension ne lit pas immédiatement la nouvelle configuration, rouvrez l’espace de travail ou redémarrez l’éditeur.

JetBrains IDE

Si vous utilisez Codex dans IntelliJ IDEA, PyCharm, WebStorm, GoLand ou un autre IDE JetBrains, il est recommandé de terminer d’abord la configuration CLI ci-dessus, puis de suivre l’assistant Codex de l’IDE. Le terminal et l’IDE utiliseront ainsi la même configuration RouteAPI, sans devoir la saisir de nouveau lorsque vous changez d’outil.