Cara menggunakan Codex — dari instalasi hingga penggunaan dengan kunci API tanpa langganan, termasuk biaya nyata satu tugas

Codex adalah agen coding dari OpenAI. Cara dasar penggunaannya adalah memasang Codex CLI yang berjalan di terminal (npm install -g @openai/codex), menjalankan codex di repositori yang akan dikerjakan, lalu menyampaikan permintaan dalam bahasa Korea. Ada dua cara untuk memulai: masuk dengan paket ChatGPT (Plus · Pro · Business, dan lainnya) dan menggunakannya dalam batas penggunaan, atau menjalankannya dengan kunci API dan hanya membayar token yang digunakan. Karena hampir semua panduan penggunaan di Korea Selatan hanya membahas cara pertama, artikel ini secara berurutan merangkum cara kedua—pengaturan untuk menjalankan Codex CLI tanpa langganan, cara memilih model untuk setiap tugas, dan biaya nyata satu tugas. Batas penggunaan per paket dan pilihan setelah batas habis dirangkum terpisah di Batas penggunaan Codex.

Codex bukan alat untuk menempelkan kode ke jendela chat, melainkan agen yang membaca dan mengubah file di dalam repositori serta menjalankan tes dan perintah. Setelah dijalankan, Anda dapat menentukan apa yang dipercayakan tanpa konfirmasi melalui /permissions.

Dua cara menggunakan Codex

Jika dijalankan dengan kunci API, biaya dihitung terpisah dari penggunaan paket ChatGPT. Anda juga dapat menggunakan kunci API OpenAI secara langsung, tetapi artikel ini membahas cara terhubung ke endpoint yang kompatibel dengan Responses API. Kunci yang sama dapat digunakan untuk beralih di antara model dari GPT-6 Astra hingga GPT-5.6 Terra. Contohnya, GPT-5.6 Sol berharga $2,00 / $12,00 per 1 juta token, dibandingkan dengan harga resmi OpenAI sebesar $5,00 / $30,00. (OpenAI saat ini menawarkan dengan harga promosi $4,00 / $20,00, dan menurut halaman harga, harga ini berlaku setidaknya hingga 21 November 2026) (Tarif diambil langsung dari katalog.)

Pemasangan Codex — npm atau Homebrew

# npm (Node.js만 있으면 macOS / Linux / Windows 공통)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

Kedua metode tersebut adalah metode pemasangan yang tercantum di README resmi OpenAI. Di Windows juga dapat dipasang dengan perintah npm. Setelah pemasangan selesai, jalankan dengan mengetik codex di direktori repositori yang akan dikerjakan. Jika Anda akan masuk dengan ChatGPT, proses selesai di sini dan pengaturan di bawah tidak diperlukan.

Mendapatkan dan mengatur kunci API Codex — satu blok config.toml

Pertama, buat akun dan isi saldo mulai dari $10, lalu buat kunci di layar kunci API. Kunci hanya ditampilkan sekali, jadi segera simpan. Setelah itu, tambahkan satu blok provider ke file pengaturan 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 sering keliru adalah env_key. Yang ditulis di sini adalah nama variabel lingkungan yang akan menyimpan kunci, bukan kunci itu sendiri. Karena kunci tidak masuk ke file konfigurasi, config.toml aman untuk di-commit atau ditempelkan dalam pertanyaan.

# env_key에 적은 이름의 변수에 키를 넣습니다 (키는 sk-kn-으로 시작)
export KUNAVO_API_KEY="sk-kn-..."

# 매번 export하지 않도록, 쓰는 셸의 설정 파일에 추가해 둡니다
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Jika menggunakan Windows PowerShell, jalankan setx KUNAVO_API_KEY sk-kn-... lalu buka terminal baru. Lokasi file pengaturan adalah %USERPROFILE%\.codex\config.toml. Sebelum menjalankan Codex, periksa kunci dan endpoint dengan satu permintaan; hal ini memudahkan pemisahan masalah.

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
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 normal, sehingga masalah yang tersisa berada di sisi config.toml. Item pengaturan tersedia di Dokumentasi integrasi Codex CLI (bahasa Inggris), sedangkan penjelasan yang juga mencakup cara memanggil model Claude dari Codex tersedia di Panduan 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 yang dibuat oleh AGENTS.md adalah file yang mencatat “aturan yang tidak dapat diketahui hanya dengan membaca kode”, seperti cara menjalankan tes, library yang digunakan, dan jalur yang tidak boleh disentuh; file ini akan dibaca otomatis pada sesi berikutnya. Karena konten yang dihasilkan masih berupa draf, sempurnakan secara manual.

Cara menyusun permintaan sama seperti pada Claude Code: sertakan jalur file dan jangan melemparkan tugas besar sekaligus. Token yang digunakan untuk eksplorasi berkurang, sehingga hasil lebih cepat dan akurat, dan jumlah tagihan juga turun. Cara mengoperasikan Claude Code dirangkum di Cara menggunakan Claude Code.

Memilih model untuk setiap tugas — biaya nyata satu tugas

Keuntungan terbesar menjalankan dengan kunci API adalah Anda dapat memilih model sesuai beban tugas. model hanyalah nama model pada endpoint, sehingga penggantiannya tidak memerlukan kunci baru atau pengaturan tambahan.

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

“Satu tugas” dihitung sebagai pekerjaan memperbaiki satu tes yang gagal dalam 20 langkah. Satu langkah terdiri dari 25.000 token input (prompt sistem + riwayat percakapan + file yang dibaca) dan 1.200 token output (satu perubahan atau penjelasan), sehingga satu tugas berjumlah 500.000 token input · 24.000 token output. Jika GPT-5.6 Sol, maka $1,29, jika jumlah token yang sama dibayar langsung ke OpenAI, dengan harga promosi saat ini $2,48 (dengan harga resmi $3,22). Model yang lebih murah dapat memerlukan lebih banyak bolak-balik karena perbaikan harus diulang, jadi jika tidak selesai sekali jalan, menaikkan satu tingkat adalah pendekatan yang realistis. Untuk memasukkan jumlah token Anda sendiri dan menghitungnya, gunakan kalkulator biaya.

Perhitungan ini tidak memperhitungkan cache. Codex mengirim ulang riwayat percakapan pada setiap langkah, sehingga input yang sudah masuk cache ditagihkan sebesar 0.10 kali tarif input (untuk GPT-5.6 Sol sebesar $0,20 per 1 juta token), sedangkan bagian yang baru ditulis ke cache ditagihkan sebesar 1.25 kali tarif input. Selain itu, pada GPT-5.6 dan GPT-6 Astra, jika prompt satu permintaan melebihi 272K token, seluruh permintaan tersebut ditagihkan dengan input 2 kali lipat · output 1.5 kali lipat. Jangan memasukkan terlalu banyak tugas ke dalam satu sesi; lebih aman memulai eksekusi baru untuk setiap tugas. Token penalaran pada model penalaran ditagihkan sebagai output, sehingga output juga meningkat untuk tugas yang sulit. Jumlah aktual dapat diperiksa pada usage dan rincian penggunaan dalam respons. Spesifikasi model tersedia di halaman model GPT-5.6 Sol, tarif lengkap di tabel harga, dan tabel perbandingan tarif token model GPT yang digunakan Codex tersedia di Harga API GPT.

Kesalahan yang sering terjadi

Secara jujur — kapan paket ChatGPT lebih baik

Jika Anda bekerja sambil berbicara dengan Codex selama beberapa jam setiap hari, paket tetap umumnya lebih murah. Penagihan sesuai penggunaan berbanding lurus dengan jumlah token, sehingga semakin tinggi dan konsisten penggunaan, semakin besar keuntungan paket tetap. Patokannya adalah “biaya bulanan ÷ biaya satu tugas”, dan titik impas dibandingkan paket telah dihitung di Harga Codex.

Ada dua hal lain yang perlu diketahui. Menurut dokumentasi OpenAI, fitur yang bergantung pada workspace ChatGPT atau cloud dibatasi atau tidak dapat digunakan saat menggunakan kunci API. Selain itu, jalur Kunavo menggunakan kapasitas bersama, sehingga tidak ada kuota khusus maupun SLA kontraktual. Jika Anda memerlukan batas atau SLA yang dijamin, sebaiknya membuat kontrak langsung dengan OpenAI.

Sebaliknya, kunci API cocok bagi orang yang perbedaan antara hari penggunaan dan hari tanpa penggunaan sangat besar, yang ingin memilih model untuk setiap tugas, yang ingin membagi batas dan rincian penggunaan berdasarkan kunci dalam tim, atau yang hanya ingin melanjutkan pekerjaan pada hari ketika batas paket habis. Keduanya dapat digunakan bersama. Hapus baris model_provider pada config.toml untuk kembali ke login ChatGPT; jika ingin menggantinya setiap kali menjalankan, gunakan --profile Codex.

Pengisian saldo Kunavo dilakukan dengan kartu, Apple Pay, Google Pay, dan lainnya. Jika checkout ditampilkan dalam won, KakaoPay, Naver Pay, PAYCO, Samsung Pay, serta kartu domestik (termasuk kartu yang tidak mengaktifkan pembayaran internasional) juga muncul. Toss tidak didukung. Saldo tidak memiliki masa berlaku dan request yang gagal tidak ditagihkan. Jika Anda bingung memilih antara Codex dan Claude Code, lihat Codex vs Claude Code.

Pertanyaan yang sering diajukan