Beranda → Panduan → Codex dengan API kustom: pengaturan config.toml untuk Codex CLI dan Codex desktop

Codex dengan API kustom: pengaturan config.toml untuk Codex CLI dan Codex desktop

Codex membaca penyedianya dari satu file. Lima baris konfigurasi dan satu variabel lingkungan memindahkan alat baris perintah dan aplikasi desktop sekaligus — dan sebagian besar kegagalan berasal dari variabel lingkungan, bukan konfigurasi.

Konfigurasinya

Tambahkan penyedia di config.toml dan jadikan default:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Tiga detail penting. base_url diakhiri /v1, karena Codex menambahkan /responses sendiri. wire_api = "responses" membuat Codex memakai Responses API, yang dilayani gateway ini. Dan env_key adalah nama variabel lingkungan, bukan kuncinya.

Letak file

macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml

Buat folder dan file bila belum ada. Aplikasi desktop Codex membaca file yang sama dengan alat baris perintah, jadi satu kali edit berlaku untuk keduanya. Jika tidak ingin mengedit TOML manual, CC Switch bisa menuliskannya — lihat panduan aplikasi desktop.

Mengatur kunci agar terlihat oleh Codex

macOS / Linux — tambahkan ke profil shell Anda:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — simpan untuk akun pengguna Anda:

setx APICLAN_API_KEY "sk-your-key"

Di sinilah kebanyakan pengaturan gagal. Variabel yang diatur dengan export atau $env: hanya ada di terminal itu; aplikasi desktop yang dibuka dari Dock atau menu Start tidak pernah melihatnya. setx di Windows menyimpannya permanen, tetapi hanya program yang dibuka sesudahnya yang membacanya — tutup Codex sepenuhnya lalu buka lagi.

Memilih model dan tingkat penalaran

Ubah model di konfigurasi, atau ganti di dalam sesi dengan /model:

Model	Cocok untuk
`gpt-6.1-sol`, `gpt-5.6-terra`	Coding harian, suntingan, tes — termurah per panggilan
`gpt-5.6-sol`	Jika prompt Anda disetel untuk GPT-5.6
`gpt-6-astra`	Masalah sulit yang jawaban lebih baiknya sepadan dengan harga lima kali lipat

model_reasoning_effort menerima low, medium, high, dan xhigh. Makin tinggi, makin banyak yang ditulis: di sini pada gpt-5.6-sol, panggilan median dengan high mengembalikan 373 token output dibanding 139 dengan medium — 2,7 kali lipat, semuanya ditagih sebagai output. Mulailah dari medium. Harga ada di panduan harga API OpenAI.

Seperti apa trafik Codex di sini

Dalam 30 hari terakhir, 87% dari semua panggilan GPT di gateway ini berasal dari Codex, semuanya lewat /v1/responses dengan streaming. Panggilan median:

membawa sekitar 67.000 token konteks, 86% dari cache
memakan 14 detik total, token pertama setelah 10 detik
mengembalikan 214 token output

Empat galat yang paling sering

401 Unauthorized → Codex tidak melihat APICLAN_API_KEY. Atur seperti di atas lalu mulai ulang Codex sepenuhnya. echo $APICLAN_API_KEY di lingkungan yang sama harus menampilkan kuncinya.
404 atau halaman HTML → base_url tidak punya /v1, atau ada dua kali.
model not found → nama model salah ketik, atau kunci Anda milik grup yang tidak memuat model itu. Daftar yang berlaku adalah GET https://apiclan.us/v1/models.
stream disconnected atau timeout pada tugas panjang → penalaran yang sangat panjang melampaui kesabaran proxy. Ubah base_url ke https://api.apiclan.us/v1, yang melewati batas proxy 100 detik.

Claude Code memakai aturan sebaliknya — tanpa /v1 — dibahas di panduan base URL Claude Code.

Mulai gunakan

Tanpa langganan, tanpa minimum bulanan, tanpa panggilan sales. Isi saldo dengan USDT dan pakai sesuai kebutuhan — 1 USDT memberi Anda 2 kredit saldo API.

Baca panduan cepat 30 detik

Bahasa: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Harga di halaman ini diisi otomatis dari data penagihan nyata. Ketentuan pihak ketiga dikutip dari dokumentasi mereka sendiri.