Codex CLI dengan kunci API — konfigurasi, model, dan biaya sesi

Codex CLI adalah agen kode terminal open source dari OpenAI, dan dapat berjalan baik dengan login ChatGPT maupun kunci API. Jalur kunci API adalah yang penting untuk dipahami: penagihan berdasarkan token, tanpa biaya bulanan, dan merupakan satu-satunya jalur yang memungkinkan Anda mengarahkan CLI ke provider lain — atau keluarga model lain. Panduan ini mencakup konfigurasi yang berfungsi, persyaratan yang menjatuhkan sebagian besar gateway, biaya satu sesi, dan cara membayar dari Brasil melalui Pix.

Satu-satunya persyaratan yang penting

Codex CLI berbicara dengan Responses API OpenAI, dan hanya itu: blok model_providers hanya menerima wire_api = "responses". Gateway yang hanya menawarkan /v1/chat/completions sama sekali tidak dapat dikonfigurasi — itulah sebabnya banyak endpoint yang “kompatibel dengan OpenAI” gagal di sini. Kunavo menyediakan POST /v1/responses bersama endpoint chat, sehingga blok di bawah ini berfungsi tanpa penyesuaian.

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"
wire_api = "responses"

env_key adalah nama variabel lingkungan, bukan kuncinya: Codex tidak pernah menyimpan kunci di berkas konfigurasi.

# O Codex lê a chave da variável indicada em env_key.
export KUNAVO_API_KEY="sk-kn-..."     # crie em kunavo.com/app/keys

# Deixe persistente (escolha o arquivo que o seu shell realmente carrega):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explique a estrutura deste repositório"

Buat kunci di dashboard setelah mendaftar dan mengisi ulang $10 — kunci tersebut hanya ditampilkan sekali.

Membayar dari Brasil — Pix, tanpa kartu internasional

Bagi pengembang Brasil, hambatannya jarang berupa berkas TOML; biasanya metode pembayarannya. Membayar OpenAI API secara langsung memerlukan kartu kredit internasional yang diaktifkan untuk pembelian luar negeri. Di Kunavo, checkout diproses melalui Stripe dan Pix muncul sebagai metode pembayaran bagi mereka yang membayar dari Brasil — jumlah dalam real dan kompensasi segera. Kartu internasional (Visa, Mastercard, American Express), Apple Pay, dan Google Pay tetap tersedia bagi yang menginginkannya.

Tarif per token ditetapkan dalam USD: dengan Pix, Stripe menampilkan konversi ke real saat pembayaran; dengan kartu, konversi mengikuti nilai tukar penerbit kartu (periksa IOF dan biaya transaksi internasional di aplikasi bank) — langkah-langkah pengisian ulang melalui Pix tersedia di panduan cara membayar API dengan Pix. Dompet ini prabayar — pengisian ulang minimum $10, tanpa langganan dan tanpa perpanjangan otomatis, dengan saldo yang tidak pernah kedaluwarsa.

Model mana yang digunakan

gpt-5-6-sol adalah GPT yang disesuaikan untuk kode dan pilihan bawaan yang wajar untuk CLI ini, dengan harga $2,00 / $12,00 per 1M token dibandingkan dengan $5,00 / $30,00 pada harga daftar OpenAI — yang saat ini mengenakan harga promosi $4,00 / $20,00, tersedia setidaknya hingga 21 November 2026 menurut halaman harga. Tarif lengkap tersedia di halaman harga.

Menjalankan model Claude di Codex CLI

Ini biasanya mengejutkan: Codex CLI terikat pada protokol, bukan model. Codex menggunakan format Responses, dan model chat apa pun di balik endpoint tersebut dapat merespons. Arahkan ke claude-opus-5 dan semuanya berjalan dari ujung ke ujung — termasuk pemanggilan alat, sehingga agen tetap dapat membaca berkas, mengusulkan pengeditan, dan menjalankan perintah.

# Mesmo bloco de provider, outro modelo — sem chave nova, sem config nova.
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 ke API native Anthropic Messages dan menerjemahkan kembali respons ke format Responses. Catatan penting: Codex mengirim item reasoning opak yang hanya dapat digunakan oleh model native Responses, dan item tersebut dibuang saat diteruskan ke upstream yang bukan GPT. Model kehilangan draf privat dari giliran sebelumnya; transkrip yang terlihat sebagai titik awalnya tetap utuh. Dalam praktiknya, hal ini sedikit mengurangi kesinambungan dalam rangkaian penalaran panjang, tetapi tidak memengaruhi loop umum edit-jalankan-perbaiki.

Jika Anda menginginkan Claude secara khusus, Claude Code dibuat untuk itu dan meneruskan cache_control tanpa terjemahan. Namun, jika Anda lebih menyukai sandbox Codex CLI dan ingin menjalankan Claude di baliknya, kombinasi tersebut tersedia.

Berapa biaya satu sesi

CLI agentic mengirim ulang system prompt, riwayat tugas, dan konteks berkas pada setiap langkah, sehingga token terakumulasi lebih cepat daripada yang disiratkan oleh jumlah langkah. Satu langkah tipikal memiliki sekitar 25.000 token input dan 1.200 token output:

Artinya, pengisian ulang $10 melalui Pix mencukupi untuk sekitar 8 tugas agentic yang terdiri dari 20 langkah. Dan permintaan yang gagal tidak ditagihkan — 5xx di tengah sesi tidak berubah menjadi baris pada tagihan.

Jika sesuatu tidak berfungsi

Sebelum menyalahkan Codex, buktikan bahwa kunci dan endpoint merespons:

# Confirme a chave e o endpoint antes de culpar o 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": "Responda OK e nada mais."
  }'

• 404 — provider tidak mengimplementasikan /v1/responses, atau base_url sudah menyertakan /responses. Codex menambahkan jalur tersebut sendiri: base diakhiri dengan /v1.
• 401 — variabel yang ditentukan dalam env_key kosong di shell yang membuka Codex. Periksa dengan echo $KUNAVO_API_KEY di terminal yang sama.
• 402 — saldo tidak mencukupi: isi ulang di billing (Pix masuk langsung).
• model_not_found — slug model tidak ada dalam katalog; periksa di /models.

Pertanyaan yang sering diajukan