Codex CLI

Codex accepte des fournisseurs personnalisés dans son fichier de configuration. Tu y déclares Kloria une fois, puis Codex l’utilise par défaut.

Note

Codex parle le format Responses d’OpenAI (/v1/responses). Utilise-le avec les modèles GPT de Kloria.

Configuration

1. Installe Codex

   macOS / Linux

   npm install -g @openai/codex

   Sur macOS, brew install --cask codex fonctionne aussi.

   Windows (PowerShell)

   npm install -g @openai/codex

   Il faut Node.js et npm installés.

2. Mets ta clé dans une variable d’environnement

   Codex lit la clé dans la variable que tu indiques dans sa configuration. On utilise KLORIA_API_KEY.

   macOS / Linux

   Ajoute cette ligne à ton ~/.zshrc ou ~/.bashrc, puis ouvre un nouveau terminal :

   export KLORIA_API_KEY="sk-…"

   Windows (PowerShell)

   [Environment]::SetEnvironmentVariable("KLORIA_API_KEY", "sk-…", "User")

   Ouvre ensuite un nouveau terminal pour que la variable soit visible.

3. Déclare Kloria dans la configuration de Codex

   Ouvre (ou crée) le fichier de configuration utilisateur :

   • macOS / Linux : ~/.codex/config.toml
   • Windows : %USERPROFILE%\.codex\config.toml

   ~/.codex/config.toml

   model = "gpt-6.1-sol"
   model_provider = "kloria"
   
   [model_providers.kloria]
   name = "Kloria"
   base_url = "https://api.kloria.dev/v1"
   env_key = "KLORIA_API_KEY"
   wire_api = "responses"

   Les deux premières lignes doivent rester au début du fichier, avant toute section entre crochets.

4. Lance Codex

   codex

   Envoie un message court. Si Codex répond, la connexion passe par Kloria : la requête apparaît dans Journaux d’utilisation de la console.

Changer de modèle

• Au lancement : codex --model gpt-5.6-terra.
• En permanence : modifie la ligne model du fichier de configuration.

Les identifiants GPT disponibles sont sur la page Modèles et tarifs.

Attention

La configuration de fournisseur se met dans le fichier utilisateur ~/.codex/config.toml. Codex ignore model_provider et model_providers dans le .codex/config.toml d’un projet.

Ça ne marche pas ?

Symptôme	Piste
Codex demande de te connecter à ChatGPT	model_provider = "kloria" n’est pas lu : la ligne est sous une section […] ou dans un fichier de projet. Remonte-la en tête du fichier utilisateur.
Codex signale que KLORIA_API_KEY est absente	La variable n’est pas définie dans le terminal où tu lances Codex. Ouvre un nouveau terminal après l’avoir enregistrée.
wire_api = "chat" is no longer supported	Une ancienne configuration traîne. Remplace par wire_api = "responses".
Erreur 401	Clé invalide, désactivée ou expirée.
« No available channel for model… »	Identifiant de modèle inexact, ou modèle Claude utilisé avec Codex. Prends un modèle GPT de la liste.