Gunakan kunci Anda di Codex CLI

Konfigurasikan penyedia model kustom di ~/.codex/config.toml dengan wire_api = responses, lalu pilih model.

Codex adalah agen pengkodean dari OpenAI (CLI dan desktop). Ia mendukung penyedia model kustom — arahkan sebuah penyedia ke OLETOKEN dan ia akan memakai kunci serta kuota model OLETOKEN Anda.

Sebelum memulai

Anda sudah membuat kunci API dan menyimpan kunci lengkapnya.
Anda sudah memilih ID model dari pasar model.
Node.js dan npm sudah terpasang.

Konfigurasi

Penyedia kustom harus berada di ~/.codex/config.toml tingkat pengguna. model_provider dan model_providers di .codex/config.toml tingkat proyek akan diabaikan.

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

Kolom	Arti
`model`	ID model default
`model_provider`	Menunjuk ke penyedia yang didefinisikan di bawah
`base_url`	Alamat kompatibel OpenAI, termasuk `/v1` (Codex memanggil `{base_url}/responses`)
`env_key`	Nama variabel lingkungan yang memuat kunci — kuncinya sendiri tidak masuk ke berkas ini
`wire_api`	Hanya `responses` yang didukung saat ini

Ekspor kunci dan jalankan:

export OLETOKEN_API_KEY="YOUR_API_KEY"   # tambahkan ke ~/.zshrc atau ~/.bashrc agar permanen
npm i -g @openai/codex
codex

Dialog Quick start di halaman API keys menyediakan unduhan skrip yang sama dengan kunci, model, dan Base URL Anda yang sudah terisi: skrip itu menambahkan bagian yang belum ada dan, jika config.toml sudah memuat model / model_provider, hanya mencetak bloknya untuk Anda gabungkan alih-alih menulis ulang berkas Anda.

Penelusuran masalah

Gejala	Penyebab dan solusi
401	`OLETOKEN_API_KEY` belum diekspor atau nilainya salah — `env_key` hanya menamai variabelnya, kuncinya harus ada di lingkungan
404	`base_url` tidak menyertakan `/v1`
Penyedia diabaikan	Konfigurasinya ada di `.codex/config.toml` tingkat proyek; pindahkan ke `~/.codex/config.toml`
Model not found	ID-nya tidak terdaftar di situs ini; salin dari pasar model
Insufficient balance	Isi saldo terlebih dahulu

wire_api hanya mendukung responses, jadi Codex mengirim permintaan ke {base_url}/responses — pastikan Base URL Anda menyediakan endpoint tersebut (401 tanpa kunci berarti rutenya ada).