Vai al contenuto principale
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).

Setup semplice

Un solo file di configurazione nel tuo progetto

Compatibile con OpenAI

Usa l’API compatibile con OpenAI di Venice

Flessibilità sui modelli

Sostituisci con qualsiasi modello di testo Venice supportato

​
Prerequisiti

​
Configurazione

1

Crea il percorso di configurazione del progetto

Dalla root del tuo progetto:
mkdir -p .codex
2

Crea .codex/config.toml

Crea il file e incolla la configurazione qui sotto:
#: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"
3

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.
4

Esegui Codex CLI normalmente

Avvia Codex CLI dallo stesso progetto. Caricherà .codex/config.toml (per i progetti fidati) e instraderà le richieste tramite Venice.

​
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

Riferimento API Venice

Documentazione completa di endpoint e parametri

Modelli di testo Venice

ID dei modelli disponibili