Acasă / Ghiduri / Folosiți Codex CLI cu modele gratuite

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/responses nu 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/codex

Deschideț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
codex

Comanda 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
CheieCe face
model_providerSelectează furnizorul din model_providers. Implicit este openai.
env_keyVariabila de mediu care conține cheia API a furnizorului
requires_openai_authfalse înseamnă că Codex nu cere autentificare OpenAI
model_context_windowTokenii de context ai modelului activ. Comanda ia valoarea din catalogul dumneavoastră live.
model_auto_compact_token_limitNumărul de tokeni care pornește compactarea automată a istoricului. Comanda setează 90% din fereastra de context.
tool_output_token_limitBugetul 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-codex

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

Profiluri: documentația Codex spune că Codex 0.134.0 și versiunile ulterioare nu mai citesc tabelele [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.

Modele gratuite pentru Codex CLI: apelare de instrumente și context de 128K+
ModelGratuit peContextLimite gratuite (cea mai bună ofertă)InstrumenteViziune
GLM 5.3UnoRouter1M1 cereri/min
1 req/min per model
DaNu
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 cereri/min
40 RPM
DaDa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaDaDa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceDaNu
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditDaDa
Gemini 3.7 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditDaDa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 cereri/min
50 cereri/zi
50 req/day account-wide (1,000 after a $10 purchase)
DaDa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 cereri/min
50 cereri/zi
Shared rate limit
DaNu
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 cereri/min
250 cereri/zi
70,000 tokeni/min
~6M
DaDa
Gemini 3.6 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayDaDa

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 ChatGPTmodel_provider nu este setat, deci Codex folosește openaiSetați model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY nu este setată în acest shellExportaț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-uluiAdăugați model_catalog_url
Erori cu wire_api = "chat"Codex acceptă doar API-ul ResponsesSetați wire_api = "responses"
Setările de profil sunt ignorateCodex 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ăriToate cheile sunt la limităAdăugați chei de la mai mulți furnizori sau așteptați pauzele
Folosiți fiecare dintre aceste modele printr-o singură cheie. FreeLLMAPI este un router open-source, găzduit de dumneavoastră, care pune toate aceste niveluri gratuite în spatele unui singur endpoint compatibil cu OpenAI și trece la alt furnizor când un furnizor este limitat la rată. Vezi catalogul sau trece live.

Î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.] cu base_url, env_key și wire_api = "responses", apoi setați model_provider. Furnizorul trebuie să servească API-ul Responses.

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

Surse

Toate ghidurile · Vezi toate modelele gratuite