OpenAI Codex CLI

L'agente di coding da terminale ufficiale di OpenAI. Poiché parla l'API OpenAI standard, le stesse due variabili d'ambiente sbloccano ogni strumento OpenAI-compatibile dell'ecosistema — una volta che Codex funziona, funzionano anche Aider / Continue / LangChain / la CLI openai pura.

Prima di iniziare

Crea una chiave API in Console → Chiavi API. Copiala subito — viene mostrata una sola volta.

Passo 1 — Imposta le variabili d'ambiente

# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..."   # your Synthorai key

⚠

L'URL di base compatibile OpenAI deve terminare con /v1. A differenza dell'SDK Anthropic, l'SDK OpenAI non lo aggiunge automaticamente. Un errore comune è incollare https://synthorai.io; le richieste finiranno così su /chat/completions (404) invece di /v1/chat/completions.

Passo 2 — Invia la tua prima richiesta

# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py

# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"

La stessa configurazione funziona per la openai CLI, gli SDK Python/Node, Aider e qualsiasi altro strumento OpenAI-compatibile — leggono tutti OPENAI_BASE_URL e OPENAI_API_KEY.

Modelli consigliati

Parametro	Tipo	Descrizione
`gpt-5.3-codex`	`coding`	Ottimizzato per la generazione di codice. Scelta predefinita per Codex CLI.
`gpt-5.4`	`reasoning`	Reasoning flagship. Da usare per refactoring a livello di architettura.
`gpt-5.4-mini`	`fast`	Veloce, economico e comunque molto capace. Buon default per attività brevi.
`gpt-5.4-nano`	`cheapest`	L'opzione OpenAI più economica. Da usare per piccole modifiche e classificazione.

Risoluzione dei problemi

"404 Not Found" su /chat/completions — al tuo OPENAI_BASE_URL manca il suffisso /v1 . Correzione: export OPENAI_BASE_URL="https://synthorai.io/v1".

"Continua a chiamare api.openai.com" — le nuove variabili d'ambiente valgono solo per le nuove shell. Apri un nuovo terminale, oppure source il tuo profilo.

"Model not found" — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" per vedere l'elenco esatto disponibile per il tuo workspace.

Override per progetto — se non vuoi queste variabili a livello globale, mettile in un file di progetto .envrc (con direnv) o in una funzione per shell.

Scopri come si confrontano i quattro livelli in termini di prezzo nel model price comparison.