Home / Guide / Usare Codex CLI con modelli gratuiti

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/responses non è 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/codex

Apri 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
codex

Il 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
ChiaveCosa fa
model_providerSeleziona il provider da model_providers. Il valore predefinito è openai.
env_keyLa variabile d'ambiente che contiene la chiave API del provider
requires_openai_authfalse significa che Codex non chiede l'accesso a OpenAI
model_context_windowI token di contesto del modello attivo. Il comando prende il valore dal tuo catalogo attivo.
model_auto_compact_token_limitIl numero di token che avvia la compattazione automatica della cronologia. Il comando imposta il 90% della finestra di contesto.
tool_output_token_limitIl 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-codex

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

Profili: la documentazione di Codex dice che Codex 0.134.0 e versioni successive non leggono più le tabelle [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.

Modelli gratuiti per Codex CLI: tool calling e contesto di 128K+
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3UnoRouter1M1 richieste/min
1 req/min per model
SìNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì
Gemini 3.6 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySì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

ProblemaCausaSoluzione
Codex ti chiede di accedere con ChatGPTmodel_provider non è impostato, quindi Codex usa openaiImposta model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY non è impostata in questa shellEsporta la variabile, oppure usa npx freellmapi launch-codex
"Model metadata for auto not found"Codex non conosce gli id dei modelli del gatewayAggiungi model_catalog_url
Errori con wire_api = "chat"Codex supporta solo la Responses APIImposta wire_api = "responses"
Le impostazioni del profilo vengono ignorateCodex 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 limiteAggiungi chiavi di più provider, oppure attendi le pause
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

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.] con base_url, env_key e wire_api = "responses", poi imposta model_provider. Il provider deve servire la Responses API.

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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti