Folosiți Codex CLI cu modele gratuite
Codex CLI este agentul de programare cu cod deschis al OpenAI, pentru terminal. Poate folosi un furnizor de model personalizat. Acest ghid conectează Codex CLI la modele gratuite de la alți furnizori prin FreeLLMAPI. Codex vorbește API-ul Responses, iar FreeLLMAPI îl servește la /v1/responses.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Cum funcționează
Codex CLI trimite cereri în formatul OpenAI Responses. Documentația Codex spune că responses este singura valoare wire_api acceptată. Deci un furnizor pentru Codex trebuie să servească /v1/responses. FreeLLMAPI servește acest punct final. Traduce fiecare cerere și o trimite către un model gratuit, de exemplu Gemini, GPT-OSS, Qwen sau GLM.
- Primiți: agentul Codex CLI, instrumentele sale și bucla sa de editare, pe modele gratuite.
- Nu primiți: modelele GPT proprii ale OpenAI prin planul dumneavoastră ChatGPT. Cererile merg la furnizorii gratuiți din fondul FreeLLMAPI.
- Limită: intrarea de imagini la
/v1/responsesnu este acceptată încă. Folosiți prompturi text.
Pasul 1: Instalați FreeLLMAPI și Codex CLI
Instalați ambele
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexDeschideți http://localhost:3001. Adăugați cel puțin două chei gratuite de la furnizori pe pagina Keys. Copiați cheia unificată de pe aceeași pagină. Pe macOS, puteți instala Codex și cu brew install --cask codex.
Pasul 2: Conectați Codex CLI
Comanda de configurare adaugă un furnizor în ~/.codex/config.toml. Mai întâi creează o copie de rezervă și îmbină blocul nou, deci celelalte setări rămân.
O singură comandă
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexComanda scrie aceste setări, cu valori din catalogul dumneavoastră live. Cheia nu se află în fișier. Codex o citește din variabila de mediu FREELLMAPI_API_KEY, deci exportați variabila în fiecare shell în care rulați 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| Cheie | Ce face |
|---|---|
model_provider | Selectează furnizorul din model_providers. Implicit este openai. |
env_key | Variabila de mediu care conține cheia API a furnizorului |
requires_openai_auth | false înseamnă că Codex nu cere autentificare OpenAI |
model_context_window | Tokenii de context ai modelului activ. Comanda ia valoarea din catalogul dumneavoastră live. |
model_auto_compact_token_limit | Numărul de tokeni care pornește compactarea automată a istoricului. Comanda setează 90% din fereastra de context. |
tool_output_token_limit | Bugetul de tokeni pentru fiecare ieșire de instrument pe care Codex o păstrează în istoric |
Ca să țineți cheia departe de fișiere și de profilul dumneavoastră de shell, folosiți lansatorul. Acesta pornește Codex cu cheia doar în mediul său:
Lansator fără persistență
npx freellmapi launch-codexCa să verificați că cererile ajung la gateway, rulați npx freellmapi doctor. Comanda verifică antetul Authorization rutat, catalogul și o sondă live. Jurnalul de cereri din panou afișează apoi fiecare apel Codex. Antetul de răspuns X-Routed-Via arată furnizorul și modelul care au răspuns. Dacă o cerere a trecut la alt furnizor, X-Fallback-Trail arată fiecare pas eșuat și motivul.
[profiles.NAME] din config.toml. Profilurile sunt acum fișiere separate, de exemplu ~/.codex/NAME.config.toml. Folosiți configurarea implicită de mai sus cu o versiune actuală de Codex.Eliminați avertismentul despre metadatele modelului
Codex afișează "Model metadata for auto not found" la fiecare rulare. Codex nu cunoaște ID-urile de model ale gateway-ului. Ca să-i dați metadate reale, cum ar fi fereastra de context și suportul pentru imagini, adăugați un URL de catalog de modele la furnizor:
Adăugați în [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Catalogul păstrează promptul de sistem implicit al Codex și setările sale de instrumente. Se schimbă doar avertismentul și fereastra de context.
Alegeți modele pentru Codex CLI
Codex este un agent. Rulează comenzi de shell și editează fișiere prin apeluri de instrumente. Folosiți modele cu apelare de instrumente și o fereastră de context mare. Tabelul arată modelele gratuite care respectă astăzi ambele reguli.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 cereri/min 1 req/min per model | Da | Nu |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 cereri/min 40 RPM | Da | Da |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Da | Da |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Da | Nu |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 cereri/min 50 cereri/zi 50 req/day account-wide (1,000 after a $10 purchase) | Da | Da |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 cereri/min 50 cereri/zi Shared rate limit | Da | Nu |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 cereri/min 250 cereri/zi 70,000 tokeni/min ~6M | Da | Da |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Da | Da |
Se afișează 12 din 109 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Păstrați model = "auto" ca routerul să aleagă un model pentru fiecare cerere. Ca să fixați un singur model, rulați npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Puteți seta și model = "auto:smart" sau model = "auto:fast" în config.toml.
Nivelurile gratuite au limite pe minut și pe zi. Când un furnizor trimite o eroare 429, FreeLLMAPI trimite cererea la următorul model din lanț. Adăugați chei de la patru sau mai mulți furnizori pentru sesiuni Codex lungi. Codex compactează istoricul când ajunge la model_auto_compact_token_limit. O valoare mai mică trimite cereri mai mici, ceea ce ajută pe nivelurile gratuite cu limite mici de tokeni pe minut.
Depanare
| Problemă | Cauză | Remediere |
|---|---|---|
| Codex vă cere să vă autentificați cu ChatGPT | model_provider nu este setat, deci Codex folosește openai | Setați model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY nu este setată în acest shell | Exportați variabila sau folosiți npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex nu cunoaște ID-urile de model ale gateway-ului | Adăugați model_catalog_url |
Erori cu wire_api = "chat" | Codex acceptă doar API-ul Responses | Setați wire_api = "responses" |
| Setările de profil sunt ignorate | Codex 0.134.0 și versiunile ulterioare ignoră tabelele [profiles.NAME] | Folosiți configurarea implicită a furnizorului sau un fișier de profil separat |
| Toate modelele au atins limita de rată după N încercări | Toate cheile sunt la limită | Adăugați chei de la mai mulți furnizori sau așteptați pauzele |
Întrebări frecvente
Pot folosi Codex CLI gratuit?
Da. Codex CLI este cu cod deschis. Adăugați FreeLLMAPI ca furnizor de model personalizat în config.toml. Gateway-ul trimite fiecare cerere către niveluri gratuite ale furnizorilor, deci inferența costă 0 $.
Poate Codex CLI să folosească modele de la alți furnizori?
Da. Adăugați un bloc [model_providers.
Acceptă Codex CLI API-ul Chat Completions?
Nu. Referința de configurare Codex spune că responses este singura valoare wire_api acceptată. FreeLLMAPI servește /v1/responses, deci funcționează ca furnizor pentru Codex.
Care model gratuit este cel mai bun pentru Codex CLI?
Folosiți un model cu apelare de instrumente și cel puțin 128K de context. Tabelul de pe această pagină arată cele mai puternice modele gratuite care respectă astăzi ambele reguli.
Cum remediez 'Model metadata for auto not found'?
Adăugați model_catalog_url = "http://localhost:3001/v1/codex/models" în blocul furnizorului din ~/.codex/config.toml. Codex citește apoi metadate reale pentru modelele gateway-ului.
Ghiduri înrudite
- Cum folosiți Claude Code gratuit
- Folosiți OpenCode cu un API LLM gratuit
- Folosiți Aider cu un API LLM gratuit
- Cele mai bune API-uri gratuite pentru modele de cod
- Există un API GPT gratuit?
Surse
- Codex docs: config reference (verificat 20 November 2026)
- Codex docs: advanced config and profiles (verificat 20 November 2026)
- Codex CLI repository (verificat 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (verificat 20 November 2026)
- FreeLLMAPI CLI generators (verificat 20 November 2026)