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

> Punta OpenAI Codex CLI ai modelli Venice tramite un config.toml locale, così le richieste dell'agente di coding passano dall'API privata di Venice compatibile con OpenAI.

Questa guida mostra come eseguire OpenAI Codex CLI con Venice usando i percorsi di configurazione ufficiali di Codex: `~/.codex/config.toml` (a livello utente) o `.codex/config.toml` (a livello di progetto).

<CardGroup cols={3}>
  <Card title="Setup semplice" icon="gear">
    Un solo file di configurazione nel tuo progetto
  </Card>

  <Card title="Compatibile con OpenAI" icon="plug">
    Usa l'API compatibile con OpenAI di Venice
  </Card>

  <Card title="Flessibilità sui modelli" icon="microchip">
    Sostituisci con qualsiasi modello di testo Venice supportato
  </Card>
</CardGroup>

***

## Prerequisiti

* Una API key Venice da [venice.ai/settings/api](https://venice.ai/settings/api)
* Codex CLI installato e funzionante sulla tua macchina

***

## Configurazione

<Steps>
  <Step title="Crea il percorso di configurazione del progetto">
    Dalla root del tuo progetto:

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

  <Step title="Crea .codex/config.toml">
    Crea il file e incolla la configurazione qui sotto:

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

    model = "openai-gpt-54" # usa qualsiasi modello Venice
    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="Sostituisci i due segnaposto">
    Aggiorna:

    * `model` con l'ID del modello Venice che vuoi usare
    * `experimental_bearer_token` con la tua vera API key Venice

    Puoi sfogliare gli ID dei modelli disponibili nel [catalogo dei modelli di testo](/models/text).
  </Step>

  <Step title="Esegui Codex CLI normalmente">
    Avvia Codex CLI dallo stesso progetto. Caricherà `.codex/config.toml` (per i progetti fidati) e instraderà le richieste tramite Venice.
  </Step>
</Steps>

***

## Percorsi di configurazione ufficiali di Codex

* **Default utente**: `~/.codex/config.toml`
* **Override del progetto**: `.codex/config.toml` (caricato solo per progetti fidati)

Se vuoi che le impostazioni di Venice si applichino ovunque, metti la stessa configurazione in `~/.codex/config.toml`.

***

## Precedenza di configurazione (dalla più alta)

1. Flag CLI e override `--config`
2. Valori dei profile (`--profile <name>`)
3. Layer di configurazione del progetto (`.codex/config.toml`, vince la directory più vicina)
4. Configurazione utente (`~/.codex/config.toml`)
5. Configurazione di sistema (`/etc/codex/config.toml`, Unix)
6. Default integrati

***

## Note

* Mantieni la tua API key privata e non committare mai chiavi reali in git.
* Codex ignora la configurazione `.codex/` del progetto quando un progetto è contrassegnato come non fidato.
* Se cambi modello, aggiorna solo il campo `model`.
* L'impostazione `wire_api = "responses"` è richiesta per questa configurazione del provider.

***

## Risorse

<CardGroup cols={2}>
  <Card title="Riferimento API Venice" icon="book" href="/api-reference/api-spec">
    Documentazione completa di endpoint e parametri
  </Card>

  <Card title="Modelli di testo Venice" icon="list" href="/models/text">
    ID dei modelli disponibili
  </Card>
</CardGroup>