Codex CLI

Configurer un fournisseur Responses et une clé API de shell pour Codex CLI.

Installation et préparation

  1. Installez Node.js puis la CLI officielle Codex avec la commande ci-dessous. Exécutez codex --version dans un nouveau terminal.
  2. Créez une clé sous routerra.ai → Clés API. Choisissez dans les modèles un ID exact compatible avec l’API Responses et les outils ; un modèle limité à Chat Completions ne convient pas.
npm install -g @openai/codex
codex --version

Définir le fournisseur TOML

  1. Modifiez ~/.codex/config.toml (Windows : %USERPROFILE%\.codex\config.toml) et fusionnez le TOML sans dupliquer une table de fournisseur. model_provider doit correspondre à routerra ; env_key contient le nom de la variable, pas le secret. Remplacez YOUR_MODEL_ID.
  2. Définissez ROUTERRA_API_KEY dans le shell qui lance codex. La variable ne dure que pour ce shell ; conservez-la dans son profil si nécessaire. Ce fournisseur utilise sa propre clé plutôt qu’une connexion ChatGPT. Redémarrez Codex après modification du TOML.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

Lancer avec la clé du fournisseur

Une variable absente signifie que Codex n’a pas hérité de ROUTERRA_API_KEY ; lancez-le depuis ce terminal. Un 404 sur /responses impose de vérifier URL et protocole : un seul /v1 et wire_api = "responses". Si le texte fonctionne mais pas une liste de fichiers, choisissez un modèle avec outils. Vérifiez la requête dans l’usage routerra.ai ; le démarrage seul ne valide pas le routage.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Pour Windows PowerShell :

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex