Gunakan Codex CLI dengan model gratis
Codex CLI adalah agen pemrograman sumber terbuka dari OpenAI untuk terminal. Ia dapat menggunakan penyedia model kustom. Panduan ini menghubungkan Codex CLI ke model gratis dari penyedia lain melalui FreeLLMAPI. Codex menggunakan Responses API, dan FreeLLMAPI menyajikannya di /v1/responses.
Kode, nama model, dan label katalog langsung ditampilkan dalam bahasa Inggris.
Cara kerjanya
Codex CLI mengirim permintaan dalam format Responses OpenAI. Dokumentasi Codex menyatakan bahwa responses adalah satu-satunya nilai wire_api yang didukung. Jadi, penyedia untuk Codex harus menyajikan /v1/responses. FreeLLMAPI menyajikan endpoint ini. Ia menerjemahkan setiap permintaan dan mengirimnya ke model gratis, misalnya Gemini, GPT-OSS, Qwen, atau GLM.
- Yang Anda dapatkan: agen Codex CLI, tool-nya, dan loop edit-nya, pada model gratis.
- Yang tidak Anda dapatkan: model GPT milik OpenAI melalui paket ChatGPT Anda. Permintaan dikirim ke penyedia gratis dalam kumpulan FreeLLMAPI Anda.
- Batasan: input gambar pada
/v1/responsesbelum didukung. Gunakan prompt teks.
Langkah 1: Pasang FreeLLMAPI dan Codex CLI
Pasang keduanya
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexBuka http://localhost:3001. Tambahkan minimal dua kunci penyedia gratis di halaman Keys. Salin kunci terpadu Anda dari halaman yang sama. Di macOS, Anda juga dapat memasang Codex dengan brew install --cask codex.
Langkah 2: Hubungkan Codex CLI
Perintah pengaturan menambahkan penyedia ke ~/.codex/config.toml. Perintah ini membuat cadangan terlebih dahulu dan menggabungkan blok baru, sehingga pengaturan Anda yang lain tetap ada.
Satu perintah
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexPerintah ini menulis pengaturan berikut, dengan nilai dari katalog langsung Anda. Kunci tidak ada di dalam file. Codex membacanya dari variabel lingkungan FREELLMAPI_API_KEY, sehingga ekspor variabel tersebut di 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 | Fungsinya |
|---|---|
model_provider | Memilih penyedia dari model_providers. Nilai bawaannya adalah openai. |
env_key | Variabel lingkungan yang berisi kunci API penyedia |
requires_openai_auth | false berarti Codex tidak meminta login OpenAI |
model_context_window | Token konteks dari model yang aktif. Perintah ini mengambil nilainya dari katalog langsung Anda. |
model_auto_compact_token_limit | Jumlah token yang memulai pemadatan riwayat otomatis. Perintah ini mengatur 90% dari jendela konteks. |
tool_output_token_limit | Anggaran token untuk setiap output tool yang disimpan Codex dalam riwayat |
Untuk menjaga kunci tetap di luar file dan di luar profil shell Anda, gunakan launcher. Launcher menjalankan Codex dengan kunci hanya di dalam lingkungannya:
Launcher tanpa penyimpanan
npx freellmapi launch-codexUntuk memastikan permintaan sampai ke gateway, jalankan npx freellmapi doctor. Perintah ini memeriksa header Authorization yang dirutekan, katalog, dan probe langsung. Log permintaan di dasbor kemudian menampilkan setiap panggilan Codex. Header respons X-Routed-Via menyebutkan penyedia dan model yang menjawab. Jika sebuah permintaan berpindah karena gagal, X-Fallback-Trail menyebutkan setiap hop yang gagal beserta alasannya.
[profiles.NAME] dari config.toml. Profil kini berupa file terpisah, misalnya ~/.codex/NAME.config.toml. Gunakan pengaturan bawaan di atas dengan versi Codex yang terbaru.Hapus peringatan metadata model
Codex mencetak "Model metadata for auto not found" pada setiap jalannya. Codex tidak mengenal id model gateway. Untuk memberinya metadata yang sebenarnya, seperti jendela konteks dan dukungan gambar, tambahkan URL katalog model ke penyedia:
Tambahkan ke [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"Katalog mempertahankan system prompt bawaan dan pengaturan tool milik Codex. Hanya peringatan dan jendela konteks yang berubah.
Pilih model untuk Codex CLI
Codex adalah agen. Ia menjalankan perintah shell dan mengedit file melalui panggilan tool. Gunakan model dengan tool calling dan jendela konteks yang besar. Tabel menampilkan model gratis yang memenuhi kedua aturan tersebut saat ini.
| Model | Gratis di | Konteks | Batas gratis (penawaran terbaik) | Alat | Pemrosesan gambar |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/menit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/menit 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/menit 20 permintaan/hari 250,000 token/menit ~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/menit 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/menit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/menit 250 permintaan/hari 70,000 token/menit ~6M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ya | Ya |
Menampilkan 12 dari 109 model gratis yang cocok. Lihat semua model.
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
Biarkan model = "auto" agar router memilih model untuk setiap permintaan. Untuk mengunci satu model, jalankan npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Anda juga dapat mengatur model = "auto:smart" atau model = "auto:fast" di config.toml.
Tier gratis memiliki batas per menit dan per hari. Saat sebuah penyedia mengirim error 429, FreeLLMAPI mengirim permintaan ke model berikutnya dalam rantai. Tambahkan kunci dari empat penyedia atau lebih untuk sesi Codex yang panjang. Codex memadatkan riwayatnya saat mencapai model_auto_compact_token_limit. Nilai yang lebih rendah mengirim permintaan yang lebih kecil, yang membantu pada tier gratis dengan batas token per menit yang rendah.
Pemecahan masalah
| Masalah | Penyebab | Solusi |
|---|---|---|
| Codex meminta Anda masuk dengan ChatGPT | model_provider tidak diatur, sehingga Codex menggunakan openai | Atur model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY tidak diatur di shell ini | Ekspor variabel tersebut, atau gunakan npx freellmapi launch-codex |
Pesan "Model metadata for auto not found" | Codex tidak mengenal id model gateway | Tambahkan model_catalog_url |
Error dengan wire_api = "chat" | Codex hanya mendukung Responses API | Atur wire_api = "responses" |
| Pengaturan profil diabaikan | Codex 0.134.0 dan yang lebih baru mengabaikan tabel [profiles.NAME] | Gunakan pengaturan penyedia bawaan, atau file profil terpisah |
| Pesan "All models rate-limited after N attempts" | Semua kunci mencapai batasnya | Tambahkan kunci dari lebih banyak penyedia, atau tunggu masa jeda selesai |
Pertanyaan yang sering diajukan
Bisakah saya menggunakan Codex CLI secara gratis?
Bisa. Codex CLI bersifat sumber terbuka. Tambahkan FreeLLMAPI sebagai penyedia model kustom di config.toml. Gateway mengirim setiap permintaan ke tier gratis penyedia, sehingga biaya inferensi adalah $0.
Bisakah Codex CLI menggunakan model dari penyedia lain?
Bisa. Tambahkan blok [model_providers.
Apakah Codex CLI mendukung Chat Completions API?
Tidak. Referensi konfigurasi Codex menyatakan bahwa responses adalah satu-satunya nilai wire_api yang didukung. FreeLLMAPI menyajikan /v1/responses, sehingga dapat berfungsi sebagai penyedia Codex.
Model gratis mana yang terbaik untuk Codex CLI?
Gunakan model dengan tool calling dan konteks minimal 128K. Tabel di halaman ini menunjukkan model gratis terkuat yang memenuhi kedua aturan tersebut saat ini.
Bagaimana cara memperbaiki 'Model metadata for auto not found'?
Tambahkan model_catalog_url = "http://localhost:3001/v1/codex/models" ke blok penyedia di ~/.codex/config.toml. Codex kemudian membaca metadata yang sebenarnya untuk model gateway.
Panduan terkait
- Cara memakai Claude Code secara gratis
- Gunakan OpenCode dengan free LLM API
- Gunakan Aider dengan API LLM gratis
- API model coding gratis terbaik
- Apakah ada GPT API gratis?
Sumber
- Codex docs: config reference (diperiksa 20 November 2026)
- Codex docs: advanced config and profiles (diperiksa 20 November 2026)
- Codex CLI repository (diperiksa 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (diperiksa 20 November 2026)
- FreeLLMAPI CLI generators (diperiksa 20 November 2026)