Cara menggunakan Codex — dari instalasi hingga menjalankannya dengan kunci API tanpa langganan

Codex adalah agen coding dari OpenAI. Cara dasar menggunakannya adalah menginstal Codex CLI yang berjalan di terminal (npm install -g @openai/codex), menjalankan codex di repositori yang ingin Anda kerjakan, lalu memberikan instruksi dalam bahasa Jepang. Ada dua cara untuk memulai: masuk dengan paket ChatGPT (Plus, Pro, Business, dan sebagainya) dan menggunakannya dalam kuota, atau menjalankannya dengan kunci API dan membayar token yang digunakan. Karena sebagian besar artikel penjelasan berbahasa Jepang hanya membahas metode pertama, halaman ini menjelaskan metode kedua secara berurutan — konfigurasi untuk menjalankan Codex CLI tanpa langganan, cara memilih model per tugas, dan biaya aktual satu tugas.

Codex bukan alat untuk menempelkan kode ke layar chat, melainkan agen yang membaca dan mengubah file di dalam repositori serta menjalankan tes dan perintah. Setelah dijalankan, Anda dapat menentukan sejauh mana agen boleh bekerja tanpa konfirmasi menggunakan /permissions.

Dua cara menggunakan Codex

Jika dijalankan dengan kunci API, penagihan dihitung terpisah dari kuota paket OpenAI. Anda dapat menggunakan kunci API OpenAI secara langsung, tetapi halaman ini membahas cara mengarahkan Codex ke endpoint yang kompatibel dengan Responses API. Anda dapat beralih dengan kunci yang sama dari GPT-6 Astra hingga GPT-5.6 Terra; misalnya, GPT-5.6 Sol dikenai $2,00 / $12,00 per 1M token, dibandingkan dengan harga daftar OpenAI sebesar $5,00 / $30,00(OpenAI saat ini menawarkan dengan harga promosi $4,00 / $20,00. Menurut halaman harga, setidaknya hingga 21 November 2026) (tarif dimuat langsung dari katalog).

Instalasi — npm atau Homebrew

# npm（Node.js が入っていれば macOS / Linux / Windows 共通）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Keduanya merupakan metode yang tercantum dalam README resmi OpenAI. Di Windows pun instalasi dapat dilakukan dengan perintah npm. Setelah instalasi selesai, jalankan dengan mengetik codex di direktori repositori yang ingin Anda kerjakan. Jika masuk dengan ChatGPT, Anda selesai di sini dan tidak memerlukan konfigurasi selanjutnya.

Menjalankan dengan kunci API — satu blok di config.toml

Pertama, buat akun, isi saldo mulai dari $10, lalu buat kunci di halaman kunci API. Kunci hanya ditampilkan satu kali, jadi segera catat. Berikutnya, tulis satu blok penyedia di 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 keliru adalah env_key. Yang harus ditulis adalah nama variabel lingkungan tempat kunci disimpan, bukan kuncinya sendiri. Karena kunci tidak masuk ke file konfigurasi, config.toml aman untuk dikomit atau ditempelkan dalam pertanyaan.

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Di PowerShell Windows, jalankan setx KUNAVO_API_KEY sk-kn-..., lalu buka kembali terminal baru. Lokasi file konfigurasi adalah %USERPROFILE%\.codex\config.toml. Sebelum menjalankan Codex, pastikan kunci dan endpoint benar dengan satu permintaan agar pemecahan masalah berikutnya lebih mudah.

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
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 JSON dikembalikan, kunci dan endpoint sudah benar; jika masih ada masalah, kemungkinan masalahnya berada di sisi config.toml. Detail item konfigurasi tersedia dalam dokumentasi integrasi Codex CLI (bahasa Inggris), sedangkan penjelasan termasuk cara memanggil model Claude dari Codex tersedia dalam panduan konfigurasi kunci API Codex CLI (bahasa Inggris).

Tugas pertama

# 1. 作業したいリポジトリに入って起動する
cd ~/work/my-app
codex

# 2. AGENTS.md の雛形を作らせる（テストの実行方法や決めごとを書くファイル）
> /init

# 3. あとは日本語で頼む。ファイル名を添えるほど速く、安く終わる
> src/utils/date.test.ts が落ちている。原因を調べて直し、テストが通るのを確認して

/init membuat AGENTS.md, yaitu file untuk mencatat “aturan yang tidak dapat diketahui hanya dengan membaca kode”, seperti cara menjalankan tes, pustaka yang digunakan, dan path yang tidak boleh disentuh. File ini otomatis dimuat pada sesi berikutnya. Konten yang dihasilkan masih berupa draf, jadi perbaiki secara manual.

Kiat pemberian instruksi sama seperti Claude Code: sertakan nama file dan path, serta jangan mengirim permintaan besar sekaligus. Karena token yang digunakan untuk eksplorasi berkurang, hasilnya lebih cepat dan akurat, dan jumlah tagihannya juga lebih rendah. Frekuensi dialog konfirmasi dapat diatur dengan /permissions. Pengoperasian Claude Code dirangkum dalam cara menggunakan Claude Code.

Memilih model per tugas — biaya aktual satu tugas

Keuntungan terbesar menjalankan dengan kunci API adalah Anda dapat memilih model sesuai tingkat kesulitan pekerjaan. model hanyalah nama model pada endpoint, sehingga Anda tidak perlu menambahkan kunci atau konfigurasi untuk beralih.

# config.toml の既定（gpt-5-6-sol）はそのまま、この起動だけモデルを変える
codex -m gpt-6-astra     # 原因の見えないバグ、設計をまたぐ変更
codex -m gpt-5-6-terra   # 定型の修正、一括置換、ログの要約などの軽い作業

“Satu tugas” dihitung sebagai 20 langkah untuk memperbaiki satu tes yang gagal. Satu langkah terdiri dari 25.000 token input (system prompt + riwayat percakapan + file yang dibaca) dan 1.200 token output (satu pengeditan atau penjelasan), sehingga satu tugas menggunakan 500.000 token input dan 24.000 token output. Dengan GPT-5.6 Sol, biayanya $1,29; jika jumlah token yang sama dibayar langsung ke OpenAI, biayanya $2,48 dengan harga promosi saat ini (atau $3,22 dengan harga daftar). Model yang lebih murah dapat meningkatkan jumlah bolak-balik karena perbaikan ulang, jadi pendekatan praktisnya adalah naik satu tingkat jika pekerjaan tidak selesai dalam satu percobaan.

Perhitungan ini tidak memperhitungkan caching. Codex mengirim ulang riwayat percakapan pada setiap langkah, sehingga input yang telah masuk cache ditagih 0,10 kali harga input (GPT-5.6 Sol berarti $0,20 per 1M token), sedangkan bagian yang baru ditulis ke cache ditagih 1,25 kali harga input. Selain itu, pada seri GPT-5.6 dan GPT-6 Astra, jika prompt satu permintaan melebihi 272K token, seluruh permintaan tersebut ditagih dengan input 2 kali dan output 1,5 kali. Agar aman, jangan memadatkan terlalu banyak pekerjaan dalam satu sesi; jalankan ulang untuk setiap tugas. Token penalaran model reasoning ditagih sebagai output, sehingga tugas yang sulit juga meningkatkan output. Periksa biaya aktual melalui usage dalam respons dan riwayat penggunaan. Spesifikasi model tersedia di halaman model GPT-5.6 Sol, dan harga per unit semua model tersedia di tabel harga.

Error umum

Sejujurnya — kapan paket ChatGPT lebih hemat

Jika Anda bekerja berjam-jam setiap hari sambil berinteraksi dengan Codex, paket berbiaya tetap biasanya lebih murah. Penagihan sesuai penggunaan berbanding lurus dengan jumlah token, sehingga manfaat paket tetap semakin besar bagi pengguna dengan volume tinggi dan stabil. Titik impasnya adalah “biaya bulanan ÷ harga satu tugas”, dan titik impas terhadap paket dihitung di harga Codex.

Ada dua hal lain yang perlu diketahui. Menurut dokumentasi OpenAI, fitur yang bergantung pada workspace atau cloud ChatGPT dibatasi atau tidak tersedia saat menggunakan kunci API. Selain itu, rute Kunavo menggunakan kapasitas bersama dan tidak memiliki kuota khusus maupun SLA kontraktual. Jika memerlukan kapasitas atau SLA yang terjamin, kontrak langsung dengan OpenAI lebih sesuai.

Sebaliknya, kunci API cocok bagi pengguna yang perbedaan antara hari penggunaan dan hari tanpa penggunaan besar, ingin memilih model per tugas, ingin memisahkan batas dan riwayat penggunaan per kunci dalam tim, atau ingin terus bekerja hanya pada hari ketika kuota paket habis. Keduanya dapat digunakan bersama. Hapus baris model_provider dari config.toml untuk kembali ke login ChatGPT, dan gunakan --profile Codex jika ingin berganti pada setiap peluncuran.

Pembayaran dapat dilakukan dengan kartu (termasuk JCB), Apple Pay, Google Pay, dan lainnya; saldo tidak memiliki masa berlaku. Pembayaran di minimarket dan PayPay tidak didukung. Request yang gagal tidak dikenai biaya. Jika Anda bingung memilih antara Codex dan Claude Code, lihat perbandingan Codex dan Claude Code.

Pertanyaan yang sering diajukan