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

# Codex CLI

> Usa OpenAI Codex CLI con i modelli Venice AI tramite un file config.toml locale

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={"dark"}
    mkdir -p .codex
    ```
  </Step>

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

    ```toml theme={"dark"}
    #: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>