Nyumbani / Miongozo / Tumia Codex CLI na modeli bure

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

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

Amri 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
UfunguoInachofanya
model_providerHuchagua mtoa huduma kutoka model_providers. Chaguo-msingi ni openai.
env_keyKigezo cha mazingira kinachoshikilia ufunguo wa API wa mtoa huduma
requires_openai_authfalse inamaanisha kwamba Codex haiombi kuingia kwa OpenAI
model_context_windowTokeni za muktadha za modeli inayotumika. Amri inachukua thamani kutoka orodha yako hai.
model_auto_compact_token_limitIdadi ya tokeni inayoanzisha ufinyanzi wa historia otomatiki. Amri inaweka 90% ya dirisha la muktadha.
tool_output_token_limitBajeti 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-codex

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

Wasifu: nyaraka za Codex zinasema kwamba Codex 0.134.0 na matoleo mapya zaidi haisomi tena majedwali ya [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 za Codex CLI: wito wa zana na muktadha wa 128K+
ModeliBure kwenyeMuktadhaVikomo vya bure (ofa bora)ZanaUoni
GLM 5.3UnoRouter1M1 maombi/dakika
1 req/min per model
NdiyoHapana
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 maombi/dakika
40 RPM
NdiyoNdiyo
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaNdiyoNdiyo
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceNdiyoHapana
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditNdiyoNdiyo
Gemini 3.7 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditNdiyoNdiyo
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 maombi/dakika
50 maombi/siku
50 req/day account-wide (1,000 after a $10 purchase)
NdiyoNdiyo
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 maombi/dakika
50 maombi/siku
Shared rate limit
NdiyoHapana
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 maombi/dakika
250 maombi/siku
70,000 tokeni/dakika
~6M
NdiyoNdiyo
Gemini 3.6 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayNdiyoNdiyo

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

TatizoChanzoSuluhisho
Codex inakuomba uingie kwa ChatGPTmodel_provider haijawekwa, kwa hiyo Codex inatumia openaiWeka model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY haijawekwa kwenye shell hiiHamisha kigezo, au tumia npx freellmapi launch-codex
"Model metadata for auto not found"Codex haijui vitambulisho vya modeli za langoOngeza model_catalog_url
Hitilafu zenye wire_api = "chat"Codex inaunga mkono Responses API pekeeWeka wire_api = "responses"
Mipangilio ya wasifu inapuuzwaCodex 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 chakeOngeza funguo kutoka watoa huduma zaidi, au subiri muda wa kupumzika
Tumia kila moja ya hizi kwa ufunguo mmoja. FreeLLMAPI ni kipanga njia huria, unachoendesha mwenyewe. Kinaweka tabaka hizi zote za bure nyuma ya kituo kimoja cha OpenAI kinachooana, na kinahamia kwenye nyingine pale kikomo kinapofikiwa. Vinjari katalogi au anza sasa.

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.] chenye base_url, env_key na wire_api = "responses", kisha weka model_provider. Mtoa huduma lazima ahudumie Responses API.

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

Vyanzo

Miongozo yote · Tazama modeli zote za bure