Home → Guide → Codex con un'API personalizzata: configurare config.toml per Codex CLI e Codex desktop

Codex con un'API personalizzata: configurare config.toml per Codex CLI e Codex desktop

Codex legge il provider da un unico file. Cinque righe di configurazione e una variabile d'ambiente cambiano insieme lo strumento a riga di comando e l'app desktop — e la maggior parte dei problemi nasce dalla variabile, non dalla configurazione.

La configurazione

Aggiungi un provider in config.toml e rendilo predefinito:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Contano tre dettagli. base_url termina con /v1, perché Codex aggiunge da solo /responses. wire_api = "responses" fa usare a Codex la Responses API, supportata da questo gateway. E env_key è il nome di una variabile d'ambiente, non la chiave.

Dove si trova il file

macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml

Crea cartella e file se non esistono. L'app desktop di Codex legge lo stesso file dello strumento a riga di comando, quindi una modifica vale per entrambi. Se preferisci non modificare TOML a mano, CC Switch può scriverlo per te — vedi la guida alle app desktop.

Impostare la chiave in modo che Codex la veda

macOS / Linux — aggiungila al profilo della shell:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — salvala per il tuo account utente:

setx APICLAN_API_KEY "sk-your-key"

È qui che si rompe la maggior parte delle configurazioni. Una variabile impostata con export o $env: esiste solo in quel terminale; l'app desktop, avviata dal Dock o dal menu Start, non la vede mai. setx su Windows la salva in modo permanente, ma la leggono solo i programmi avviati dopo: chiudi completamente Codex e riaprilo.

Scegliere modello e livello di ragionamento

Cambia model nella configurazione oppure in sessione con /model:

Modello	Adatto a
`gpt-6.1-sol`, `gpt-5.6-terra`	Programmazione quotidiana, modifiche, test — il più economico per chiamata
`gpt-5.6-sol`	Quando i tuoi prompt sono tarati su GPT-5.6
`gpt-6-astra`	Problemi difficili in cui una risposta migliore vale cinque volte il prezzo

model_reasoning_effort accetta low, medium, high e xhigh. Più sforzo significa più testo: su gpt-5.6-sol qui la chiamata mediana in high ha restituito 373 token di output contro 139 in medium — 2,7 volte tanto, tutto fatturato come output. Parti da medium. I prezzi sono nella guida ai prezzi dell'API OpenAI.

Com'è il traffico di Codex qui

Negli ultimi 30 giorni l'87% delle chiamate GPT di questo gateway è arrivato da Codex, tutte tramite /v1/responses in streaming. La chiamata mediana:

portava circa 67.000 token di contesto, l'86% dalla cache
è durata 14 secondi in tutto, primo token dopo 10
ha restituito 214 token di output

I quattro errori più comuni

401 Unauthorized → Codex non vede APICLAN_API_KEY. Impostala come sopra e riavvia completamente Codex. echo $APICLAN_API_KEY nello stesso ambiente dovrebbe stampare la chiave.
404 o una pagina HTML → a base_url manca /v1, oppure c'è due volte.
model not found → il nome del modello è sbagliato, o la tua chiave appartiene a un gruppo che non lo include. Fa fede GET https://apiclan.us/v1/models.
stream disconnected o timeout sulle attività lunghe → un ragionamento molto lungo supera la pazienza di un proxy. Cambia base_url in https://api.apiclan.us/v1, che aggira il limite di 100 secondi.

Claude Code segue la convenzione opposta — senza /v1 —, spiegata nella guida alla base URL di Claude Code.

Inizia a usarlo

Nessun abbonamento, nessun minimo mensile, nessuna telefonata commerciale. Ricarica in USDT e spendi quello che usi — 1 USDT ti dà 2 crediti di saldo API.

Leggi l'avvio rapido da 30 secondi

Lingua: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

I prezzi di questa pagina sono compilati automaticamente dai dati di fatturazione reali. Le condizioni di terzi sono citate dalla loro documentazione.