Beranda / Panduan / Gunakan Codex CLI dengan model gratis

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

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

Perintah 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
KunciFungsinya
model_providerMemilih penyedia dari model_providers. Nilai bawaannya adalah openai.
env_keyVariabel lingkungan yang berisi kunci API penyedia
requires_openai_authfalse berarti Codex tidak meminta login OpenAI
model_context_windowToken konteks dari model yang aktif. Perintah ini mengambil nilainya dari katalog langsung Anda.
model_auto_compact_token_limitJumlah token yang memulai pemadatan riwayat otomatis. Perintah ini mengatur 90% dari jendela konteks.
tool_output_token_limitAnggaran 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-codex

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

Profil: dokumentasi Codex menyatakan bahwa Codex 0.134.0 dan yang lebih baru tidak lagi membaca tabel [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 untuk Codex CLI: tool calling dan konteks 128K+
ModelGratis diKonteksBatas gratis (penawaran terbaik)AlatPemrosesan gambar
GLM 5.3UnoRouter1M1 permintaan/menit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/menit
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/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/menit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/menit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/menit
250 permintaan/hari
70,000 token/menit
~6M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayYaYa

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

MasalahPenyebabSolusi
Codex meminta Anda masuk dengan ChatGPTmodel_provider tidak diatur, sehingga Codex menggunakan openaiAtur model_provider = "freellmapi"
401 "Invalid API key"FREELLMAPI_API_KEY tidak diatur di shell iniEkspor variabel tersebut, atau gunakan npx freellmapi launch-codex
Pesan "Model metadata for auto not found"Codex tidak mengenal id model gatewayTambahkan model_catalog_url
Error dengan wire_api = "chat"Codex hanya mendukung Responses APIAtur wire_api = "responses"
Pengaturan profil diabaikanCodex 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 batasnyaTambahkan kunci dari lebih banyak penyedia, atau tunggu masa jeda selesai
Gunakan semua ini melalui satu kunci. FreeLLMAPI adalah router sumber terbuka yang Anda hosting sendiri. Router ini menempatkan semua paket gratis ini di balik satu endpoint yang kompatibel dengan OpenAI, dan beralih ke penyedia lain saat batas permintaan tercapai. Lihat katalog atau mulai.

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.] dengan base_url, env_key, dan wire_api = "responses", lalu atur model_provider. Penyedia harus menyajikan Responses API.

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

Sumber

Semua panduan · Lihat semua model gratis