Codex CLI

Siapkan OpenAI Codex CLI dengan CometAPI: konfigurasikan openai_base_url atau custom provider di config.toml, simpan API key Anda di auth.json, lalu mulai coding dengan model yang terbaru.

Gunakan panduan ini untuk menjalankan Codex CLI dengan CometAPI sebagai penyedia model.

Referensi resmi:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

Ketersediaan model sering berubah. Contoh di bawah menggunakan your-model-id — ganti dengan ID model terkini yang cocok untuk coding dari halaman Models CometAPI.

​

Prasyarat

Persyaratan	Detail
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), atau Windows 11 melalui WSL2
Node.js	22+ (LTS direkomendasikan)
Git	2.23+ direkomendasikan
CometAPI key	Dapatkan dari CometAPI Dashboard (diawali dengan sk-)

​

Instal Codex CLI

npm i -g @openai/codex

Atau melalui Homebrew:

brew install --cask codex

Verifikasi instalasinya:

codex --version

​

Konfigurasikan CometAPI

Ada dua cara untuk mengarahkan Codex ke CometAPI. Pilih mana yang paling sesuai dengan workflow Anda.

Sederhana: openai_base_url

Opsi termudah — arahkan ulang penyedia OpenAI bawaan ke CometAPI dengan satu baris. Tidak perlu mendefinisikan custom provider.

Buat ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Named provider

Definisikan provider bernama cometapi. Berguna saat Anda ingin beralih antara beberapa provider menggunakan --profile atau model_provider.

Buat ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key memberi tahu Codex variabel environment mana yang menyimpan API key Anda. Codex membaca nilai OPENAI_API_KEY saat runtime — ini bukan key Anda yang sebenarnya.

​

Simpan API key Anda

Buat ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

Ganti sk-your-cometapi-key dengan CometAPI key Anda yang sebenarnya.

File ini wajib. Tanpa entri OPENAI_API_KEY yang valid di auth.json, Codex akan keluar dengan API key auth is missing a key.

​

Jalankan Codex

cd your-project
codex

Saat pertama kali dijalankan, Codex akan meminta Anda memilih tema dan mengonfirmasi pengaturan keamanan.

​

Override model per sesi

Beralih ke model lain untuk satu kali eksekusi tanpa mengedit config.toml:

codex --model your-model-id

​

Alternatif: variabel environment

Alih-alih auth.json, export key secara langsung:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Ini menetapkan key hanya untuk sesi terminal saat ini. Agar permanen, tambahkan baris export ke ~/.zshrc atau ~/.bashrc.

​

Pemecahan masalah

Gejala	Solusi
API key auth is missing a key	Pastikan ~/.codex/auth.json berisi "OPENAI_API_KEY": "sk-..."
Prompt login muncul tanpa diduga	Hapus ~/.codex/auth.json lama lalu buat ulang dengan CometAPI key Anda
Model tidak ditemukan	Periksa halaman Models untuk model yang saat ini tersedia
Connection timeout	Pastikan openai_base_url atau base_url adalah https://api.cometapi.com/v1 di config.toml
Masalah di Windows	Codex memerlukan WSL2 di Windows — CMD/PowerShell native tidak didukung