> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-de47a659.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 une entrée fournisseur dans config.toml, votre VENICE_API_KEY et l'URL de base OpenAI compatible.

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?utm_source=venice-api-documentation)
* 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>