📌 À propos de Codex CLI Codex CLI est l'agent de codage terminal officiel d'OpenAI, écrit en Rust, capable de lire, modifier et exécuter du code localement (open source). Il se connecte à OpenAI par défaut, mais prend en charge le model_provider personnalisé, permettant ainsi une connexion transparente à la passerelle LLMoxy et l'utilisation de GPT-5.4 et d'autres modèles.

Étapes d'installation

1. Installer Node.js

Visitez le site officiel Node.js. Nous recommandons de télécharger la version LTS à gauche, qui est la version à support long terme et plus stable.

2. Installer Codex CLI

Ouvrez une ligne de commande et installez globalement via npm :

npm install -g @openai/codex

Les utilisateurs macOS peuvent également utiliser Homebrew :

brew install codex

Vérifier l'installation :

codex --version

Codex CLI prend en charge macOS, Linux et Windows. Les utilisateurs Windows sont recommandés d'exécuter nativement dans PowerShell, ou d'utiliser WSL2 pour un environnement Linux natif.

Étapes de configuration

Le fichier de configuration de Codex CLI se trouve à ~/.codex/config.toml (Windows : %USERPROFILE%\.codex\config.toml). Se connecter à LLMoxy ne nécessite que deux étapes : enregistrer un fournisseur personnalisé + fournir la clé API.

1. Obtenir la clé API

Allez sur la Console LLMoxy → Gestion des clés API → Copiez la clé secrète.

Remarque : Veuillez utiliser un jeton du groupe auto.

2. Écrire config.toml

Ajoutez ce qui suit à ~/.codex/config.toml (créez s'il n'existe pas) :

# Par défaut, utilisez le fournisseur et le modèle LLMoxy
model = "gpt-5.4"
model_provider = "llmoxy"

[model_providers.llmoxy]
name = "LLMoxy"
base_url = "https://llmoxy.com/v1"
wire_api = "responses"
env_key = "LLMOXY_API_KEY"

Explications des éléments de configuration :

model — Nom du modèle par défaut, remplissez un modèle pris en charge par LLMoxy (par exemple, gpt-5.4, gpt-5.3-codex)
model_provider — Pointe vers l'ID du fournisseur défini ci-dessous
base_url — Adresse de la passerelle LLMoxy, avec /v1
wire_api — Protocole d'interface. LLMoxy prend en charge à la fois /v1/responses (API Responses, mode natif Codex, recommandé) et /v1/chat/completions (Chat Completions). Préférez responses ; en cas de problèmes de compatibilité, changez en chat
env_key — Nom de la variable d'environnement pour stocker la clé API, défini à l'étape suivante

ASTUCE Contrairement à Claude Code, le base_url de Codex CLI doit inclure /v1.

3. Définir la variable d'environnement de la clé API

La variable d'environnement spécifiée par env_key doit être définie avec une vraie clé dans le système.

Windows (PowerShell, permanent) :

[Environment]::SetEnvironmentVariable("LLMOXY_API_KEY","Votre clé API LLMoxy","User")

Après la configuration, fermez PowerShell et ouvrez une nouvelle fenêtre pour qu'elle se charge.

macOS / Linux :

{
echo ''
echo '# LLMoxy'
echo 'export LLMOXY_API_KEY="Votre clé API LLMoxy"'
} >> ~/.zshrc   # Les utilisateurs Bash changent en ~/.bashrc
source ~/.zshrc

Vérifier :

echo "$LLMOXY_API_KEY"

Vous devez remplacer Votre clé API LLMoxy par la vraie clé copiée depuis la Console LLMoxy.

4. Lancer

Entrez dans le répertoire de votre projet et démarrez une session interactive :

codex

Si vous pouvez discuter et exécuter des tâches normalement, vous êtes connecté avec succès à LLMoxy.

Opérations courantes

Changer de modèle et d'intensité de raisonnement

Entrez /model dans la session pour changer de modèle ou ajuster l'intensité de raisonnement. Vous pouvez également spécifier au lancement via -m :

codex -m gpt-5.3-codex

Modes d'approbation

Codex demande une confirmation avant d'éditer des fichiers ou d'exécuter des commandes. Vous pouvez basculer dans la session avec /approvals, ou spécifier au lancement :

codex --ask-for-approval      # Confirmer chaque étape (par défaut, le plus sûr)
codex --full-auto             # Exécution automatique, uniquement dans le répertoire de travail dans un bac à sable à accès réseau limité

💡 Astuce Lors de la première exécution dans un répertoire de projet, Codex demandera si vous faites confiance à ce répertoire.

Exécution scriptée (non interactive)

Utilisez la sous-commande exec pour confier des tâches ponctuelles à Codex, adapté pour être appelé dans des scripts ou CI :

codex exec "Ajouter des tests unitaires pour ParseConfig dans main.go"

Entrée d'image

Vous pouvez joindre des captures d'écran ou des maquettes pour permettre à Codex de comprendre les besoins combinés avec des images :

codex -i screenshot.png "Implémentez la page de connexion selon cette maquette"

Recherche Web

Activez la recherche Web pour obtenir les dernières informations :

codex --search

Connecter des outils MCP

Enregistrez des services MCP dans config.toml via [mcp_servers.*] pour fournir des outils tiers et du contexte à Codex. Cette configuration peut coexister avec la configuration du fournisseur LLMoxy :

[mcp_servers.chrome-devtools]
command = "npx"
args = ["chrome-devtools-mcp@latest"]

Problèmes courants

Erreur de permission `npm install -g`

N'utilisez pas sudo npm install -g. Nous recommandons d'utiliser nvm pour gérer Node.js, ou de modifier le répertoire global npm :

npm config set prefix ~/.npm-global

Puis ajoutez ~/.npm-global/bin au PATH. Les utilisateurs macOS peuvent également installer Node.js via Homebrew (pas besoin de sudo).

Demande toujours de se connecter au compte OpenAI après le lancement

Confirmez que model_provider = "llmoxy" est actif dans config.toml, et que la variable d'environnement LLMOXY_API_KEY est définie. Après avoir configuré un fournisseur personnalisé, Codex utilise l'authentification par clé API et ne nécessite pas de connexion ChatGPT.

Erreur 404 / modèle inexistant

Confirmez que base_url inclut /v1 : https://llmoxy.com/v1
Confirmez que model est rempli avec un nom de modèle pris en charge par LLMoxy
Si wire_api = "responses" génère une erreur, essayez de changer en chat

Variables d'environnement non actives

Windows : SetEnvironmentVariable(...,"User") nécessite de rouvrir le terminal
macOS / Linux : exécutez source ~/.zshrc (ou ~/.bashrc), ou rouvrez le terminal, puis vérifiez avec echo "$LLMOXY_API_KEY"

Échec d'appel API / problème de solde

Vérifiez que la clé API n'a pas d'espaces supplémentaires
Allez sur la Console LLMoxy pour vérifier le solde du compte et le groupe de jetons (recommandé d'utiliser le groupe auto)

Délai de connexion au serveur distant (Linux)

Vérifiez le réseau : curl -I https://llmoxy.com
Si un proxy est nécessaire, configurez la variable d'environnement HTTPS_PROXY

Guide de configuration Codex CLI