Usare Codex CLI con modelli gratuiti
Codex CLI è l'agente di programmazione open source di OpenAI per il terminale. Può usare un provider di modelli personalizzato. Questa guida collega Codex CLI a modelli gratuiti di altri provider tramite FreeLLMAPI. Codex usa la Responses API, e FreeLLMAPI la serve su /v1/responses.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Come funziona
Codex CLI invia richieste nel formato Responses di OpenAI. La documentazione di Codex dice che responses è l'unico valore supportato di wire_api. Quindi un provider per Codex deve servire /v1/responses. FreeLLMAPI serve questo endpoint. Traduce ogni richiesta e la invia a un modello gratuito, per esempio Gemini, GPT-OSS, Qwen o GLM.
- Ottieni: l'agente Codex CLI, i suoi strumenti e il suo ciclo di modifica, su modelli gratuiti.
- Non ottieni: i modelli GPT di OpenAI tramite il tuo piano ChatGPT. Le richieste vanno ai provider gratuiti del tuo pool FreeLLMAPI.
- Limite: l'input di immagini su
/v1/responsesnon è ancora supportato. Usa prompt di solo testo.
Passo 1: installa FreeLLMAPI e Codex CLI
Installa entrambi
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexApri http://localhost:3001. Aggiungi almeno due chiavi gratuite di provider nella pagina Keys. Copia la tua chiave unificata dalla stessa pagina. Su macOS puoi anche installare Codex con brew install --cask codex.
Passo 2: collega Codex CLI
Il comando di configurazione aggiunge un provider a ~/.codex/config.toml. Prima crea un backup e unisce il nuovo blocco, quindi le altre impostazioni restano.
Un solo comando
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexIl comando scrive queste impostazioni, con i valori del tuo catalogo attivo. La chiave non è nel file. Codex la legge dalla variabile d'ambiente FREELLMAPI_API_KEY, quindi esporta la variabile in ogni shell in cui esegui Codex.
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| Chiave | Cosa fa |
|---|---|
model_provider | Seleziona il provider da model_providers. Il valore predefinito è openai. |
env_key | La variabile d'ambiente che contiene la chiave API del provider |
requires_openai_auth | false significa che Codex non chiede l'accesso a OpenAI |
model_context_window | I token di contesto del modello attivo. Il comando prende il valore dal tuo catalogo attivo. |
model_auto_compact_token_limit | Il numero di token che avvia la compattazione automatica della cronologia. Il comando imposta il 90% della finestra di contesto. |
tool_output_token_limit | Il budget di token per ogni output di strumento che Codex conserva nella cronologia |
Per non tenere la chiave nei file e nel profilo della shell, usa il launcher. Avvia Codex con la chiave solo nel suo ambiente:
Launcher senza persistenza
npx freellmapi launch-codexPer verificare che le richieste vadano al gateway, esegui npx freellmapi doctor. Controlla l'intestazione Authorization instradata, il catalogo e una prova attiva. Il log delle richieste nella dashboard mostra poi ogni chiamata di Codex. L'intestazione di risposta X-Routed-Via indica il provider e il modello che hanno risposto. Se una richiesta è passata a un altro provider, X-Fallback-Trail indica ogni passaggio fallito e il motivo.
[profiles.NAME] da config.toml. I profili ora sono file separati, per esempio ~/.codex/NAME.config.toml. Usa la configurazione predefinita qui sopra con una versione attuale di Codex.Rimuovi l'avviso sui metadati del modello
Codex stampa "Model metadata for auto not found" a ogni esecuzione. Codex non conosce gli id dei modelli del gateway. Per dargli metadati reali, come la finestra di contesto e il supporto alle immagini, aggiungi un URL del catalogo modelli al provider:
Aggiungi a [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Il catalogo mantiene il prompt di sistema predefinito e le impostazioni degli strumenti di Codex. Cambiano solo l'avviso e la finestra di contesto.
Scegli i modelli per Codex CLI
Codex è un agente. Esegue comandi della shell e modifica i file con chiamate a strumenti. Usa modelli con tool calling e una finestra di contesto ampia. La tabella mostra i modelli gratuiti che oggi rispettano entrambe le regole.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 richieste/min 1 req/min per model | Sì | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | Sì |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 richieste/min 50 richieste/giorno Shared rate limit | Sì | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 richieste/min 250 richieste/giorno 70,000 token/min ~6M | Sì | Sì |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sì | Sì |
Mostrati 12 di 109 modelli gratuiti corrispondenti. Vedi tutti i modelli.
Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.
Mantieni model = "auto" per lasciare che il router scelga un modello per ogni richiesta. Per fissare un modello, esegui npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Puoi anche impostare model = "auto:smart" o model = "auto:fast" in config.toml.
I piani gratuiti hanno limiti al minuto e al giorno. Quando un provider invia un errore 429, FreeLLMAPI invia la richiesta al modello successivo della catena. Aggiungi chiavi di quattro o più provider per le sessioni lunghe di Codex. Codex compatta la sua cronologia quando raggiunge model_auto_compact_token_limit. Un valore più basso invia richieste più piccole, il che aiuta sui piani gratuiti con limiti bassi di token al minuto.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
| Codex ti chiede di accedere con ChatGPT | model_provider non è impostato, quindi Codex usa openai | Imposta model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY non è impostata in questa shell | Esporta la variabile, oppure usa npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex non conosce gli id dei modelli del gateway | Aggiungi model_catalog_url |
Errori con wire_api = "chat" | Codex supporta solo la Responses API | Imposta wire_api = "responses" |
| Le impostazioni del profilo vengono ignorate | Codex 0.134.0 e versioni successive ignorano le tabelle [profiles.NAME] | Usa la configurazione predefinita del provider, oppure un file di profilo separato |
| Messaggio di errore: "All models rate-limited after N attempts" | Tutte le chiavi hanno raggiunto il limite | Aggiungi chiavi di più provider, oppure attendi le pause |
Domande frequenti
Posso usare Codex CLI gratis?
Sì. Codex CLI è open source. Aggiungi FreeLLMAPI come provider di modelli personalizzato in config.toml. Il gateway invia ogni richiesta ai piani gratuiti dei provider, quindi il costo dell'inferenza è di $0.
Codex CLI può usare modelli di altri provider?
Sì. Aggiungi un blocco [model_providers.
Codex CLI supporta la Chat Completions API?
No. Il riferimento di configurazione di Codex dice che responses è l'unico valore supportato di wire_api. FreeLLMAPI serve /v1/responses, quindi funziona come provider per Codex.
Qual è il modello gratuito migliore per Codex CLI?
Usa un modello con tool calling e almeno 128K di contesto. La tabella di questa pagina mostra i modelli gratuiti più forti che oggi rispettano entrambe le regole.
Come risolvo 'Model metadata for auto not found'?
Aggiungi model_catalog_url = "http://localhost:3001/v1/codex/models" al blocco del provider in ~/.codex/config.toml. Codex legge poi i metadati reali dei modelli del gateway.
Guide correlate
- Come usare Claude Code gratis
- Usa OpenCode con un'API LLM gratuita
- Usi Aider con un'API LLM gratuita
- Migliori API gratuite per modelli di codice
- Esiste un'API GPT gratuita?
Fonti
- Codex docs: config reference (verificato il 20 November 2026)
- Codex docs: advanced config and profiles (verificato il 20 November 2026)
- Codex CLI repository (verificato il 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (verificato il 20 November 2026)
- FreeLLMAPI CLI generators (verificato il 20 November 2026)