# Guide de configuration Codex CLI

> Connectez Codex CLI à la passerelle LLMoxy via ~/.codex/config.toml avec un fournisseur de modèle personnalisé, en utilisant Grok 4.7 et d'autres modèles pour la programmation en terminal.

> **📌 À 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](https://github.com/openai/codex)). 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 Grok 4.7 et d'autres modèles.

## Étapes d'installation

### 1. Installer Node.js

Visitez le [site officiel Node.js](https://nodejs.org/). 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 :

```bash
npm install -g @openai/codex
```

Les utilisateurs macOS peuvent également utiliser Homebrew :

```bash
brew install codex
```

Vérifier l'installation :

```bash
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](https://llmoxy.com/) → 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) :

```toml
# Par défaut, utilisez le fournisseur et le modèle LLMoxy
model = "grok-4.7"
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, `grok-4.7`)
- `model_provider` — Pointe vers l'ID du fournisseur défini ci-dessous
- `base_url` — Adresse de la passerelle LLMoxy, **avec** `/v1`
- `wire_api` — Renseignez `responses` pour utiliser `/v1/responses`. Codex n'accepte que cette valeur ; `chat` provoque une erreur
- `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) :**

```powershell
[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 :**

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

Vérifier :

```bash
echo "$LLMOXY_API_KEY"
```

Vous **devez** remplacer `Votre clé API LLMoxy` par la vraie clé copiée depuis la [Console LLMoxy](https://llmoxy.com/).

### 4. Lancer

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

```bash
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` :

```bash
codex -m grok-4.7
```

### 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 :

```bash
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 :

```bash
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 :

```bash
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 :

```bash
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 :

```toml
[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 :

```bash
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
- Vérifiez que `wire_api = "responses"` : Codex ne prend plus en charge `chat`, et le `wire_api = "chat"` des anciens guides provoque une erreur

### 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](https://llmoxy.com/) 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`

Ceci est la version markdown de https://fr.llmoxy.com/docs/code-tutorials/codex-cli.
