# Codex CLI

Source: https://docs.aicentos.com/fr/clients/codex-cli

Language: fr

> Utiliser aicentos dans Codex CLI : configurer manuellement model_providers dans config.toml

Codex CLI est l'agent de codage en ligne de commande officiel d'OpenAI ; il définit les fournisseurs de modèles dans `~/.codex/config.toml`. Pointez un provider personnalisé vers aicentos et les modèles intégrés par aicentos deviennent utilisables dans le terminal.

Si vous préférez gérer plusieurs configurations en mode graphique, passez plutôt par [CC Switch](https://docs.aicentos.com/fr/clients/cc-switch) pour basculer en un clic ; cet article ne traite que la configuration manuelle.

## Prérequis

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Codex CLI (nommez-la par exemple `codex-cli`, pour suivre plus facilement sa consommation) :

* Console : [https://aicentos.com](https://aicentos.com)
* Créer une clé : [https://aicentos.com/keys](https://aicentos.com/keys)
* Recharger en cas de solde insuffisant : [https://aicentos.com/wallet](https://aicentos.com/wallet)

Vérifiez que Codex CLI est installé :

```bash
codex --version
```

## Configuration à renseigner

| Champ                                  | Valeur                                                              |
| -------------------------------------- | ------------------------------------------------------------------- |
| Provider ID                            | `aicentos`                                                          |
| Nom du provider                        | `aicentos`                                                          |
| Variable d'environnement de la clé API | `AICENTOS_API_KEY`                                                  |
| Base URL                               | `https://aicentos.com/v1`                                           |
| Modèle                                 | nom du modèle dans la « place de marché des modèles » de la console |

## Étapes de configuration

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

```bash
export AICENTOS_API_KEY="sk-votre-clé-API"
```

Pour un effet permanent, écrivez-la dans `~/.zshrc` ou `~/.bashrc`, faites un `source`, puis vérifiez avec `echo $AICENTOS_API_KEY`.

### 2. Éditer config.toml

Ajoutez dans `~/.codex/config.toml` :

```toml
model = "votre-nom-de-modèle"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"
```

Remplacez `votre-nom-de-modèle` par le nom d'un modèle listé dans la « place de marché des modèles » de la console, voir [Modèles pris en charge](https://docs.aicentos.com/fr/billing/models-list).

### 3. Lancer Codex

```bash
codex
```

Envoyez une requête simple pour vérifier que le provider fonctionne.

## Test

```
codex exec "Réponds en une phrase : combien font 1+1 ?"
```

Si du contenu est renvoyé normalement, la connexion fonctionne ; la réponse consomme un peu de crédit, que vous pouvez vérifier dans les journaux d'usage de la console.

## Remarques

* **La Base URL s'arrête à `/v1`**, ne la complétez pas en chemin complet `/v1/chat/completions`.
* Les champs `base_url`, `env_key`, etc. ne prennent effet que dans le `~/.codex/config.toml` utilisateur. Un `.codex/config.toml` écrit dans un projet est ignoré, et un avertissement peut apparaître au démarrage.
* `wire_api` prend la valeur `responses`, qui correspond à l'[interface Responses](https://docs.aicentos.com/fr/api/chat/openai/responses) d'aicentos. La documentation officielle ne prend en charge que cette valeur à ce jour ; si votre version signale `unknown variant`, la CLI est trop ancienne, mettez-la à jour d'abord.
* `openai`, `ollama` et `lmstudio` sont des identifiants de provider réservés : il est **impossible** de redéfinir le `base_url` du `openai` intégré pour pointer vers une passerelle tierce ; il faut créer un nouveau nom de provider (cet article utilise `aicentos`).
* Ordre de dépannage : le nom du modèle correspond-il à la console → la Base URL s'arrête-t-elle à `/v1` → la variable d'environnement est-elle visible dans **le terminal qui lance codex** → le solde du compte est-il suffisant ?

## Liens utiles

* [Intégrer Codex (méthode CC Switch)](https://docs.aicentos.com/fr/clients/codex)