Gunakan kunci anda dalam Codex CLI

Konfigurasikan penyedia model tersuai dalam ~/.codex/config.toml dengan wire_api = responses, dan pilih model.

Codex ialah agen pengekodan OpenAI (CLI dan desktop). Ia menyokong penyedia model tersuai — halakan sesuatu penyedia ke OLETOKEN dan ia akan menggunakan kunci serta kuota model OLETOKEN anda.

Sebelum bermula

Anda telah mencipta kunci API dan menyimpan kunci penuh tersebut.
Anda telah memilih ID model daripada pasaran model.
Node.js dan npm telah dipasang.

Konfigurasi

Penyedia tersuai mesti diletakkan dalam ~/.codex/config.toml di peringkat pengguna. model_provider dan model_providers dalam .codex/config.toml peringkat projek 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"

Medan	Maksud
`model`	ID model lalai
`model_provider`	Merujuk kepada penyedia yang ditakrifkan di bawah
`base_url`	Alamat serasi OpenAI, termasuk `/v1` (Codex memanggil `{base_url}/responses`)
`env_key`	Nama pemboleh ubah persekitaran yang menyimpan kunci — kunci itu sendiri kekal di luar fail
`wire_api`	Hanya `responses` disokong buat masa ini

Eksport kunci dan lancarkan:

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

Dialog Mula pantas pada halaman kunci API menawarkan muat turun skrip yang sama dengan kunci, model dan Base URL anda sudah diisi: ia menambahkan apa yang belum ada dan, jika config.toml sudah mempunyai model / model_provider, ia hanya mencetak blok tersebut untuk anda gabungkan daripada menulis semula fail anda.

Penyelesaian masalah

Simptom	Punca dan penyelesaian
401	`OLETOKEN_API_KEY` tidak dieksport atau memegang nilai yang salah — `env_key` hanya menamakan pemboleh ubah, kunci itu mesti wujud dalam persekitaran
404	`base_url` tidak mempunyai `/v1`
Provider ignored	Konfigurasi berada dalam `.codex/config.toml` peringkat projek; pindahkannya ke `~/.codex/config.toml`
Model not found	ID itu tidak tersenarai di laman ini; salin daripada pasaran model
Insufficient balance	Tambah nilai dahulu

wire_api hanya menyokong responses, jadi Codex menghantar permintaan ke {base_url}/responses — pastikan Base URL anda menyediakan endpoint tersebut (401 tanpa kunci bermakna laluan itu wujud).