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.

Cent AITerbit 3 menit baca

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):

FieldDeskripsi 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

ErrorPenyebab biasaPerbaikan
401 invalid_api_keyCENT_AI_KEY kosong di terminal ini, atau env_key menyebut variabel lainPasang variabel di terminal yang menjalankan Codex; samakan namanya
404 model_not_foundmodel bukan nama dari daftar modelSalin namanya persis, misalnya gpt-6-sol
501 not_available_yetbase_url mengarah ke path yang salahPakai https://api.cent-ai.dev/v1, dengan /v1 dan tanpa tambahan apa pun
429 rate_limitedLebih dari 600 request per menit di satu keyBagi 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:

ModelInputCache readCache writeOutput
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

  1. learn.chatgpt.com/docs/config-file/config-reference (membuka tab baru) · diakses 2026-11-14
  2. learn.chatgpt.com/docs/config-file/config-advanced (membuka tab baru) · diakses 2026-11-14
  3. cent-ai.dev/id/docs/integrations/codex (membuka tab baru) · diakses 2026-11-14
BagikanXThreads