Kunci API Codex CLI—pengaturan penyedia khusus yang berfungsi

Kunci API Codex adalah kunci apa pun yang dapat digunakan Codex CLI untuk menagih per token, bukan paket ChatGPT: kunci OpenAI API dari platform.openai.com, atau kunci provider seperti sk-kn- milik Kunavo, yang dibaca Codex dari variabel lingkungan bernama env_key dalam blok model_providers. Provider tersebut harus menyediakan Responses API — satu-satunya persyaratan di bawah ini.

Codex CLI adalah agen coding terminal open-source milik OpenAI, dan dapat berjalan dengan login ChatGPT atau kunci API. Rute kunci API patut dipahami: rute ini menagih per token tanpa biaya bulanan, dan merupakan satu-satunya rute yang memungkinkan Anda mengarahkan CLI ke provider lain — atau bahkan ke keluarga model yang sepenuhnya berbeda. Panduan ini membahas konfigurasi yang berfungsi, satu persyaratan yang paling sering menyulitkan gateway, dan biaya nyata satu sesi.

Satu persyaratan yang penting

Codex CLI lebih ketat terhadap endpoint khusus dibandingkan sebagian besar tool. Blok model_providers memiliki kunci wire_api, dan hanya menerima satu nilai: responses. Artinya, provider khusus harus menyediakan Responses API OpenAI di POST /v1/responses — bukan /v1/chat/completions yang jauh lebih umum. Sebagian besar gateway yang kompatibel dengan OpenAI hanya menyediakan yang terakhir, sehingga banyak gateway tidak dapat menggerakkan Codex CLI sama sekali, apa pun base_url yang Anda berikan.

Kunavo menyediakan kedua permukaan, jadi konfigurasi di bawah berfungsi sebagaimana ditulis.

Konfigurasi

Codex membaca ~/.codex/config.toml. Dua kunci tingkat atas memilih model dan provider; blok provider menjelaskan cara mengaksesnya:

# ~/.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"
wire_api = "responses"

Perhatikan apa yang tidak ada dalam file tersebut: kuncinya sendiri. env_key menamai variabel lingkungan, dan Codex membaca kunci dari sana saat dijalankan — sehingga file konfigurasi tetap aman untuk di-commit atau dibagikan.

# Codex reads the key from the variable named by env_key.
export KUNAVO_API_KEY="sk-kn-..."     # create at kunavo.com/app/keys

# Persist it (pick the file your shell actually loads):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explain the structure of this repository"

Buat kunci di dashboard setelah mendaftar dan mengisi ulang $10. Kunci hanya ditampilkan sekali, jadi simpan segera. Jika codex sudah berjalan di shell lain, mulai ulang — variabel dibaca saat dijalankan, bukan pada setiap permintaan.

Verifikasi sebelum melakukan debugging

Jika ada masalah, cari tahu apakah penyebabnya kunci, endpoint, atau CLI. Satu permintaan sudah cukup untuk memastikannya:

# Confirm the key and the endpoint before blaming Codex.
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-6-sol",
    "input": "Say OK and nothing else."
  }'

Respons JSON berarti kunci dan endpoint sudah benar, dan masalah yang tersisa berada pada config.toml. 401 berarti kuncinya salah atau variabelnya kosong di shell ini. 404 pada model berarti slug tidak cocok dengan katalog.

Model yang harus ditetapkan

Nilai model hanyalah slug pada endpoint yang sama, jadi penggantian model cukup dilakukan dengan mengubah satu kata — tanpa kunci baru, tanpa blok provider baru.

gpt-5-6-sol adalah GPT yang disesuaikan untuk coding dan default alami untuk CLI ini, dengan harga $2,00 / $12,00 per 1M token dibandingkan harga daftar OpenAI sebesar $5,00 / $30,00 — meskipun OpenAI saat ini mengenakan harga promosi $4,00 / $20,00, yang tersedia setidaknya hingga 21 November 2026. Tarif lengkap untuk setiap model tersedia di halaman harga.

Menjalankan model Claude di Codex CLI

Hal ini mengejutkan banyak orang: Codex CLI terikat pada protokol, bukan model. Codex berbicara dalam format wire Responses, dan model chat apa pun yang berada di balik endpoint tersebut dapat menjawab. Arahkan ke claude-opus-5 dan Codex berjalan end-to-end — termasuk tool call, sehingga agen tetap membaca file, mengusulkan perubahan, dan menjalankan perintah seperti biasa.

# Same provider block, different model — no new key, no new config.
model          = "claude-opus-5"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"
wire_api = "responses"

Gateway menerjemahkan permintaan Responses menjadi Anthropic Messages API dan balasannya kembali ke bentuk Responses. Satu catatan penting: Codex mengirim item reasoning yang hanya dapat dikonsumsi oleh model native Responses, dan item tersebut dihapus saat diteruskan ke upstream non-GPT. Model kehilangan scratchpad pribadinya dari giliran sebelumnya; transkrip yang terlihat dan menjadi dasar kerjanya tetap utuh. Dalam praktiknya, hal ini sedikit mengurangi kesinambungan pada rangkaian penalaran panjang, tetapi tidak berdampak sama sekali pada loop edit-jalankan-perbaiki biasa.

Apakah ini ide yang baik merupakan pertanyaan terpisah dari apakah ini berfungsi. Jika Anda menginginkan Claude secara khusus, Claude Code dibuat untuk itu dan meneruskan cache_control tanpa terjemahan. Namun, jika Anda lebih menyukai sandboxing Codex CLI dan ingin Claude berada di baliknya, kombinasi tersebut tersedia.

Biaya sebuah sesi

CLI agentik mengirim ulang prompt sistem, riwayat tugas, dan konteks berkas terbaru pada setiap langkah, sehingga token bertambah lebih cepat daripada yang ditunjukkan jumlah langkah. Satu langkah umumnya menggunakan sekitar 25.000 token input dan 1.200 token output:

Karena tarif output berbeda jauh lebih besar antar-keluarga model daripada tarif input, pekerjaan yang berat di output dapat mengubah peringkat — masukkan angka Anda sendiri ke kalkulator biaya alih-alih mempercayai satu contoh perhitungan. Permintaan yang gagal tidak dikenai biaya.

Saat rute kunci API lebih unggul daripada langganan

Paket ChatGPT menggabungkan penggunaan Codex dengan tarif bulanan tetap; kunci API hanya menagih apa yang Anda jalankan. Rute kunci unggul ketika Anda menulis kode secara berkala, bukan setiap hari, ketika Anda menginginkan batas pengeluaran per kunci dan visibilitas penggunaan alih-alih jatah yang tidak transparan, atau ketika Anda menginginkan model yang tidak ditawarkan oleh langganan. Rute ini kalah ketika Anda adalah pengguna berat sehari-hari — pada volume tersebut, tarif tetap sulit dikalahkan. Kedua rute tidak saling eksklusif: profil Codex memungkinkan Anda mempertahankan keduanya dan beralih untuk setiap tugas.

Pemecahan masalah

Pertanyaan umum