Codex CLI'de DeepSeek Kullanımı: V4 Flash / Pro Kurulum Rehberi

APIMaster'ın Responses uç noktası aracılığıyla Codex CLI'de DeepSeek V4 Flash ve Pro'yu yapılandırın. API anahtarı kurulumu, model değiştirme, araç testleri ve sorun giderme dahildir.

Codex CLI DeepSeek kullanabilir mi? Codex CLI 0.153.4 ile yaptığımız testler, APIMaster'ın Responses uç noktası üzerinden deepseek-v4-flash ve deepseek-v4-pro modellerini başarıyla kullandı. Temel URL https://apimaster.ai/v1 ve wire_api = "responses" olan özel bir sağlayıcı yapılandırın. OpenAI uyumlu Chat Completions tek başına bu yapılandırma için yeterli değildir.

Son test: 2026-09-07, Codex CLI 0.153.4, Linux. Her iki model de beklenen metni döndürdü, yerel bir test dosyasını okumak için bir kabuk aracı çağırdı ve içeriğiyle yanıt verdi. Tüm çalıştırmalar 0 koduyla çıktı. Meta veri ve akış olayı uyarıları oluştu; sorun giderme bölümüne bakın. Windows / macOS komutları kurulum için sağlanmıştır, ancak bu test Linux üzerinde yapılmıştır. Uzun oturumlar, görüntü girişi ve karmaşık kodlama iş akışları test edilmemiştir.

1. Codex'i ve API anahtarınızı hazırlayın

Codex'i ortam rehberi ve Codex kurulum rehberi izleyerek kurun, ardından kontrol edin:

codex --version

Seçilen DeepSeek modeline erişimi ve yeterli kotası olan bir APIMaster API anahtarı oluşturun. Bu eğitim için aşağıdaki özel yapılandırmayı kullanın; mevcut bir auth.json dosyasını değiştirmeniz veya başka bir hesaptan çıkış yapmanız gerekmez.

2. Anahtarı terminalinizde ayarlayın

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

Değişken yalnızca bu terminal oturumunda bulunur. Yapılandırma, değişkenin adını saklar, sırrın kendisini değil.

3. Ayrı bir sağlayıcı yapılandırması oluşturun

Bu eğitim için kullandığınız bir dizinde, bu içerikle deepseek.toml oluşturun. Mevcut Codex yapılandırmanızı değiştirmeden bırakın.

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"

Kopyalanabilir, izole bir ilk test için aynı ayarları komut satırı geçersiz kılmaları olarak iletin. --ignore-user-config, normal yapılandırmanızdaki başka bir sağlayıcının öncelik kazanmasını önler. --ephemeral bu test oturumunun kaydedilmesini önler.

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"

Komutu anahtarı ayarladığınız terminalden çalıştırın. Beklenen son yanıt: DEEPSEEK_TEST_OK. Eski Windows PowerShell sürümlerinde, yerel bağımsız değişken alıntılama farklı olabilir; TOML bağımsız değişkenleri reddedilirse PowerShell 7 veya aşağıdaki profil yöntemini kullanın.

4. Yapılandırmayı yeniden kullanılabilir bir profil olarak kaydedin

Test edilen CLI sürümü için deepseek.toml dosyasını ~/.codex/deepseek.config.toml konumuna yerleştirin (Windows: %USERPROFILE%\.codex\deepseek.config.toml). CODEX_HOME özelleştirilmişse, bunun yerine bu dizini kullanın. Bu adlandırılmış profil, DeepSeek ayarlarını normal config.toml dosyanızdan ayrı tutar.

macOS / Linux, deepseek.toml içeren dizinden:

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

Bu dosya adı zaten varsa önce bir profil dosyasını yedekleyin. Profil sözdizimi sürüme bağlıdır: bu komutlar 0.153.4'ü hedefler. Yüklü sürümünüzde codex --help komutunu kontrol edin; eski sürümler bunun yerine config.toml içinde profiller kullanabilir.

Pro'yu kullanmak için:

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

Bir profil normal yapılandırmanızın üzerine katmanlanır, bu nedenle mevcut MCP sunucuları veya diğer ayarlar hâlâ geçerli olabilir. 3. adımdaki izole komut, yapılandırma çakışmalarını teşhis ederken kullanışlıdır.

5. Bir araç çağrısını doğrulayın

İçeren probe.txt adlı yerel bir dosya oluşturun:

TOOL_PROBE_739182

Aynı dizinden şunu çalıştırın:

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."

Beklenen: bir dosya okuma komutu başarıyla yürütülür, ardından TOOL_PROBE_739182 gelir. --model deepseek-v4-pro ile tekrarlayın. Bu, basit bir metin yanıtının ötesinde bir araç isteği / araç sonucu gidiş-dönüşünü kontrol eder. Gerçek proje çalışması için normal izin istemlerini etkin bırakın.

Sorun Giderme

Belirti	Açıklama veya sonraki adım
`Model metadata ... not found`	Test edilen CLI, bu model kimlikleri için yerleşik meta verilere sahip değildi ve yedek meta veriler kullandı. Metin ve araç testlerimiz tamamlandı, ancak bağlam sınırları ve diğer varsayılanlar doğrulanmış model yetenekleri olarak ele alınmamalıdır.
Model listesi ayrıştırma hatası	Ağ geçidinin model listesi, Codex'in meta veri kataloğundan farklı olabilir. Modeli açıkça belirtin ve gerçek isteğin tamamlanıp tamamlanmadığını kontrol edin.
`OutputTextDelta without active item`	Akış testimizde görüldü. Son yanıt ve araç gidiş-dönüşü yine de tamamlandı. Çıktı eksik veya kesintiye uğrarsa, destek için CLI sürümünü, zaman damgasını ve hatayı saklayın.
401 veya istek başka bir sağlayıcıya gidiyor	`APIMASTER_API_KEY`, sağlayıcı seçimini ve devralınan ayarları kontrol edin. 3. adımdaki izole komutu yeniden deneyin.
404 veya desteklenmeyen protokol	Temel URL `/v1` ile biter, `/chat/completions` ile değil; `wire_api = "responses"` ayarlayın.
Bilinmeyen komut satırı seçeneği	Yüklü CLI sürümünü kontrol edin. Belgelenen seçenekler 0.153.4 ile test edilmiştir.

Sıkça sorulan sorular

Bu, her DeepSeek uç noktasının Codex'te çalıştığı anlamına mı gelir?

Hayır. Bu sonuçlar APIMaster'ın ağ geçidi yapılandırması için geçerlidir. Bir sağlayıcı, Codex'in beklediği protokolü ve araç davranışını desteklemelidir; /chat/completions kabul etmek Responses uyumluluğu sağlamaz.

Bu kurulum için bir ChatGPT aboneliğine ihtiyacım var mı?

Bu özel sağlayıcı, APIMaster API anahtarınızı ve hesap kotanızı kullanır. ChatGPT abonelik kotasını kullanmaz. Güncel API oranları için model pazarını kontrol edin.

Bu testlerden tam Codex uyumluluğu iddia edebilir miyim?

Doğrulanan kapsam, kısa metin çıktısı ve yerel bir dosya okuma aracı gidiş-dönüşüdür. Yukarıdaki uyarılar geçerliliğini korur; uzun bağlam davranışı, her araç ve gelecekteki her CLI sürümü kapsanmaz.