Codex CLI

Gambaran Umum

Tipe: Alat PengkodeanJalur Utama: OpenAI Responses (jalur opsional lanjutan)Kepercayaan Dukungan: Didukung dengan batasan model/jalur

OpenAI Codex adalah alat baris perintah (CLI) sumber terbuka yang berfungsi sebagai agen pengkodean ringan, mampu membaca, memodifikasi, dan menjalankan kode di terminal. Ini dibangun di atas model GPT dan dioptimalkan untuk pembuatan kode. Untuk TokenLab, Codex CLI dapat menggunakan /v1/responses, tetapi Anda harus menganggapnya sebagai jalur kompatibilitas lanjutan. Beberapa fitur khusus Responses tidak dijamin tersedia di setiap model dan jalur yang diarahkan. Kompaksi jarak jauh Codex CLI didukung di POST /v1/responses/compact. Codex mengirim model sesi saat ini di body.model untuk /compact dan auto-compact, jadi model yang ingin dipakai untuk kompaksi harus tersedia di jalur Responses. Jangan mengonfigurasi /v1/compact.

Persyaratan Sistem

OS: macOS, Linux (dukungan resmi), Windows melalui WSL
Node.js: Versi 18+
npm: Versi 10.x.x atau lebih tinggi

Instalasi

npm install -g @openai/codex

Verifikasi instalasi:

codex --version

Konfigurasi

Langkah 1: Atur API Key

Sementara (sesi saat ini):

export OPENAI_API_KEY="sk-your-tokenlab-key"

Konfigurasi permanen: Tambahkan ke ~/.bashrc, ~/.zshrc, atau ~/.bash_profile:

export OPENAI_API_KEY="sk-your-tokenlab-key"

Kemudian muat ulang:

source ~/.zshrc  # or source ~/.bashrc

Langkah 2: Konfigurasi config.toml

Edit ~/.codex/config.toml:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

[model_providers.tokenlab]
env_key = "OPENAI_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
fast_mode = true

Mode WebSocket ini adalah bridge Responses-over-WebSocket untuk klien Codex. Mode ini hanya menerima event resmi response.create; stream bersifat implisit, sedangkan background dan response.cancel tidak tersedia pada transport ini. Ini bukan OpenAI Realtime API dan tidak menerima session.update, conversation.item.*, input_audio_buffer.*, audio biner, atau envelope Realtime bertingkat response.create.response.

Jika file konfigurasi tidak ada, jalankan codex sekali untuk menghasilkannya, lalu edit file tersebut. Restart Codex sepenuhnya setelah mengubah config.toml agar pengaturan provider baru dimuat ulang.

Codex sedang menghentikan dukungan chat/completions untuk custom providers. Pertahankan wire_api = "responses" untuk TokenLab kecuali Anda sengaja menggunakan jalur kompatibilitas yang lebih lama.

TokenLab meneruskan field Responses yang tidak dikenal secara best-effort tanpa diam-diam menurunkan request ke Chat Completions. Upstream yang dipilih menentukan apakah field atau kombinasi tersebut didukung.

Penggunaan Dasar

Mulai mode interaktif:

codex

Perintah langsung:

codex "Fix the bug in main.py line 42"

Menentukan model:

codex -m gpt-5.6-sol "Build a REST API server"

Model yang Direkomendasikan

Model	Cocok Untuk
`gpt-5.6-sol`	Pilihan default terbaik untuk pemrograman dan penalaran
`gpt-5-mini`	Cadangan yang lebih cepat dan lebih murah untuk alur kerja pengodean
`claude-sonnet-4-6`	Tinjauan kode, dokumentasi
`deepseek-r1`	Perancangan algoritma, penalaran

Perintah Interaktif

Perintah	Deskripsi
`/help`	Tampilkan bantuan
`/exit` or `Ctrl+C`	Keluar
`/clear`	Bersihkan percakapan
`/config`	Lihat konfigurasi
`/model <name>`	Ganti model
`/tokens`	Lihat penggunaan token

Verifikasi Konfigurasi

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

Kasus Penggunaan Umum

Tinjauan kode:

git diff | codex "Review these code changes"

Hasilkan pesan commit:

git diff --staged | codex "Generate a commit message for these changes"

Perbaiki kesalahan:

codex "Fix the TypeScript errors in src/components/"

Jelaskan kode:

cat main.py | codex "Explain what this code does"

Pemecahan Masalah

Kesalahan Koneksi

Pastikan base_url di config.toml persis https://api.tokenlab.sh/v1
Periksa konektivitas jaringan
Pastikan tidak ada gangguan dari proxy

Autentikasi Gagal

Periksa bahwa env_key = "OPENAI_API_KEY" ada di ~/.codex/config.toml
Periksa bahwa variabel lingkungan OPENAI_API_KEY telah diatur
Periksa bahwa kunci dimulai dengan sk-
Pastikan kunci aktif di dashboard TokenLab

Model Tidak Ditemukan

Periksa nama model agar cocok secara tepat
Verifikasi ketersediaan model di tokenlab.sh/en/models

Field khusus Responses ditolak

Beberapa field hanya tersedia di /v1/responses ketika TokenLab dapat menjamin perilaku tersebut untuk model dan jalur yang dipilih
Jika Anda melihat unsupported_request_field, hapus field tersebut atau beralih ke alur kerja yang tidak bergantung padanya

/compact atau auto-compact gagal

Codex CLI memanggil POST /v1/responses/compact, bukan /v1/compact
Permintaan kompaksi menggunakan model sesi saat ini, jadi model tersebut harus tersedia di jalur Responses
Pertahankan wire_api = "responses" dan base_url = "https://api.tokenlab.sh/v1"

Matriks kompatibilitas

Alat coding

SDK native

Framework & platform

Aplikasi chat

Gambaran Umum

Persyaratan Sistem

Instalasi

Konfigurasi

Langkah 1: Atur API Key

Langkah 2: Konfigurasi config.toml

Penggunaan Dasar

Model yang Direkomendasikan

Perintah Interaktif

Verifikasi Konfigurasi

Kasus Penggunaan Umum

Pemecahan Masalah

​Gambaran Umum

​Persyaratan Sistem

​Instalasi

​Konfigurasi

​Langkah 1: Atur API Key

​Langkah 2: Konfigurasi config.toml

​Penggunaan Dasar

​Model yang Direkomendasikan

​Perintah Interaktif

​Verifikasi Konfigurasi

​Kasus Penggunaan Umum

​Pemecahan Masalah

Gambaran Umum

Persyaratan Sistem

Instalasi

Konfigurasi

Langkah 1: Atur API Key

Langkah 2: Konfigurasi config.toml

Penggunaan Dasar

Model yang Direkomendasikan

Perintah Interaktif

Verifikasi Konfigurasi

Kasus Penggunaan Umum

Pemecahan Masalah