Tutorial Codex — menginstal Codex CLI, menggunakan API key tanpa berlangganan, dan biaya per tugas

Codex adalah agen pemrograman AI (coding agent) dari OpenAI. Cara paling dasar menggunakannya adalah menginstal Codex CLI yang dijalankan di terminal (npm install -g @openai/codex), menjalankan codex di folder proyek yang ingin ditangani, lalu memberitahunya dalam bahasa Indonesia apa yang harus dilakukan. Ada dua cara untuk memulai: masuk dengan paket ChatGPT (Plus, Pro, Business, dan sebagainya) dan menggunakan kuota paket; atau menjalankannya dengan kunci API dan membayar sesuai jumlah token. Hampir semua tutorial berbahasa Mandarin hanya membahas cara pertama; artikel ini melengkapi cara kedua — konfigurasi untuk menjalankan Codex CLI tanpa langganan, pemilihan model berdasarkan tugas, dan biaya nyata suatu tugas.

Codex bukan alat untuk menempelkan kode ke jendela chat, melainkan agen yang membaca file, mengubah file, menjalankan pengujian, dan mengeksekusi perintah di dalam proyek. Atur tindakan yang boleh dilakukan tanpa konfirmasi langsung setelah memulai menggunakan /permissions.

Dua cara menggunakan Codex

Saat dijalankan dengan kunci API, biaya dihitung terpisah dari kuota paket ChatGPT. Anda juga dapat langsung menggunakan kunci API OpenAI, tetapi artikel ini membahas koneksi ke endpoint yang kompatibel dengan Responses API: satu kunci yang sama dapat digunakan untuk berpindah antara GPT-6 Astra dan GPT-5.6 Terra. Misalnya, harga resmi OpenAI untuk GPT-5.6 Sol adalah $5,00 / $30,00(OpenAI saat ini menawarkan dengan harga promosi $4,00 / $20,00, dan halaman harga resmi menyatakan setidaknya hingga 21 November 2026); di sini harganya per 1 juta token adalah $2,00 / $12,00 (tarif dibaca langsung dari katalog kami, bukan dimasukkan secara manual).

Menginstal Codex CLI — npm atau Homebrew

# npm（有 Node.js 就能用，macOS / Linux / Windows 通用）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Keduanya adalah metode instalasi yang tercantum dalam README resmi OpenAI, dan Windows juga dapat menggunakan perintah npm yang sama. Setelah terpasang, masukkan codex di folder proyek untuk memulainya. Jika Anda berencana masuk dengan ChatGPT, proses selesai sampai di sini dan pengaturan di bawah dapat dilewati.

Menjalankan dengan kunci API — tambahkan satu blok ke config.toml

Pertama, daftar akun, isi saldo mulai $10, lalu buka halaman kunci API untuk membuat kunci. Kunci hanya ditampilkan sekali, jadi segera simpan. Selanjutnya, tambahkan blok provider ke file konfigurasi Codex:

# ~/.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"        # 唯一有效的值，省略也一樣

Bagian yang paling mudah salah adalah env_key: yang diisi di sini bukan kunci API, melainkan nama variabel lingkungan tempat kunci disimpan. Kunci tidak muncul di file konfigurasi, sehingga config.toml aman untuk di-commit ke git atau ditempelkan di forum saat meminta bantuan.

# 把金鑰放進 env_key 指定名稱的變數（金鑰以 sk-kn- 開頭）
export KUNAVO_API_KEY="sk-kn-..."

# 寫進 shell 的設定檔，就不必每次都 export
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Di PowerShell Windows, jalankan setx KUNAVO_API_KEY sk-kn-..., lalu buka terminal baru; lokasi file konfigurasi adalah %USERPROFILE%\.codex\config.toml. Sebelum memulai Codex, lakukan satu permintaan untuk memastikan kunci dan endpoint berfungsi; ini memudahkan penentuan sumber masalah ketika terjadi error.

# 懷疑 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": "只回 OK"}'

Jika mengembalikan JSON, berarti kunci dan endpoint berfungsi normal; masalah yang tersisa ada di config.toml. Penjelasan setiap kolom konfigurasi tersedia dalam dokumentasi integrasi Codex CLI (bahasa Inggris); cara memanggil model Claude dari dalam Codex juga dijelaskan dalam panduan kunci API Codex CLI (bahasa Inggris).

Tugas pertama

# 1. 進到要處理的專案資料夾，啟動 Codex
cd ~/work/my-app
codex

# 2. 讓它產生 AGENTS.md 草稿（寫測試怎麼跑、專案規則的檔案）
> /init

# 3. 之後直接用中文交代。附上檔名，做得更快也更省
> src/utils/date.test.ts 一直失敗，找出原因修好，並確認測試通過

/init menghasilkan AGENTS.md yang digunakan untuk menulis “aturan yang tidak terlihat hanya dari kode” — cara menjalankan pengujian, library yang digunakan, dan path yang tidak boleh diubah — yang kemudian dibaca otomatis pada setiap sesi kerja. Hasilnya hanya draf; pastikan Anda meninjaunya dan mengubahnya sendiri.

Tips memberi perintah sama seperti pada Claude Code: sertakan nama file dan path, dan jangan memberikan tugas besar sekaligus. Token yang digunakan untuk eksplorasi berkurang, hasil lebih cepat dan akurat, dan tagihan ikut turun.

Pilih model berdasarkan tugas — biaya nyata satu tugas

Keuntungan terbesar menjalankan dengan kunci API adalah dapat memilih model sesuai tingkat kesulitan pekerjaan. model hanyalah nama model pada endpoint; mengganti model tidak memerlukan kunci baru atau konfigurasi tambahan.

# config.toml 的預設（gpt-5-6-sol）不動，只有這次啟動換模型
codex -m gpt-6-astra     # 找不到原因的 bug、跨模組的修改
codex -m gpt-5-6-terra   # 例行修改、大量取代、整理日誌這類輕量工作

Perhitungan “satu tugas” menganggap perbaikan satu pengujian yang gagal sebagai 20 langkah. Setiap langkah menggunakan 25.000 token input (prompt sistem + riwayat percakapan + file yang dibaca) dan 1.200 token output (satu perubahan atau penjelasan), sehingga satu tugas menggunakan 500.000 token input dan 24.000 token output. Dengan GPT-5.6 Sol, biayanya sekitar $1,29; jumlah token yang sama jika langsung dibayar ke OpenAI, dengan harga promosi saat ini adalah $2,48 (harga standar $3,22). Model yang lebih murah mungkin perlu beberapa putaran tambahan agar benar; dalam praktiknya, jika satu percobaan belum menyelesaikan masalah, naikkan model satu tingkat.

Perhitungan ini tidak memasukkan cache. Codex mengirim ulang riwayat percakapan pada setiap langkah; input yang terkena cache dikenai 0,10 kali harga input (GPT-5.6 Sol sebesar $0,20 per 1 juta token), sedangkan bagian yang baru ditulis ke cache dikenai 1,25 kali harga input. Selain itu, untuk seri GPT-5.6 dan GPT-6 Astra, ketika prompt dalam satu permintaan melebihi 272K token, seluruh permintaan dikenai 2 kali harga input dan 1,5 kali harga output. Karena itu, jangan memasukkan terlalu banyak pekerjaan dalam satu sesi; lebih aman memulai ulang satu kali untuk setiap tugas. Token penalaran dikenai tarif output; semakin sulit tugasnya, semakin banyak output yang dihasilkan. Untuk biaya aktual, lihat usage dan catatan penggunaan dalam respons. Spesifikasi model tersedia di halaman model GPT-5.6 Sol, dan tarif semua model tersedia di tabel harga.

Error umum

Terus terang — kapan paket ChatGPT lebih hemat

Jika Anda menghabiskan beberapa jam setiap hari untuk bolak-balik dengan Codex, paket dengan biaya bulanan tetap biasanya lebih murah. Penagihan sesuai pemakaian sebanding dengan penggunaan token; semakin banyak dan semakin stabil pemakaian, semakin besar keuntungan biaya bulanan. Titik impasnya adalah “biaya bulanan ÷ harga satu tugas”, dan titik impas antar paket sudah dihitung di halaman biaya Codex.

Ada dua hal lain yang perlu diketahui terlebih dahulu. Menurut dokumentasi OpenAI, fitur yang bergantung pada workspace ChatGPT atau layanan cloud akan dibatasi atau tidak tersedia ketika menggunakan kunci API. Selain itu, jalur Kunavo menggunakan kapasitas bersama, tanpa kuota khusus dan tanpa SLA yang dijamin kontrak; jika memerlukan kuota atau SLA yang terjamin, lebih tepat menandatangani kontrak langsung dengan OpenAI.

Sebaliknya, kunci API cocok untuk orang dengan penggunaan yang naik-turun, yang ingin memilih model berdasarkan tugas, tim yang ingin memisahkan batas dan catatan penggunaan berdasarkan kunci, serta siapa pun yang hanya ingin terus bekerja pada hari ketika kuota paket habis. Keduanya dapat digunakan bersama: hapus baris model_provider dari config.toml untuk kembali ke login ChatGPT; jika ingin berganti setiap kali memulai, gunakan --profile Codex.

Pembayaran menggunakan kartu kredit internasional (termasuk JCB), Apple Pay, atau Google Pay; Taiwan tidak memiliki metode pembayaran lokal — JKO Pay dan LINE Pay tidak termasuk dalam daftar yang tersedia. Sistem prabayar hanya menagih kartu sekali saat pengisian, saldo tidak kedaluwarsa, dan permintaan yang gagal tidak dikenai biaya. Jika Anda masih ragu antara Codex dan Claude Code, lihat Claude Code vs Codex CLI (bahasa Inggris); cara penghitungan biaya Claude Code dijelaskan di Biaya Claude Code.

Pertanyaan umum