Laman utama → Panduan → Codex dengan API tersuai: tetapan config.toml untuk Codex CLI dan Codex desktop

Codex dengan API tersuai: tetapan config.toml untuk Codex CLI dan Codex desktop

Codex membaca penyedianya daripada satu fail. Lima baris konfigurasi dan satu pemboleh ubah persekitaran menukar alat baris arahan dan aplikasi desktop serentak — dan kebanyakan kegagalan berpunca daripada pemboleh ubah persekitaran, bukan konfigurasi.

Konfigurasi

Tambah penyedia dalam config.toml dan jadikan lalai:

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 butiran penting. base_url berakhir dengan /v1, kerana Codex menambah /responses sendiri. wire_api = "responses" membuatkan Codex menggunakan Responses API yang disokong get laluan ini. Dan env_key ialah nama pemboleh ubah persekitaran, bukan kunci itu sendiri.

Di mana fail itu

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

Cipta folder dan fail jika belum wujud. Aplikasi desktop Codex membaca fail yang sama dengan alat baris arahan, jadi satu suntingan meliputi kedua-duanya. Jika tidak mahu menyunting TOML secara manual, CC Switch boleh menulisnya untuk anda — lihat panduan aplikasi desktop.

Menetapkan kunci supaya Codex dapat melihatnya

macOS / Linux — tambah ke profil shell anda:

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

Windows — simpan untuk akaun pengguna anda:

setx APICLAN_API_KEY "sk-your-key"

Di sinilah kebanyakan tetapan gagal. Pemboleh ubah yang ditetapkan dengan export atau $env: hanya wujud dalam terminal itu; aplikasi desktop yang dibuka dari Dock atau menu Start tidak pernah melihatnya. setx pada Windows menyimpannya secara kekal, tetapi hanya program yang dibuka selepas itu membacanya — keluar sepenuhnya daripada Codex dan buka semula.

Memilih model dan tahap penaakulan

Tukar model dalam konfigurasi, atau tukar dalam sesi dengan /model:

Model	Sesuai untuk
`gpt-6.1-sol`, `gpt-5.6-terra`	Pengekodan harian, suntingan, ujian — paling murah setiap panggilan
`gpt-5.6-sol`	Jika gesaan anda ditala untuk GPT-5.6
`gpt-6-astra`	Masalah sukar yang jawapan lebih baiknya berbaloi lima kali ganda harga

model_reasoning_effort menerima low, medium, high dan xhigh. Lebih tinggi bermakna lebih banyak ditulis: pada gpt-5.6-sol di sini, panggilan median dengan high memulangkan 373 token output berbanding 139 dengan medium — 2.7 kali ganda, semuanya dibilkan sebagai output. Mulakan dengan medium. Harga ada dalam panduan harga API OpenAI.

Rupa trafik Codex di sini

Dalam 30 hari lalu, 87% daripada semua panggilan GPT di get laluan ini datang daripada Codex, semuanya melalui /v1/responses dengan penstriman. Panggilan median:

membawa kira-kira 67,000 token konteks, 86% daripadanya dari cache
mengambil 14 saat keseluruhannya, token pertama selepas 10 saat
memulangkan 214 token output

Empat ralat paling biasa

401 Unauthorized → Codex tidak dapat melihat APICLAN_API_KEY. Tetapkan seperti di atas dan mulakan semula Codex sepenuhnya. echo $APICLAN_API_KEY dalam persekitaran yang sama sepatutnya memaparkan kunci.
404 atau halaman HTML → base_url tiada /v1, atau ada dua kali.
model not found → nama model salah eja, atau kunci anda milik kumpulan yang tidak memuatkannya. Senarai yang sah ialah GET https://apiclan.us/v1/models.
stream disconnected atau tamat masa untuk tugas panjang → penaakulan yang terlalu panjang melebihi had sabar proksi. Tukar base_url kepada https://api.apiclan.us/v1, yang memintas had proksi 100 saat.

Claude Code mengikut peraturan sebaliknya — tanpa /v1 — diterangkan dalam panduan base URL Claude Code.

Mula guna

Tiada langganan, tiada minimum bulanan, tiada panggilan jualan. Tambah nilai dengan USDT dan belanja apa yang anda guna — 1 USDT memberi anda 2 kredit baki API.

Baca panduan pantas 30 saat

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 secara automatik daripada data pengebilan sebenar. Terma pihak ketiga dipetik daripada dokumentasi mereka sendiri.