Laman utama / Panduan / Gunakan Codex CLI dengan model percuma

Gunakan Codex CLI dengan model percuma

Codex CLI ialah ejen pengekodan sumber terbuka OpenAI untuk terminal. Ia boleh menggunakan pembekal model tersuai. Panduan ini menyambungkan Codex CLI kepada model percuma daripada pembekal lain melalui FreeLLMAPI. Codex menggunakan Responses API, dan FreeLLMAPI menyediakannya pada /v1/responses.

Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.

Cara ia berfungsi

Codex CLI menghantar permintaan dalam format Responses OpenAI. Dokumentasi Codex menyatakan bahawa responses ialah satu-satunya nilai wire_api yang disokong. Oleh itu, pembekal untuk Codex mesti menyediakan /v1/responses. FreeLLMAPI menyediakan titik akhir ini. Ia menterjemah setiap permintaan dan menghantarnya kepada model percuma, contohnya Gemini, GPT-OSS, Qwen atau GLM.

  • Anda dapat: ejen Codex CLI, alatnya dan gelung sunting, pada model percuma.
  • Anda tidak dapat: model GPT OpenAI sendiri melalui pelan ChatGPT anda. Permintaan dihantar kepada pembekal percuma dalam kumpulan FreeLLMAPI anda.
  • Had: input imej pada /v1/responses belum disokong. Gunakan gesaan teks.

Langkah 1: Pasang FreeLLMAPI dan Codex CLI

Pasang kedua-duanya

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codex

Buka http://localhost:3001. Tambah sekurang-kurangnya dua kunci pembekal percuma pada halaman Keys. Salin kunci bersatu anda daripada halaman yang sama. Pada macOS, anda juga boleh memasang Codex dengan brew install --cask codex.

Langkah 2: Sambungkan Codex CLI

Arahan persediaan menambah pembekal ke ~/.codex/config.toml. Ia membuat sandaran dahulu dan menggabungkan blok baharu, jadi tetapan lain anda kekal.

Satu arahan

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

Arahan itu menulis tetapan ini, dengan nilai daripada katalog langsung anda. Kunci tidak terdapat dalam fail. Codex membacanya daripada pembolehubah persekitaran FREELLMAPI_API_KEY, jadi eksport pembolehubah itu dalam setiap shell tempat anda menjalankan 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
KunciApa yang dilakukannya
model_providerMemilih pembekal daripada model_providers. Lalainya ialah openai.
env_keyPembolehubah persekitaran yang menyimpan kunci API pembekal
requires_openai_authfalse bermakna Codex tidak meminta log masuk OpenAI
model_context_windowToken konteks bagi model aktif. Arahan itu mengambil nilai daripada katalog langsung anda.
model_auto_compact_token_limitBilangan token yang memulakan pemadatan sejarah automatik. Arahan menetapkan 90% daripada tetingkap konteks.
tool_output_token_limitBelanjawan token bagi setiap output alat yang Codex simpan dalam sejarah

Untuk menyimpan kunci di luar fail dan di luar profil shell anda, gunakan pelancar. Ia memulakan Codex dengan kunci dalam persekitarannya sahaja:

Pelancar tanpa kegigihan

npx freellmapi launch-codex

Untuk memastikan permintaan sampai ke get laluan, jalankan npx freellmapi doctor. Ia menyemak pengepala Authorization yang dihalakan, katalog dan semakan langsung. Log permintaan papan pemuka kemudian memaparkan setiap panggilan Codex. Pengepala respons X-Routed-Via menamakan pembekal dan model yang menjawab. Jika permintaan beralih kerana kegagalan, X-Fallback-Trail menamakan setiap hop yang gagal dan sebabnya.

Profil: dokumentasi Codex menyatakan bahawa Codex 0.134.0 dan kemudian tidak lagi membaca jadual [profiles.NAME] daripada config.toml. Profil kini ialah fail berasingan, contohnya ~/.codex/NAME.config.toml. Gunakan persediaan lalai di atas dengan versi Codex semasa.

Buang amaran metadata model

Codex mencetak "Model metadata for auto not found" pada setiap larian. Codex tidak mengenali id model get laluan. Untuk memberinya metadata sebenar, seperti tetingkap konteks dan sokongan imej, tambah URL katalog model kepada pembekal:

Tambah kepada [model_providers.freellmapi]

model_catalog_url = "http://localhost:3001/v1/codex/models"

Katalog mengekalkan prompt sistem lalai Codex dan tetapan alatnya. Hanya amaran dan tetingkap konteks yang berubah.

Pilih model untuk Codex CLI

Codex ialah ejen. Ia menjalankan arahan shell dan menyunting fail melalui panggilan alat. Gunakan model dengan panggilan alat dan tetingkap konteks yang besar. Jadual menunjukkan model percuma yang memenuhi kedua-dua syarat hari ini.

Model percuma untuk Codex CLI: panggilan alat dan konteks 128K+
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
GLM 5.3UnoRouter1M1 permintaan/minit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/minit
40 RPM
YaYa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceYaTidak
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditYaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/minit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/minit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/minit
250 permintaan/hari
70,000 token/minit
~6M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayYaYa

Memaparkan 12 daripada 109 model percuma yang sepadan. Lihat semua model.

Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.

Kekalkan model = "auto" supaya penghala memilih model untuk setiap permintaan. Untuk mengunci satu model, jalankan npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Anda juga boleh menetapkan model = "auto:smart" atau model = "auto:fast" dalam config.toml.

Tier percuma mempunyai had seminit dan sehari. Apabila pembekal menghantar ralat 429, FreeLLMAPI menghantar permintaan kepada model seterusnya dalam rantaian. Tambah kunci daripada empat pembekal atau lebih untuk sesi Codex yang panjang. Codex memadatkan sejarahnya apabila ia mencapai model_auto_compact_token_limit. Nilai yang lebih rendah menghantar permintaan yang lebih kecil, yang membantu pada tier percuma dengan had token seminit yang rendah.

Penyelesaian masalah

MasalahPuncaPenyelesaian
Codex meminta anda log masuk dengan ChatGPTmodel_provider tidak ditetapkan, jadi Codex menggunakan openaiTetapkan model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY tidak ditetapkan dalam shell iniEksport pembolehubah itu, atau gunakan npx freellmapi launch-codex
"Model metadata for auto not found"Codex tidak mengenali id model get laluanTambah model_catalog_url
Ralat dengan wire_api = "chat"Codex hanya menyokong Responses APITetapkan wire_api = "responses"
Tetapan profil diabaikanCodex 0.134.0 dan kemudian mengabaikan jadual [profiles.NAME]Gunakan persediaan pembekal lalai, atau fail profil berasingan
"Semua model had kadar selepas N percubaan"Semua kunci berada pada hadTambah kunci daripada lebih banyak pembekal, atau tunggu tempoh rehat tamat
Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

Soalan lazim

Bolehkah saya menggunakan Codex CLI secara percuma?

Boleh. Codex CLI ialah sumber terbuka. Tambah FreeLLMAPI sebagai pembekal model tersuai dalam config.toml. Get laluan menghantar setiap permintaan kepada tier pembekal percuma, jadi kos inferens ialah $0.

Bolehkah Codex CLI menggunakan model daripada pembekal lain?

Boleh. Tambah blok [model_providers.] dengan base_url, env_key dan wire_api = "responses", kemudian tetapkan model_provider. Pembekal mesti menyediakan Responses API.

Adakah Codex CLI menyokong Chat Completions API?

Tidak. Rujukan konfigurasi Codex menyatakan bahawa responses ialah satu-satunya nilai wire_api yang disokong. FreeLLMAPI menyediakan /v1/responses, jadi ia berfungsi sebagai pembekal Codex.

Model percuma yang manakah terbaik untuk Codex CLI?

Gunakan model dengan panggilan alat dan sekurang-kurangnya 128K konteks. Jadual pada halaman ini menunjukkan model percuma yang paling kuat yang memenuhi kedua-dua syarat hari ini.

Bagaimana saya membetulkan 'Model metadata for auto not found'?

Tambah model_catalog_url = "http://localhost:3001/v1/codex/models" kepada blok pembekal dalam ~/.codex/config.toml. Codex kemudian membaca metadata sebenar bagi model get laluan.

Panduan berkaitan

Sumber

Semua panduan · Lihat semua model percuma