Tumia Codex CLI na modeli bure
Codex CLI ni wakala wa kuandika msimbo wa chanzo huria wa OpenAI kwa terminal. Inaweza kutumia mtoa huduma maalum wa modeli. Mwongozo huu unaunganisha Codex CLI kwenye modeli bure kutoka watoa huduma wengine kupitia FreeLLMAPI. Codex inazungumza Responses API, na FreeLLMAPI inaihudumia kwenye /v1/responses.
Msimbo, majina ya modeli na lebo za katalogi ya moja kwa moja zinaonyeshwa kwa Kiingereza.
Inavyofanya kazi
Codex CLI hutuma maombi kwa muundo wa OpenAI Responses. Nyaraka za Codex zinasema kwamba responses ndiyo thamani pekee ya wire_api inayoungwa mkono. Kwa hiyo mtoa huduma wa Codex lazima ahudumie /v1/responses. FreeLLMAPI inahudumia sehemu hii ya mwisho. Inabadilisha kila ombi na kulituma kwa modeli bure, kwa mfano Gemini, GPT-OSS, Qwen au GLM.
- Unapata: wakala wa Codex CLI, zana zake na mzunguko wake wa uhariri, kwenye modeli bure.
- Hupati: modeli za GPT za OpenAI kupitia mpango wako wa ChatGPT. Maombi yanaenda kwa watoa huduma bure walio kwenye bwawa lako la FreeLLMAPI.
- Kikomo: ingizo la picha kwenye
/v1/responsesbado halijaungwa mkono. Tumia maelekezo ya maandishi.
Hatua 1: Sakinisha FreeLLMAPI na Codex CLI
Sakinisha zote mbili
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexFungua http://localhost:3001. Ongeza angalau funguo mbili za watoa huduma bure kwenye ukurasa wa Keys. Nakili ufunguo wako wa umoja kutoka ukurasa uleule. Kwenye macOS, unaweza pia kusakinisha Codex kwa brew install --cask codex.
Hatua 2: Unganisha Codex CLI
Amri ya usanidi huongeza mtoa huduma kwenye ~/.codex/config.toml. Kwanza hutengeneza nakala rudufu na kuunganisha kizuizi kipya, kwa hiyo mipangilio yako mingine inabaki.
Amri moja
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexAmri hii inaandika mipangilio hii, pamoja na thamani kutoka orodha yako hai. Ufunguo haumo kwenye faili. Codex inausoma kutoka kwenye kigezo cha mazingira FREELLMAPI_API_KEY, kwa hiyo hamisha kigezo hicho kwenye kila shell unayoendesha 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| Ufunguo | Inachofanya |
|---|---|
model_provider | Huchagua mtoa huduma kutoka model_providers. Chaguo-msingi ni openai. |
env_key | Kigezo cha mazingira kinachoshikilia ufunguo wa API wa mtoa huduma |
requires_openai_auth | false inamaanisha kwamba Codex haiombi kuingia kwa OpenAI |
model_context_window | Tokeni za muktadha za modeli inayotumika. Amri inachukua thamani kutoka orodha yako hai. |
model_auto_compact_token_limit | Idadi ya tokeni inayoanzisha ufinyanzi wa historia otomatiki. Amri inaweka 90% ya dirisha la muktadha. |
tool_output_token_limit | Bajeti ya tokeni kwa kila matokeo ya zana ambayo Codex inahifadhi kwenye historia |
Ili kuweka ufunguo nje ya faili na nje ya wasifu wa shell yako, tumia kizindua. Kinaanzisha Codex na ufunguo kwenye mazingira yake tu:
Kizindua kisichohifadhi chochote
npx freellmapi launch-codexIli kuhakikisha kwamba maombi yanaenda kwenye lango, endesha npx freellmapi doctor. Inakagua kichwa cha Authorization kilichoelekezwa, orodha na jaribio hai. Kumbukumbu ya maombi ya dashibodi kisha inaonyesha kila wito wa Codex. Kichwa cha jibu X-Routed-Via kinataja mtoa huduma na modeli iliyojibu. Ikiwa ombi lilihamia kwingine baada ya kushindwa, X-Fallback-Trail inataja kila hatua iliyoshindwa na sababu yake.
[profiles.NAME] kutoka config.toml. Wasifu sasa ni faili tofauti, kwa mfano ~/.codex/NAME.config.toml. Tumia usanidi wa chaguo-msingi hapo juu ukiwa na toleo la sasa la Codex.Ondoa onyo la metadata ya modeli
Codex inachapisha "Model metadata for auto not found" kila inapoendeshwa. Codex haijui vitambulisho vya modeli za lango. Ili kuipa metadata halisi, kama dirisha la muktadha na uwezo wa picha, ongeza URL ya orodha ya modeli kwa mtoa huduma:
Ongeza kwenye [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Orodha inahifadhi kidokezo chaguo-msingi cha mfumo wa Codex na mipangilio yake ya zana. Onyo na dirisha la muktadha pekee ndivyo vinavyobadilika.
Chagua modeli za Codex CLI
Codex ni wakala. Huendesha amri za shell na kuhariri faili kupitia wito wa zana. Tumia modeli zenye wito wa zana na dirisha kubwa la muktadha. Jedwali linaonyesha modeli bure zinazotimiza sheria zote mbili kwa sasa.
| Modeli | Bure kwenye | Muktadha | Vikomo vya bure (ofa bora) | Zana | Uoni |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 maombi/dakika 1 req/min per model | Ndiyo | Hapana |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 maombi/dakika 40 RPM | Ndiyo | Ndiyo |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ndiyo | Ndiyo |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ndiyo | Hapana |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 maombi/dakika 50 maombi/siku 50 req/day account-wide (1,000 after a $10 purchase) | Ndiyo | Ndiyo |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 maombi/dakika 50 maombi/siku Shared rate limit | Ndiyo | Hapana |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 maombi/dakika 250 maombi/siku 70,000 tokeni/dakika ~6M | Ndiyo | Ndiyo |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ndiyo | Ndiyo |
Inaonyesha 12 kati ya 109 modeli za bure zinazolingana. Tazama modeli zote.
Data ya moja kwa moja kutoka katalogi ya FreeLLMAPI (toleo 2026.11.19, imekaguliwa 2026-11-19). Vikomo vya bure hubadilika mara kwa mara. Katalogi hukaguliwa kila siku.
Weka model = "auto" ili kipanga njia kichague modeli kwa kila ombi. Ili kubandika modeli moja, endesha npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Unaweza pia kuweka model = "auto:smart" au model = "auto:fast" kwenye config.toml.
Viwango bure vina mipaka kwa dakika na kwa siku. Mtoa huduma anapotuma hitilafu 429, FreeLLMAPI hutuma ombi kwa modeli inayofuata kwenye mnyororo. Ongeza funguo kutoka watoa huduma wanne au zaidi kwa vikao virefu vya Codex. Codex inafinya historia yake inapofikia model_auto_compact_token_limit. Thamani ndogo hutuma maombi madogo, jambo linalosaidia kwenye viwango bure vyenye mipaka midogo ya tokeni kwa dakika.
Kutatua matatizo
| Tatizo | Chanzo | Suluhisho |
|---|---|---|
| Codex inakuomba uingie kwa ChatGPT | model_provider haijawekwa, kwa hiyo Codex inatumia openai | Weka model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY haijawekwa kwenye shell hii | Hamisha kigezo, au tumia npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex haijui vitambulisho vya modeli za lango | Ongeza model_catalog_url |
Hitilafu zenye wire_api = "chat" | Codex inaunga mkono Responses API pekee | Weka wire_api = "responses" |
| Mipangilio ya wasifu inapuuzwa | Codex 0.134.0 na matoleo mapya zaidi hayazingatii majedwali ya [profiles.NAME] | Tumia usanidi wa chaguo-msingi wa mtoa huduma, au faili tofauti la wasifu |
| "Modeli zote zimezuiwa kwa kiwango baada ya majaribio N" | Funguo zote zimefikia kikomo chake | Ongeza funguo kutoka watoa huduma zaidi, au subiri muda wa kupumzika |
Maswali yanayoulizwa mara kwa mara
Naweza kutumia Codex CLI bure?
Ndiyo. Codex CLI ni chanzo huria. Ongeza FreeLLMAPI kama mtoa huduma maalum wa modeli kwenye config.toml. Lango hutuma kila ombi kwa viwango bure vya watoa huduma, kwa hiyo gharama ya uendeshaji ni $0.
Je, Codex CLI inaweza kutumia modeli kutoka watoa huduma wengine?
Ndiyo. Ongeza kizuizi cha [model_providers.
Je, Codex CLI inaunga mkono Chat Completions API?
Hapana. Marejeo ya usanidi wa Codex yanasema kwamba responses ndiyo thamani pekee ya wire_api inayoungwa mkono. FreeLLMAPI inahudumia /v1/responses, kwa hiyo inafanya kazi kama mtoa huduma wa Codex.
Modeli bure ipi ni bora kwa Codex CLI?
Tumia modeli yenye wito wa zana na angalau muktadha wa 128K. Jedwali kwenye ukurasa huu linaonyesha modeli bure zenye nguvu zaidi zinazotimiza sheria zote mbili kwa sasa.
Nawezaje kurekebisha 'Model metadata for auto not found'?
Ongeza model_catalog_url = "http://localhost:3001/v1/codex/models" kwenye kizuizi cha mtoa huduma katika ~/.codex/config.toml. Codex kisha inasoma metadata halisi ya modeli za lango.
Miongozo inayohusiana
- Jinsi ya kutumia Claude Code bila malipo
- Tumia OpenCode kwa free LLM API
- Tumia Aider na API ya bure ya LLM
- API bora za bure za modeli za msimbo
- Je, kuna GPT API ya bure?
Vyanzo
- Codex docs: config reference (imekaguliwa 20 November 2026)
- Codex docs: advanced config and profiles (imekaguliwa 20 November 2026)
- Codex CLI repository (imekaguliwa 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (imekaguliwa 20 November 2026)
- FreeLLMAPI CLI generators (imekaguliwa 20 November 2026)