AIREITER

Codex'te DeepSeek Kullanımı: Kurulum, Sınırlar ve Maliyet

Son Güncelleme: 2026-08-03 08:10:33

Codex'e DeepSeek bağlamak için artık araya proxy koymak gerekmiyor. Codex, modellerle Responses API üzerinden konuşuyor; DeepSeek de bu protokolü doğrudan destekliyor. Yani iş, bir yapılandırma dosyasına birkaç ayar eklemeye kalıyor. Ancak önemli bir sınır var: Codex tarafında yalnızca iki DeepSeek modelinden biri çalışıyor ve bu model görüntü kabul etmiyor.

DeepSeek modellerini OpenAI Codex ile entegre etmeye yönelik resmi DeepSeek dokümantasyon sayfası

Codex, DeepSeek ile çalışır mı?

Evet. Codex, modellere OpenAI'nin Responses API'si üzerinden erişiyor; DeepSeek API de bu protokolü yerel olarak destekliyor. Bu nedenle DeepSeek'i, bir yapılandırma dosyasında tanımladığınız model sağlayıcısı olarak Codex'e ekleyebiliyorsunuz. DeepSeek, entegrasyonu API dokümanlarında Agent Integrations → Codex başlığı altında doğrudan yayımlıyor.

Bu, kurulum gereksinimlerinde önemli bir değişiklik. Codex, eski wire_api = "chat" yolunu bırakıp Responses API'ye geçtiğinde DeepSeek'e bir süre yalnızca çeviri katmanı üzerinden ulaşılabiliyordu: LiteLLM, kendi Responses uygulamasına sahip bir yönlendirici veya elle yazılmış bir köprü gerekiyordu. Bunların hepsi hâlâ kullanılabilir, fakat artık başlangıç şartı değiller. Bu işlem, Codex'e DeepSeek odaklı MCP araçları eklemekten ayrı bir sağlayıcı yapılandırmasıdır.

Tek bir yapılandırma tüm Codex istemcilerine yeter. Codex CLI, ChatGPT masaüstü uygulaması ve VS Code için Codex IDE eklentisi aynı ~/.codex dizinini kullanır. Her istemci için ayrı ayrı ayar yapmanız gerekmez.

Codex'te hangi DeepSeek modeli çalışıyor?

Yalnızca deepseek-v4-flash. DeepSeek'in fiyatlandırma tablosunda, Responses API desteği deepseek-v4-flash için ✓, deepseek-v4-pro için ise ✗ olarak görünüyor. Dipnotta Pro desteğinin Ağustos 2026 başlarında geleceği belirtiliyor. 3 Ağustos 2026 itibarıyla dipnot yerinde duruyor ve Pro hâlâ ✗ işaretli.

Kurulumun yazdığı models.json kataloğunda iki model de listeleniyor. Bu yüzden yapılandırmanızda Pro'yu seçmenizi engelleyen bir şey yok; hata, istek DeepSeek'e ulaştığında ortaya çıkıyor. CC Switch'in DeepSeek ön ayarında da aynı uyarı bulunuyor: DeepSeek entegrasyonu açılmadan Pro'ya geçmek hata veriyor.

Daha güçlü modeli bugün kullanmak istiyorsanız Anthropic biçimindeki uç noktası destekleniyor. Pro'nun Claude Code kurulumlarında görünüp Codex'te görünmemesinin nedeni de bu. İki modelin fiyatı ve eşzamanlılık sınırları yeterince farklı; seçimi bilinçli yapmakta fayda var. Karşılaştırma için deepseek-v4-flash vs deepseek-v4-pro yazısına bakabilirsiniz.

1. yöntem: Resmi kurulum betiği

Birden fazla sağlayıcıyı zaten yönetmiyorsanız, DeepSeek'in tüm yapılandırmayı oluşturan kurulum betiği en hızlı seçenek. Önce Codex CLI veya ChatGPT masaüstü uygulaması yüklenmiş ve en az bir kez açılmış olmalı; böylece ~/.codex dizini oluşturulur. Ayrıca model kataloğunun belirttiği asgari sürüm olan 0.144.0 veya üzeri bir Codex istemcisi gerekir.

# macOS / Linux
bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

# Windows, PowerShell içinde
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

Betik menü tabanlı çalışıyor: 1, deepseek-v4-flash modelini; 2, deepseek-v4-pro modelini seçiyor; 3 ise kurulum öncesindeki yapılandırmayı geri yüklüyor. 1 seçeneğini kullanın. 2, henüz Codex isteklerini işleyemeyen bir model için geçerli görünen ama işlevsiz bir yapılandırma yazıyor. İlk çalıştırmada API anahtarınızı ister; anahtarı platform.deepseek.com üzerinden oluşturabilirsiniz.

Mevcut yapılandırmanızda neyi değiştiriyor?

Resmi betiği 3 Ağustos 2026'da, kasıtlı olarak çakışan ayarlar içeren geçici bir CODEX_HOME üzerinde çalıştırdım: bir profile, eski bir model_verbosity, bir model_reasoning_summary, ayrıca MCP sunucusu ve güvenilen proje kaydı vardı. Aynı testi CODEX_HOME=/tmp/probe sh codex-deepseek-setup-en.sh ile yapıp 1 seçeneğini seçerek tekrarlayabilirsiniz. Betik dört değişiklik bildirdi ve her birini açıkladı:

• model yeniden yazıldı: "gpt-5.6-sol" → "deepseek-v4-flash"
• profile = "myprofile" kaldırıldı  ← bir profil model / model_provider / model_catalog_json ayarlarını gizler
• model_verbosity = "high" kaldırıldı  ← eski bir değer, modelin desteklediği aralığın dışında olabilir
• model_reasoning_summary = "detailed" kaldırıldı  ← models.json default_reasoning_summary=none tanımlıyor

[mcp_servers.playwright] bloğu, [projects."..."] içindeki güven seviyesi ve approval_policy ise hiç değişmeden kaldı. Herhangi bir yazma işlemi öncesinde özgün dosya ~/.codex/backup-deepseek/ dizinine kopyalandı. Betik, değişiklikleri uygulamadan önce iki dosyayı da doğruladı: models.json için JSON doğrulaması, config.toml için ayrıştırma hataları ve yinelenen anahtar denetimi yaptı. Bu, tek makinedeki tek çalıştırmanın gözlemidir; yedekleme ve geri yükleme yollarının varlığına dair kanıt olarak değerlendirin, her yapılandırma biçimi için garanti olarak değil.

2. yöntem: config.toml dosyasını elle düzenlemek

Yapılandırmayı sürüm kontrolünde tutmak ya da her alanın ne yaptığını bilmek istiyorsanız dosyayı kendiniz düzenleyin. Önce ~/.codex/models.json dosyasını, DeepSeek dokümanlarında yayımlanan model kataloğuyla oluşturun. Ardından ~/.codex/config.toml dosyasına şunları ekleyin:

model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<your DeepSeek API Key>"
AlanNe işe yarar?
wire_api = "responses"Chat Completions yerine Responses API'yi seçer. Entegrasyonu asıl çalıştıran alan budur
model_catalog_jsonBağlam penceresi, akıl yürütme seviyeleri ve araç biçimlerini tanımlayan models.json dosyasını gösterir. Bu ayar olmadan Codex genel model metadatasına döner
preferred_auth_method, forced_login_methodChatGPT hesap girişi yerine API anahtarıyla kimlik doğrulaması yapar
model_reasoning_effortDeepSeek kataloğunun tanımladığı üç seviye: low, high veya max
experimental_bearer_tokenAPI anahtarınız; dosyada düz metin olarak saklanır

3. yöntem: Sık sağlayıcı değiştiriyorsanız CC Switch

CC Switch, Codex dahil sekiz kodlama aracı için sağlayıcı yapılandırmasını yöneten bir masaüstü uygulaması. Yerleşik DeepSeek ön ayarında https://api.deepseek.com uç noktası, varsayılan model olarak deepseek-v4-flash ve model kataloğunda hem Flash hem Pro bulunuyor. Elle yazacağınız alanların aynısını, metin düzenleyici yerine sistem tepsisi menüsünden yazıyor.

Kullanmadan önce iki noktayı göz önünde bulundurun. Sağlayıcı değişikliğinin etkili olması için Codex'in yeniden başlatılması gerekiyor; Claude Code'da durum böyle değil. Ayrıca uygulama, kaydettiğiniz her sağlayıcının kimlik bilgilerini tek yerde tutuyor ve bunları yönlendirmek için yerel bir servis çalıştırıyor. Bu, tek bir dosyada tek API anahtarı bulundurmaktan farklı bir güvenlik yaklaşımıdır.

Kurulumun devreye girdiğini nasıl doğrularsınız?

Bir proje içinde Codex CLI'ı başlatın ve açılış bildirimine bakın. model ile provider satırları doğrulama için yeterli. Test yapılandırmamı 3 Ağustos 2026'da codex-cli 0.146.0 ile çalıştırdığımda çıktı şuydu:

OpenAI Codex v0.146.0
model: deepseek-v4-flash
provider: deepseek
reasoning effort: high

Hatalı API anahtarı, kullanılan uç noktayı da yazdığı için kolay ayırt edilir. İsteklerin DeepSeek'e gittiğini hızlıca doğrulamanın en pratik yolu budur:

ERROR: unexpected status 401 Unauthorized: Authentication Fails, Your api key: ****r000 is invalid,
       url: https://api.deepseek.com/responses

Codex, bu hatayı göstermeden önce beş kez yeniden denedi. Dolayısıyla API anahtarındaki bir yazım hatası, birkaç saniyelik sessizlikten sonra görünür hâle geliyor. ChatGPT masaüstü uygulamasında model seçici, macOS'te model adı yerine Custom yazar; uygulama yerel olarak yapılandırılmış tüm modelleri böyle etiketler. Buna rağmen seçtiğiniz DeepSeek modeli kullanılmaya devam eder. Codex günlüklerinde fallback model metadata veya Unknown model görüyorsanız models.json yüklenmemiştir ve katalog yolu yanlıştır.

DeepSeek, Codex içinde çalışırken neler değişiyor?

Codex'i bir OpenAI modeliyle kullanmaya kıyasla dört davranış farklılaşıyor. Bunların hiçbiri çözmeniz gereken bir hata değil.

Görüntü girişi yok. models.json içindeki DeepSeek kayıtları input_modalities: ["text"] tanımlıyor. Bu nedenle DeepSeek aktif modelken hiçbir Codex istemcisinde yapıştırılmış ekran görüntüleri veya resim ekleri kullanılamıyor. Bir geliştirici, 2 Ağustos 2026'da Hacker News'te aynı sınıra takıldığını ve görüntü için ikinci bir sağlayıcı kullandığını yazdı:

DeepSeek V4'te görüntü desteği olmadığı için, Codex aboneliğiyle GPT 5.6 Luna kullanması için OMP'yi ayarladı.

Bu çözüm, görüntü kabul eden bir hizmete işaret eden ikinci bir [model_providers.*] bloğu eklemekten ibaret. wire_api = "responses" yapısı aynı kaldığı için GPT-5.6 taşıyan bir toplayıcı uç nokta da aynı yapılandırmaya eklenebilir; geçiş için yalnızca tek bir model satırını değiştirmeniz yeterlidir.

Eski oturumlarınız silinmiş gibi görünür. Codex, oturum geçmişini giriş yöntemine göre gruplar. Bu yüzden ChatGPT aboneliğinden üçüncü taraf API anahtarına geçtiğinizde önceki grup silinmez, yalnızca görünmez olur. Eski yapılandırmayı geri yüklediğinizde o oturumlar yeniden gelir; DeepSeek oturumları ise arka planda kalır.

API anahtarı yapılandırma dosyasında düz metin hâlinde durur. experimental_bearer_token, ortam değişkenine referans değil doğrudan anahtarın kendisini içerir. Bu nedenle ~/.codex/config.toml, dizini senkronize etmeden veya bir dotfiles deposuna göndermeden önce kontrol etmeniz gereken gizli bilgi içeren bir dosyadır.

Kendini ChatGPT olarak tanıtabilir. Entegrasyonun yüklediği models.json, Codex'in kendi harness istemini içeriyor ve bu istem "You are Codex, an agent based on GPT-5." diye başlıyor. Bu metin gerçekten iş görüyor: Aracın izlediği araç protokolünü, onay kurallarını ve çıktı biçimini tanımlıyor. Bu yüzden aynı model, boş bir sohbet penceresindekinden farklı davranır; kimlik satırı modelin köken iddiasından değil, harness'ten gelir.

Maliyeti ne kadar?

deepseek-v4-flash, 3 Ağustos 2026'da DeepSeek fiyatlandırma sayfasından doğrulandığı üzere önbellek ıskalasındaki giriş tokenları için milyon başına $0.14, çıktı tokenları için ise milyon başına $0.28 fiyatla listeleniyor. Önbellek isabetindeki giriş tokenı maliyeti milyon başına $0.0028; yani ıskala maliyetinin ellide biri. Kodlama ajanları her turda büyüyen bağlamı yeniden gönderdiği için, uzun ajan oturumlarının maliyetini asıl bu fark belirliyor.

Önbelleğe alınmış giriş, önbelleğe alınmamış giriş ve çıktı için deepseek-v4-flash ile deepseek-v4-pro'nun milyon token başına fiyatlarını karşılaştıran çubuk grafik
deepseek-v4-flashdeepseek-v4-pro
Codex'te çalışırEvetHenüz değil
Sürüm dizesiDeepSeek-V4-Flash-0731DeepSeek-V4-Pro
Bağlam / azami çıktı1M / 384K1M / 384K
Giriş, önbellek isabeti$0.0028$0.003625
Giriş, önbellek ıskalaması$0.14$0.435
Çıktı$0.28$0.87
Eşzamanlılık sınırı2500500

Tablonun göstermediği iki ayrıntı var. DeepSeek, açıkladığı üzere yoğun ve yoğun olmayan saatlere göre fiyatlandırmaya geçecek. Yoğun saatlerde, her gün Pekin saatiyle (UTC+8) 09:00–12:00 ve 14:00–18:00 arasında, listelenen ücretlerin 2 katı uygulanacak; başlangıç tarihi ise daha sonra duyurulacak. Ayrıca katalog, 1M bağlam penceresini %95 etkin kapasiteyle tanımlıyor; kesme işlemi de models.json içindeki politikaya göre devreye giriyor.

SSS

ChatGPT aboneliği olmadan Codex'te DeepSeek kullanabilir miyim?

Evet. preferred_auth_method = "apikey" ve forced_login_method = "api" ayarları, Codex'in DeepSeek anahtarınızla kimlik doğrulaması yapmasını ve hesap girişini tamamen atlamasını sağlar.

VS Code eklentisi ve masaüstü uygulaması için ayrı kurulum gerekir mi?

Hayır. Üç Codex istemcisi de aynı ~/.codex yapılandırmasını okur. Değişikliği algılaması için sağlayıcı geçişinden sonra masaüstü istemcisini yeniden başlatın.

Resmi modele nasıl geri dönerim?

Kurulum betiğini yeniden çalıştırıp, kurulumdan önce yedeklediği config.toml dosyasını geri getiren 3 seçeneğini kullanın. Codex'i elle yapılandırdıysanız DeepSeek alanlarını ve [model_providers.deepseek] bloğunu silin, ardından yeniden giriş yapın.

deepseek-v4-pro'yu Codex'te henüz kullanabilir miyim?

3 Ağustos 2026 itibarıyla hayır. DeepSeek'in fiyatlandırma sayfasında Responses API desteği hâlâ ✗ olarak işaretleniyor. Açıklanan hedef Ağustos 2026 başlarıydı; bu nedenle seçmenize izin veren bir yapılandırmaya güvenmek yerine sayfayı yeniden kontrol edin.

Hangi yöntem size uygun?

YöntemŞu durumda seçinBedeli
Resmi kurulum betiğiTek komutla çalışmasını ve yedekleme/geri yükleme yolunu istiyorsanızHenüz incelemediğiniz yapılandırma alanlarını yeniden yazar; anahtar düz metin olarak kaydedilir
Elle config.tomlDotfiles dosyalarınızı sürüm kontrolünde tutuyor veya her alanı bilmek istiyorsanızmodels.json dosyasını kendiniz yönetirsiniz; yanlış katalog yolu metadatayı sessizce düşürür
CC SwitchDeepSeek, resmi abonelik ve diğer sağlayıcılar arasında sık geçiş yapıyorsanızTek uygulama tüm kimlik bilgilerini tutar ve yerel servis çalıştırır; Codex her geçişte yeniden başlatılmalıdır

Asıl açık soru Pro desteği. Flash, serinin ucuz, hızlı ve yalnızca metinle çalışan yarısı. Çoğu kişinin ajan döngüsünde kullanmak isteyeceği model ise Codex'in gerektirdiği protokolü henüz konuşamıyor. Dipnottaki durum değişene kadar Codex için DeepSeek seçmek, bilinçli biçimde Flash'ı seçmek anlamına geliyor.

İlgili okumalar: Codex vs Claude Code · How to use GLM-5.2 in Claude Code