> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> Pointez la CLI OpenAI Codex vers les modèles Venice avec un fichier config.toml local pour que les requêtes d'agent de codage passent par l'API privée et compatible OpenAI de Venice.

Ce guide montre comment exécuter OpenAI Codex CLI avec Venice en utilisant les chemins de configuration officiels de Codex : `~/.codex/config.toml` (niveau utilisateur) ou `.codex/config.toml` (niveau projet).

<CardGroup cols={3}>
  <Card title="Configuration simple" icon="gear">
    Un fichier de configuration dans votre projet
  </Card>

  <Card title="Compatible OpenAI" icon="plug">
    Utilise l'API compatible OpenAI de Venice
  </Card>

  <Card title="Flexibilité des modèles" icon="microchip">
    Permutez avec n'importe quel modèle de texte Venice pris en charge
  </Card>
</CardGroup>

***

## Prérequis

* Une clé API Venice depuis [venice.ai/settings/api](https://venice.ai/settings/api)
* Codex CLI installé et fonctionnel sur votre machine

***

## Configuration

<Steps>
  <Step title="Créez le chemin de configuration du projet">
    Depuis la racine de votre projet :

    ```bash theme={null}
    mkdir -p .codex
    ```
  </Step>

  <Step title="Créez .codex/config.toml">
    Créez le fichier et collez la configuration ci-dessous :

    ```toml theme={null}
    #:schema https://developers.openai.com/codex/config-schema.json

    model = "openai-gpt-54" # use any Venice model
    model_provider = "venice"
    model_reasoning_effort = "high"
    personality = "pragmatic"
    sandbox_mode = "workspace-write"

    [model_providers.venice]
    name = "Venice"
    base_url = "https://api.venice.ai/api/v1/"
    experimental_bearer_token = "YOUR VENICE API KEY"
    wire_api = "responses"
    ```
  </Step>

  <Step title="Remplacez les deux placeholders">
    Mettez à jour :

    * `model` avec l'ID du modèle Venice que vous souhaitez utiliser
    * `experimental_bearer_token` avec votre véritable clé API Venice

    Vous pouvez parcourir les ID de modèles disponibles dans le [catalogue de modèles de texte](/models/text).
  </Step>

  <Step title="Exécutez Codex CLI normalement">
    Démarrez Codex CLI depuis le même projet. Il chargera `.codex/config.toml` (pour les projets de confiance) et routera les requêtes via Venice.
  </Step>
</Steps>

***

## Emplacements de configuration officiels de Codex

* **Valeurs par défaut utilisateur** : `~/.codex/config.toml`
* **Surcharges projet** : `.codex/config.toml` (chargé uniquement pour les projets de confiance)

Si vous voulez que les paramètres Venice s'appliquent partout, placez la même configuration dans `~/.codex/config.toml`.

***

## Précédence de configuration (la plus élevée en premier)

1. Flags CLI et surcharges `--config`
2. Valeurs de profil (`--profile <name>`)
3. Couches de configuration projet (`.codex/config.toml`, le répertoire le plus proche gagne)
4. Configuration utilisateur (`~/.codex/config.toml`)
5. Configuration système (`/etc/codex/config.toml`, Unix)
6. Valeurs par défaut intégrées

***

## Notes

* Gardez votre clé API privée et ne commitez jamais de vraies clés dans git.
* Codex ignore la configuration `.codex/` du projet lorsqu'un projet est marqué comme non fiable.
* Si vous changez de modèle, mettez à jour uniquement le champ `model`.
* Le paramètre `wire_api = "responses"` est requis pour cette configuration de fournisseur.

***

## Ressources

<CardGroup cols={2}>
  <Card title="Référence API Venice" icon="book" href="/api-reference/api-spec">
    Documentation complète des endpoints et paramètres
  </Card>

  <Card title="Modèles de texte Venice" icon="list" href="/models/text">
    ID de modèles disponibles
  </Card>
</CardGroup>