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/responsesbelum 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/codexBuka 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
codexArahan 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| Kunci | Apa yang dilakukannya |
|---|---|
model_provider | Memilih pembekal daripada model_providers. Lalainya ialah openai. |
env_key | Pembolehubah persekitaran yang menyimpan kunci API pembekal |
requires_openai_auth | false bermakna Codex tidak meminta log masuk OpenAI |
model_context_window | Token konteks bagi model aktif. Arahan itu mengambil nilai daripada katalog langsung anda. |
model_auto_compact_token_limit | Bilangan token yang memulakan pemadatan sejarah automatik. Arahan menetapkan 90% daripada tetingkap konteks. |
tool_output_token_limit | Belanjawan 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-codexUntuk 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.
[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 pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/minit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/minit 40 RPM | Ya | Ya |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/minit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ya | Ya |
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
| Masalah | Punca | Penyelesaian |
|---|---|---|
| Codex meminta anda log masuk dengan ChatGPT | model_provider tidak ditetapkan, jadi Codex menggunakan openai | Tetapkan model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY tidak ditetapkan dalam shell ini | Eksport pembolehubah itu, atau gunakan npx freellmapi launch-codex |
"Model metadata for auto not found" | Codex tidak mengenali id model get laluan | Tambah model_catalog_url |
Ralat dengan wire_api = "chat" | Codex hanya menyokong Responses API | Tetapkan wire_api = "responses" |
| Tetapan profil diabaikan | Codex 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 had | Tambah kunci daripada lebih banyak pembekal, atau tunggu tempoh rehat tamat |
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.
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
- Cara guna Claude Code secara percuma
- Guna OpenCode dengan API LLM percuma
- Guna Aider dengan API LLM percuma
- Model API pengekodan percuma terbaik
- Adakah terdapat API GPT percuma?
Sumber
- Codex docs: config reference (disemak 20 November 2026)
- Codex docs: advanced config and profiles (disemak 20 November 2026)
- Codex CLI repository (disemak 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (disemak 20 November 2026)
- FreeLLMAPI CLI generators (disemak 20 November 2026)