Documentazione

Codex CLI

Codex usa esclusivamente l’API Responses. Un blocco provider in config.toml lo indirizza alla superficie nativa /v1/responses di Kunavo, mentre la chiave viene mantenuta in una variabile d’ambiente anziché nel file.

Un blocco [model_providers.kunavo] in ~/.codex/config.toml con env_key, così la chiave resta nell'ambiente e non finisce mai nel file di configurazione.

~/.codex/config.toml

model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"     # the NAME of the variable, not the key
# wire_api defaults to "responses", which is the only supported value

wire_api ora ammette un solo valore valido: "responses", che viene usato per impostazione predefinita se omesso. Codex ha rimosso il supporto per Chat Completions, quindi qualsiasi guida precedente che suggerisce di impostare wire_api = "chat" non è più aggiornata; inoltre, un endpoint privo di una route /v1/responses effettiva non può essere usato con Codex. Kunavo la implementa nativamente.

env_key contiene il nome di una variabile d’ambiente, non la chiave stessa. È una scelta intenzionale da parte di OpenAI: config.toml è un file che le persone includono nei commit e incollano nelle segnalazioni.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Codex CLI.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Aggiungi il blocco qui sopra a ~/.codex/config.toml, creando il file se non esiste.
Esporta la variabile indicata da env_key: export KUNAVO_API_KEY=sk-kn-...
Esegui codex. Il campo di primo livello model_provider seleziona il blocco; model seleziona l’ID al suo interno.
Per cambiare modello per sessione senza modificare il file, usa codex -m <model id> oppure mantieni più blocchi provider e modifica model_provider.

Verificato rispetto a il riferimento alla configurazione di Codex il 6 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Questa è la versione breve. La guida completa, con scelta del modello, costo di una sessione reale e modalità di errore, è in la guida alle chiavi API di Codex CLI.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Codex CLI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

ID del modello	Kunavo ingresso / uscita	Dove si inserisce in Codex CLI
`gpt-5-6-sol`	$2.00 / $12.00	l’abbinamento predefinito per Codex: nativo Responses, senza passaggi intermedi
`gpt-6-sol`	$0.80 / $4.00	GPT-6 di OpenAI per attività di programmazione complesse e agenti — lo stesso percorso Responses, a una tariffa inferiore rispetto a 5.6 Sol
`gpt-6-luna`	$0.04 / $0.20	il GPT-6 più economico, per passaggi ad alto volume o a bassa intensità
`gpt-5-6-terra`	$0.70 / $4.20	un modello GPT più economico per sessioni incentrate sulle modifiche
`claude-sonnet-5`	$1.40 / $7.00	un modello non GPT tramite Responses, tradotto dal gateway
`claude-opus-5`	$3.50 / $17.50	passaggi di pianificazione in cui la profondità di ragionamento giustifica la tariffa

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Domande frequenti

Come posso indirizzare Codex CLI a un endpoint API personalizzato?

Aggiungi una tabella [model_providers.<id>] a ~/.codex/config.toml con name, base_url ed env_key, quindi imposta il model_provider di primo livello su quell’ID e model sull’ID che vuoi eseguire. base_url è la radice /v1 del servizio; env_key indica la variabile d’ambiente che contiene la chiave, che quindi non compare mai nel file.

Quale valore wire_api richiede Codex CLI?

"responses" — il riferimento alla configurazione specifica che è l’unico valore supportato e quello predefinito se omesso. Codex ha rimosso il supporto per Chat Completions, quindi un endpoint che implementa solo /v1/chat/completions non può essere usato con Codex, a prescindere dalla configurazione. L’endpoint deve esporre una route /v1/responses effettiva.

Codex CLI può eseguire modelli Claude?

Sì, se l’endpoint li espone tramite l’API Responses. Codex invia una richiesta nel formato Responses all’URL indicato da base_url e inoltra l’ID del modello; pertanto, un gateway che traduce le richieste Responses nel formato specifico del modello può fornire a Codex ID Claude o Gemini. Codex non sa quale fornitore risponde.

Dove conserva la chiave API Codex CLI?

In una variabile d’ambiente indicata dal campo env_key del blocco provider, non in config.toml. Codex legge la variabile all’avvio, quindi la chiave risiede nel profilo della shell o nel gestore di segreti, mentre il file di configurazione può essere incluso nei commit o incollato in una segnalazione senza rischi.