> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser APIMart dans Codex CLI

> Guide détaillé sur la configuration et l'utilisation des services API APIMart dans Codex CLI, vous permettant d'accéder à plusieurs modèles d'IA pour une programmation assistée avec une configuration simple.

## Introduction

Codex CLI est l'agent de codage en terminal open source d'OpenAI qui peut lire et écrire des fichiers, exécuter des commandes, corriger des bugs et accomplir des tâches de codage complètes directement en ligne de commande.
En vous connectant via APIMart, vous pouvez utiliser librement plusieurs modèles — y compris GPT et Claude — dans Codex CLI, avec une tarification plus flexible et compétitive.

## Prérequis

Avant de commencer, assurez-vous d'avoir :

1. **Node.js installé**
   Téléchargez et installez depuis le [site Node.js](https://nodejs.org/) (LTS la plus récente, v20 ou plus récent recommandée) pour installer Codex CLI via npm

2. **Obtenu une clé API APIMart**
   Connectez-vous à la [console APIMart](https://apimart.ai/keys) pour obtenir votre clé API (commence par `sk-`)

<Note>**Astuce :** si vous n'avez pas encore de compte APIMart, inscrivez-vous d'abord sur [APIMart](https://apimart.ai) et obtenez votre clé API.</Note>

## Étape 1 : Installer Codex CLI

Choisissez l'une des méthodes suivantes pour installer :

<Tabs>
  <Tab title="npm (recommandé)">
    Installer globalement avec npm — fonctionne sur tous les systèmes d'exploitation :

    ```bash theme={null}
    npm install -g @openai/codex
    ```

    <Note>Si vous rencontrez des problèmes de permissions, ajoutez `sudo` (macOS / Linux).</Note>
  </Tab>

  <Tab title="Homebrew (macOS)">
    Les utilisateurs macOS peuvent également installer avec Homebrew :

    ```bash theme={null}
    brew install codex
    ```
  </Tab>
</Tabs>

### Vérifier l'installation

Après l'installation, exécutez la commande suivante pour confirmer :

```bash theme={null}
codex --version
```

Si un numéro de version est affiché, l'installation a réussi.

## Étape 2 : Configurer l'API APIMart

Codex CLI gère les fournisseurs de modèles via les fichiers de configuration sous le répertoire `~/.codex/`. Tout ce que nous devons faire est d'ajouter un fournisseur personnalisé pointant vers APIMart.

### 2.1 Localiser le répertoire de configuration

* **macOS / Linux :** `~/.codex/`
* **Windows :** `C:\Users\<username>\.codex\`

<Note>Si le répertoire n'existe pas, exécutez `codex` une fois dans votre terminal puis appuyez sur `Ctrl + C` pour quitter — il sera créé automatiquement.</Note>

### 2.2 Configurer la clé API

Dans le répertoire de configuration, créez ou modifiez le fichier `auth.json` et renseignez votre clé APIMart :

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

| Champ            | Description                                |
| ---------------- | ------------------------------------------ |
| `OPENAI_API_KEY` | Votre clé API APIMart (commence par `sk-`) |

### 2.3 Configurer le fournisseur de modèle

Dans le répertoire de configuration, créez ou modifiez le fichier `config.toml` et ajoutez le fournisseur APIMart :

```toml theme={null}
# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
```

| Champ                  | Description                                                                              |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| `model`                | ID du modèle par défaut — choisissez-en un dans la liste des modèles ci-dessous          |
| `model_provider`       | Fournisseur par défaut — doit correspondre à l'ID dans `[model_providers.xxx]`           |
| `name`                 | Nom d'affichage du fournisseur — personnalisable                                         |
| `base_url`             | URL compatible OpenAI d'APIMart — fixée à `https://api.apimart.ai/v1`                    |
| `wire_api`             | Protocole de fil — les versions récentes de Codex requièrent `responses` (Responses API) |
| `requires_openai_auth` | Définissez à `true` pour s'authentifier avec la clé d'`auth.json`                        |

Après avoir sauvegardé les deux fichiers, redémarrez Codex CLI pour que les changements prennent effet.

<Warning>Assurez-vous qu'`auth.json` est du JSON valide et `config.toml` du TOML valide. N'utilisez pas de guillemets pleine largeur / intelligents, sinon la configuration ne s'appliquera pas.</Warning>

## Étape 3 : Commencer

### Vérifier la configuration

Dans n'importe quel répertoire de projet, exécutez la commande suivante pour confirmer que tout est branché :

```bash theme={null}
codex "Introduce yourself in one sentence"
```

Si vous obtenez une réponse de l'IA, la configuration fonctionne. Si vous voyez un écran de connexion ou des erreurs `401` / `403`, consultez la section FAQ ci-dessous.

### Mode interactif

Exécutez `codex` directement pour entrer dans l'interface interactive — idéal pour les tâches de codage complètes :

```bash theme={null}
codex
```

Une fois à l'intérieur, décrivez ce dont vous avez besoin en langage naturel, par ex. :

```
Create an Express.js server with a JSON-returning health check endpoint
```

Codex analysera votre projet, générera du code, exécutera des commandes et demandera confirmation avant d'effectuer des opérations sensibles.

### Modes d'approbation

Lors du premier lancement, Codex vous demandera de choisir un niveau d'approbation :

| Mode            | Description                                                                                             |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Read Only**   | Seules les lectures de fichiers sont autorisées — toute modification ou commande nécessite confirmation |
| **Auto**        | Peut lire/écrire des fichiers et exécuter des commandes dans le répertoire de travail (recommandé)      |
| **Full Access** | Effectue toute opération sans confirmation — à utiliser avec prudence                                   |

Nous recommandons de commencer avec le mode **Auto**. Tapez `/approvals` dans l'interface interactive pour le changer à tout moment.

### Changer de modèle

Dans l'interface interactive, tapez `/model` pour changer rapidement, ou modifiez le champ `model` dans `config.toml` et redémarrez.

## Modèles pris en charge

Pour Codex CLI, les modèles de la série GPT-5 suivants sont recommandés :

| ID du modèle    | Points forts                                           | Cas d'utilisation recommandés                 |
| --------------- | ------------------------------------------------------ | --------------------------------------------- |
| `gpt-5.5`       | Dernier modèle phare, meilleure capacité de codage     | Premier choix pour Codex, ingénierie complexe |
| `gpt-5.4`       | Modèle phare de la génération précédente, très capable | Codage complexe, conception d'architecture    |
| `gpt-5.4-mini`  | Léger, rapide, économique                              | Codage quotidien, itération rapide            |
| `gpt-5.3-codex` | Modèle de codage optimisé pour Codex                   | Tâches de codage agentiques                   |
| `gpt-5.2`       | Stable et équilibré                                    | Tâches de codage de routine                   |

<Tip>
  **Conseils de sélection de modèle :** La série GPT-5 ci-dessus s'associe le mieux à Codex CLI. Pour la meilleure expérience, préférez `gpt-5.5` ; `gpt-5.3-codex` est spécifiquement optimisé pour les scénarios de codage agentique de Codex.
</Tip>

## Commandes courantes

Commandes et raccourcis fréquemment utilisés dans Codex CLI :

| Commande                | Description                                    |
| ----------------------- | ---------------------------------------------- |
| `codex`                 | Entrer dans l'interface interactive            |
| `codex "task"`          | Démarrer avec une instruction initiale         |
| `codex exec "task"`     | Mode non interactif — exécuter et sortir       |
| `codex --model gpt-5.4` | Démarrer avec un modèle spécifié               |
| `codex --version`       | Afficher le numéro de version                  |
| `/model`                | Changer de modèle dans l'interface interactive |
| `/approvals`            | Ajuster le mode d'approbation dans l'interface |
| `Ctrl + C`              | Quitter l'interface interactive                |

## FAQ

### Q1 : Un écran de connexion ChatGPT apparaît après le lancement ?

Si vous voyez « Sign in with ChatGPT » ou similaire après le lancement, la configuration n'a pas pris effet.

**Dépannage :**

1. Assurez-vous que `config.toml` et `auth.json` sont tous deux dans `~/.codex/`
2. Vérifiez que `model_provider` dans `config.toml` est défini sur `apimart`
3. Vérifiez qu'`auth.json` est du JSON valide et que la clé est remplie complètement

### Q2 : Erreurs 401 / 403 ?

| Code de statut     | Signification                          | Solution                                                              |
| ------------------ | -------------------------------------- | --------------------------------------------------------------------- |
| `401 Unauthorized` | Clé API manquante ou invalide          | Vérifiez la clé dans `auth.json` — doit commencer par `sk-`           |
| `403 Forbidden`    | Permission insuffisante ou clé expirée | Allez dans la [console](https://apimart.ai/keys) pour vérifier la clé |

Assurez-vous également que `base_url` est défini sur `https://api.apimart.ai/v1`, pas l'URL officielle d'OpenAI.

### Q3 : Connexion échouée ?

1. Vérifiez votre connexion réseau
2. Assurez-vous que `base_url` dans `config.toml` est correct
3. Si vous êtes derrière un proxy, assurez-vous qu'il autorise l'accès à `api.apimart.ai`

### Q4 : `wire_api = "chat"` n'est plus pris en charge ?

Les versions récentes de Codex CLI (0.84.0 et ultérieures) ont supprimé le protocole `chat`. Mettez à jour `wire_api` dans `config.toml` à `responses` :

```toml theme={null}
wire_api = "responses"
```

APIMart prend en charge la Responses API — redémarrez simplement Codex après le changement.

### Q5 : Les appels d'outils ou les exécutions échouent ?

Assurez-vous que `wire_api` dans `config.toml` est défini sur `responses`. Si vous rencontrez toujours des problèmes de compatibilité, passez à un modèle de la série GPT-5 recommandé (par ex. `gpt-5.5`, `gpt-5.3-codex`) — ils s'associent plus fiablement à Codex CLI.

### Q6 : Utiliser des variables d'environnement au lieu d'auth.json ?

Vous pouvez également configurer la clé via une variable d'environnement. Changez le bloc fournisseur dans `config.toml` à :

```toml theme={null}
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
```

Définissez ensuite la variable d'environnement `APIMART_API_KEY` à votre clé APIMart. `auth.json` n'est plus requis dans cette configuration.

### Q7 : Comment changer de modèle ?

Deux façons :

1. **Dans l'interface interactive** : tapez `/model` pour changer
2. **Modifier la configuration** : changez le champ `model` dans `config.toml` et redémarrez Codex CLI

### Q8 : Comment vérifier l'utilisation et la facturation ?

Connectez-vous à la [console APIMart](https://apimart.ai/overview) pour consulter les statistiques d'appels API, les détails de consommation des tokens et les tendances des coûts.

## Support et aide

Si vous rencontrez des problèmes lors de l'utilisation de Codex CLI :

* 📚 [Centre de documentation APIMart](https://docs.apimart.ai)
* 💬 [Communauté Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Support technique : [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Commencer avec APIMart" icon="rocket" href="https://apimart.ai">
  Inscrivez-vous à APIMart maintenant, obtenez votre clé API et découvrez un assistant de programmation multi-modèle dans Codex CLI !
</Card>