Provider custom Codex CLI di config.toml
Tambahkan provider model custom ke Codex CLI di ~/.codex/config.toml dengan wire_api = "responses", simpan key di variabel environment, lalu cek dengan satu request curl.
Secara bawaan Codex CLI terhubung ke OpenAI, tetapi file konfigurasinya bisa mengarahkannya ke provider mana pun yang memakai format OpenAI Responses. Artikel ini menunjukkan blok provider di ~/.codex/config.toml, fungsi tiap field, dan cara mengecek pengaturannya sebelum memulai sesi.
Lokasi file konfigurasi
Referensi konfigurasi Codex menyebut: "User-level configuration lives in ~/.codex/config.toml", artinya konfigurasi tingkat pengguna ada di ~/.codex/config.toml (sumber). Di Windows lokasinya %USERPROFILE%\.codex\config.toml. Provider custom ditulis di file pengguna ini; .codex/config.toml milik project tidak bisa mendefinisikannya.
Field provider custom
Provider custom adalah tabel [model_providers.<id>]. Referensi resmi mencantumkan field berikut (sumber):
| Field | Deskripsi resmi |
|---|---|
name | "Display name for a custom model provider.": nama tampilan provider |
base_url | "API base URL for the model provider.": base URL API provider |
env_key | "Environment variable supplying the provider API key.": variabel environment yang berisi API key |
wire_api | "Protocol used by the provider. responses is the only supported value, and it is the default when omitted.": hanya responses yang didukung, dan menjadi bawaan bila tidak ditulis |
Dua key di tingkat atas menentukan apa yang dipakai Codex: model, yaitu nama model, dan model_provider, yaitu "Provider id from model_providers (default: openai)". ID openai, ollama, dan lmstudio sudah dipakai dan tidak bisa ditimpa ("are reserved and cannot be overridden"), jadi beri provider Anda ID sendiri.
Panduan lama di internet masih menulis wire_api = "chat". Referensi terbaru hanya mencantumkan responses, jadi provider harus melayani endpoint Responses.
Contoh yang berjalan
Cent AI melayani format Responses di https://api.cent-ai.dev/v1, dan Codex menambahkan /responses sendiri. Tambahkan ini ke ~/.codex/config.toml:
model = "gpt-6-sol"
model_provider = "centai"
[model_providers.centai]
name = "Cent AI"
base_url = "https://api.cent-ai.dev/v1"
env_key = "CENT_AI_KEY"
wire_api = "responses"
Key tidak ditulis di file. Pasang di environment, ganti YOUR_API_KEY dengan key dari Keys:
export CENT_AI_KEY="YOUR_API_KEY"
$env:CENT_AI_KEY = "YOUR_API_KEY"
Codex mengirim key sebagai Authorization: Bearer. Agar berlaku di semua terminal, tambahkan baris yang sama ke ~/.bashrc atau $PROFILE PowerShell. Kami menguji blok ini dengan Codex 0.161.0 pada 2026-11-13; langkah lengkapnya ada di panduan Codex.
Cek sebelum sesi pertama
Kirim satu request Responses dengan key dan base URL yang sama:
curl https://api.cent-ai.dev/v1/responses \
-H "Authorization: Bearer $CENT_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-sol","input":"Hello"}'
Bila menjawab, jalankan codex dari terminal yang sama. Bila curl berhasil tetapi Codex gagal, bedanya ada di file konfigurasi atau environment, bukan di key. Respons memuat usage.cost, yaitu jumlah yang ditagih untuk request itu dalam USD.
Error yang sering muncul
| Error | Penyebab biasa | Perbaikan |
|---|---|---|
401 invalid_api_key | CENT_AI_KEY kosong di terminal ini, atau env_key menyebut variabel lain | Pasang variabel di terminal yang menjalankan Codex; samakan namanya |
404 model_not_found | model bukan nama dari daftar model | Salin namanya persis, misalnya gpt-6-sol |
501 not_available_yet | base_url mengarah ke path yang salah | Pakai https://api.cent-ai.dev/v1, dengan /v1 dan tanpa tambahan apa pun |
429 rate_limited | Lebih dari 600 request per menit di satu key | Bagi sesi paralel ke beberapa key |
Berapa biayanya
Setiap model punya empat tarif per sejuta token. Codex mengirim ulang percakapan di setiap giliran, jadi sebagian besar input sesi panjang biasanya dibaca dari cache. Tarif dua model yang cocok untuk Codex, dari halaman harga pada 2026-11-14, per 1 juta token:
| Model | Input | Cache read | Cache write | Output |
|---|---|---|---|---|
| gpt-6-sol | $0,26 | $0,044 | $0,26 | $1,30 |
| gpt-6.1-sol | $0,20 | $0,02 | $0,20 | $1,00 |
Setiap giliran tampil di halaman Requests di dashboard, lengkap dengan token per tarif dan biayanya. Anda membayar dari saldo prabayar, diisi lewat QRIS atau dengan USDT atau USDC di jaringan Solana (biaya jaringan dari dompet Anda ditanggung sendiri). Setiap pembayaran dilakukan manual, tanpa perpanjangan otomatis.
Sumber
- learn.chatgpt.com/docs/config-file/config-reference (membuka tab baru) · diakses 2026-11-14
- learn.chatgpt.com/docs/config-file/config-advanced (membuka tab baru) · diakses 2026-11-14
- cent-ai.dev/id/docs/integrations/codex (membuka tab baru) · diakses 2026-11-14
Artikel terkait
- Kartu ditolak saat bayar API AI? Ini yang bisa dicekpayment · 3 mntHal-hal umum yang bisa dicek saat kartu debit atau kredit ditolak ketika membeli kredit API AI, dan alternatif prabayar lewat QRIS atau USDT/USDC.
- OpenCode dan Cline dengan API bayar rupiahopencode · 2 mntPasang OpenCode dan Cline CLI ke API yang dibayar dengan QRIS, langkah yang kami uji di OpenCode 2.3.0 dan Cline 3.0.74, plus biaya nyata satu giliran.
- Cara mengatasi batas 5 jam Claude Codeclaude-code · 4 mntKenapa Claude Code berhenti dengan "Usage limit reached" di paket Pro atau Max, cara resmi untuk lanjut, dan cara memakainya dengan API key prabayar tanpa jendela 5 jam.