Menggunakan DeepSeek di Codex CLI: Panduan Pengaturan V4 Flash / Pro

Konfigurasikan DeepSeek V4 Flash dan Pro di Codex CLI melalui endpoint Responses APIMaster. Termasuk pengaturan kunci API, peralihan model, pengujian alat, dan pemecahan masalah.

Bisakah Codex CLI menggunakan DeepSeek? Pengujian kami dengan Codex CLI 0.153.4 berhasil menggunakan deepseek-v4-flash dan deepseek-v4-pro melalui endpoint Responses APIMaster. Konfigurasikan penyedia kustom dengan URL dasar https://apimaster.ai/v1 dan wire_api = "responses". Chat Completions yang kompatibel dengan OpenAI saja tidak cukup untuk konfigurasi ini.

Terakhir diuji: 2026-09-07, Codex CLI 0.153.4, Linux. Kedua model mengembalikan teks yang diharapkan, memanggil alat shell untuk membaca file uji lokal, dan menjawab dengan isinya. Semua proses keluar dengan kode 0. Peringatan metadata dan peristiwa streaming terjadi; lihat pemecahan masalah. Perintah untuk Windows / macOS disediakan untuk pengaturan, tetapi pengujian ini dijalankan di Linux. Sesi panjang, input gambar, dan alur kerja pengkodean kompleks tidak diuji.

1. Siapkan Codex dan kunci API Anda

Instal Codex mengikuti panduan lingkungan dan panduan pengaturan Codex, lalu periksa:

codex --version

Buat kunci API APIMaster dengan akses ke model DeepSeek yang dipilih dan kuota yang cukup. Untuk tutorial ini, gunakan konfigurasi khusus di bawah ini; Anda tidak perlu mengganti auth.json yang ada atau keluar dari akun lain.

2. Atur kunci di terminal Anda

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

Variabel hanya ada di sesi terminal ini. Konfigurasi menyimpan nama variabel, bukan rahasia itu sendiri.

3. Buat konfigurasi penyedia terpisah

Di direktori yang Anda gunakan untuk tutorial ini, buat deepseek.toml dengan konten ini. Biarkan konfigurasi Codex Anda yang ada tidak berubah.

model = "deepseek-v4-flash"
model_provider = "apimaster_deepseek"

[model_providers.apimaster_deepseek]
name = "APIMaster DeepSeek"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"

Untuk pengujian pertama yang dapat disalin dan terisolasi, berikan pengaturan yang sama sebagai override baris perintah. --ignore-user-config mencegah penyedia lain dalam konfigurasi normal Anda mengambil alih. --ephemeral menghindari penyimpanan sesi pengujian ini.

codex exec --ignore-user-config --ephemeral --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash -c 'model_provider="apimaster_deepseek"' -c 'model_providers.apimaster_deepseek.name="APIMaster DeepSeek"' -c 'model_providers.apimaster_deepseek.base_url="https://apimaster.ai/v1"' -c 'model_providers.apimaster_deepseek.env_key="APIMASTER_API_KEY"' -c 'model_providers.apimaster_deepseek.wire_api="responses"' "Reply with exactly: DEEPSEEK_TEST_OK"

Jalankan perintah dari terminal tempat Anda mengatur kunci. Jawaban akhir yang diharapkan: DEEPSEEK_TEST_OK. Di versi Windows PowerShell yang lebih lama, kutipan argumen asli dapat berbeda; gunakan PowerShell 7 atau metode profil di bawah ini jika argumen TOML ditolak.

4. Simpan konfigurasi sebagai profil yang dapat digunakan kembali

Untuk versi CLI yang diuji, letakkan deepseek.toml di ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Jika CODEX_HOME disesuaikan, gunakan direktori itu sebagai gantinya. Profil bernama ini menjaga pengaturan DeepSeek tetap terpisah dari config.toml normal Anda.

macOS / Linux, dari direktori yang berisi deepseek.toml:

mkdir -p ~/.codex
cp deepseek.toml ~/.codex/deepseek.config.toml
codex --profile deepseek --model deepseek-v4-flash

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
Copy-Item .\deepseek.toml "$env:USERPROFILE\.codex\deepseek.config.toml"
codex --profile deepseek --model deepseek-v4-flash

Cadangkan file profil terlebih dahulu jika nama file itu sudah ada. Sintaks profil bergantung pada versi: perintah ini menargetkan 0.153.4. Periksa codex --help pada versi yang Anda instal; rilis yang lebih lama mungkin menggunakan profil di dalam config.toml sebagai gantinya.

Untuk menggunakan Pro:

codex --profile deepseek --model deepseek-v4-pro

Profil berlapis di atas konfigurasi normal Anda, sehingga server MCP yang ada atau pengaturan lain mungkin masih berlaku. Perintah terisolasi di langkah 3 berguna saat mendiagnosis konflik konfigurasi.

5. Verifikasi panggilan alat

Buat file lokal bernama probe.txt yang berisi:

TOOL_PROBE_739182

Dari direktori yang sama, jalankan:

codex exec --profile deepseek --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash "Use your file reading or shell tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Diharapkan: perintah pembaca file berhasil dieksekusi, diikuti oleh TOOL_PROBE_739182. Ulangi dengan --model deepseek-v4-pro. Ini memeriksa perjalanan bolak-balik permintaan-alat / hasil-alat, di luar respons teks sederhana. Biarkan prompt izin normal tetap aktif untuk pekerjaan proyek yang sebenarnya.

Pemecahan Masalah

Gejala	Penjelasan atau langkah berikutnya
`Model metadata ... not found`	CLI yang diuji tidak memiliki metadata bawaan untuk ID model ini dan menggunakan metadata cadangan. Pengujian teks dan alat kami selesai, tetapi batas konteks dan default lainnya tidak boleh dianggap sebagai kemampuan model yang terverifikasi.
Kesalahan penguraian daftar model	Daftar model gateway mungkin berbeda dari katalog metadata Codex. Tentukan model secara eksplisit dan periksa apakah permintaan yang sebenarnya selesai.
`OutputTextDelta without active item`	Terlihat dalam pengujian streaming kami. Respons akhir dan perjalanan bolak-balik alat tetap selesai. Jika output hilang atau terputus, simpan versi CLI, stempel waktu, dan kesalahan untuk dukungan.
401 atau permintaan pergi ke penyedia lain	Periksa `APIMASTER_API_KEY`, pemilihan penyedia, dan pengaturan yang diwarisi. Coba lagi perintah terisolasi di langkah 3.
404 atau protokol tidak didukung	URL dasar berakhir dengan `/v1`, bukan `/chat/completions`; atur `wire_api = "responses"`.
Opsi baris perintah tidak dikenal	Periksa versi CLI yang diinstal. Opsi yang didokumentasikan diuji dengan 0.153.4.

Pertanyaan yang sering diajukan

Apakah ini berarti setiap endpoint DeepSeek berfungsi di Codex?

Tidak. Hasil ini berlaku untuk konfigurasi gateway APIMaster. Penyedia harus mendukung protokol dan perilaku alat yang diharapkan Codex; menerima /chat/completions tidak membangun kompatibilitas Responses.

Apakah saya perlu langganan ChatGPT untuk pengaturan ini?

Penyedia kustom ini menggunakan kunci API APIMaster dan kuota akun Anda. Ini tidak menggunakan kuota langganan ChatGPT. Periksa marketplace model untuk tarif API saat ini.

Bisakah saya mengklaim kompatibilitas Codex penuh dari pengujian ini?

Lingkup yang diverifikasi adalah output teks pendek dan perjalanan bolak-balik alat pembaca file lokal. Peringatan di atas tetap relevan; perilaku konteks panjang, setiap alat, dan setiap rilis CLI di masa depan tidak tercakup.