Dokumentasi

Codex CLI

Codex hanya menggunakan Responses API. Satu blok penyedia di config.toml mengarahkannya ke endpoint native /v1/responses milik Kunavo, dengan kunci disimpan dalam variabel lingkungan, bukan di dalam file.

Blok [model_providers.kunavo] di ~/.codex/config.toml dengan env_key, sehingga key tetap berada di lingkungan dan tidak pernah masuk ke file konfigurasi.

~/.codex/config.toml

model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"     # the NAME of the variable, not the key
# wire_api defaults to "responses", which is the only supported value

wire_api kini hanya memiliki satu nilai yang valid: "responses", dan nilai ini menjadi default jika tidak dicantumkan. Dukungan Chat Completions telah dihapus dari Codex, jadi panduan lama yang menyarankan Anda menulis wire_api = "chat" sudah tidak berlaku — dan endpoint apa pun yang tidak memiliki rute /v1/responses yang benar-benar tersedia sama sekali tidak dapat digunakan dari Codex. Kunavo mengimplementasikannya secara native.

env_key menyimpan nama variabel lingkungan, bukan kuncinya sendiri. Ini memang disengaja oleh OpenAI: config.toml adalah file yang biasa di-commit dan ditempelkan ke laporan masalah.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Codex CLI.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Tambahkan blok di atas ke ~/.codex/config.toml, dan buat file tersebut jika belum ada.
Referensi konfigurasi mendokumentasikan tabel model_providers yang sama dengan http_headers dan env_http_headers untuk header permintaan tambahan, serta mencadangkan ID openai, ollama, dan lmstudio untuk penyedia bawaan, sehingga blok kustom memerlukan ID tersendiri, seperti kunavo (referensi berkas konfigurasi learn.chatgpt.com, dibaca pada 25 Oktober 2026).
Ekspor variabel bernama sesuai env_key: export KUNAVO_API_KEY=sk-kn-...
Jalankan codex. model_provider tingkat teratas memilih bloknya; model memilih ID di dalam blok tersebut.
Untuk mengganti model per sesi tanpa mengedit file, gunakan codex -m <model id>, atau simpan beberapa blok penyedia lalu ubah model_provider.

Diperiksa terhadap referensi file konfigurasi Codex pada 6 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di panduan kunci API Codex CLI.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Codex CLI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Codex CLI
`gpt-5-6-sol`	$2.00 / $12.00	pasangan Codex default — native Responses, langsung diteruskan
`gpt-6-sol`	$0.80 / $4.00	GPT-6 OpenAI untuk pengodean kompleks dan agen — jalur Responses yang sama, dengan tarif lebih rendah daripada 5.6 Sol
`gpt-6-luna`	$0.04 / $0.20	GPT-6 termurah, untuk penggunaan bervolume tinggi atau upaya rendah
`gpt-5-6-terra`	$0.70 / $4.20	tingkat GPT yang lebih murah untuk sesi yang banyak mengedit
`claude-sonnet-5`	$1.40 / $7.00	model non-GPT melalui Responses — diterjemahkan di gateway
`claude-opus-5`	$3.50 / $17.50	tahap perencanaan ketika kedalaman penalaran sepadan dengan tarifnya

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Bagaimana cara mengarahkan Codex CLI ke endpoint API khusus?

Tambahkan tabel [model_providers.<id>] ke ~/.codex/config.toml dengan name, base_url, dan env_key, lalu atur model_provider tingkat teratas ke ID tersebut dan model ke ID yang ingin Anda jalankan. base_url adalah akar /v1 layanan; env_key menetapkan nama variabel lingkungan yang menyimpan kunci, sehingga kunci tidak pernah muncul di dalam file.

Nilai wire_api apa yang diperlukan Codex CLI?

"responses" — referensi konfigurasi menyatakan bahwa ini satu-satunya nilai yang didukung dan menjadi default jika tidak dicantumkan. Codex telah menghapus dukungan Chat Completions, jadi endpoint yang hanya mengimplementasikan /v1/chat/completions tidak dapat digunakan dari Codex, apa pun konfigurasinya. Endpoint harus menyediakan rute /v1/responses yang benar-benar berfungsi.

Dapatkah Codex CLI menjalankan model Claude?

Ya, jika endpoint menyediakan model tersebut melalui Responses API. Codex mengirim permintaan berformat Responses ke alamat yang ditetapkan oleh base_url dan meneruskan ID model, sehingga gateway yang menerjemahkan Responses ke format modelnya sendiri dapat menyediakan ID Claude atau Gemini untuk Codex. Codex sendiri tidak mengetahui vendor mana yang merespons.

Di mana Codex CLI menyimpan kunci API?

Di dalam variabel lingkungan yang namanya ditetapkan oleh kolom env_key pada blok penyedia, bukan di config.toml. Codex membaca variabel tersebut saat dimulai, jadi kunci tersimpan di profil shell atau pengelola rahasia Anda, dan file konfigurasi tetap aman untuk di-commit maupun ditempelkan ke laporan bug.