DeepSeek Harness: Neler Sunuyor, Nasıl Kurulur?

DeepSeek'in V4-Pro ve V4-Flash modelleri için geliştirdiği coding-agent katmanı DeepSeek Harness, 13 Ağustos 2026'da @deepseek-ai/dsh npm paketiyle yayınlandı. Aynı gün V4-Pro da genel kullanıma açıldı. Standart bir DeepSeek API anahtarıyla çalışan DSH, dört adımda kuruluyor ve eklenti sistemiyle geliyor. Ancak kuruluma geçmeden önce önemli bir ayrıntı var: Mayıs ayından beri PyPI'da bulunan ve yine dsh komutunu sağlayan deepseek-harness adlı Python paketi, bununla tamamen ilgisiz bir araç.

DeepSeek Harness (DSH) ne işe yarıyor?

Bir coding-agent harness'i; bağlamın seçilmesi, araç çağrılarındaki hataların ele alınması, planın yeniden kurulması ve görevin tamamlandığının anlaşılması gibi işleri modelin çevresinde yönetir. Model aynı kalsa bile benchmark sonuçları harness yapılandırmasına göre değişebilir. DeepSeek'in agent değerlendirmelerinde yalnızca ham model skorlarını vermek yerine harness ayarlarını da açıklamasının nedeni bu.

Tanıdık örnekler üzerinden düşünürsek: Claude Code, Anthropic'in Claude modelleri için bir harness; Cursor, birden fazla sağlayıcıyı IDE içinde bir araya getiriyor; GitHub Copilot ise VS Code içinde OpenAI modelleri için bu rolü üstleniyor. Model ile harness birleştiğinde agent ortaya çıkıyor: Tek seferlik sorulara yanıt vermenin ötesinde dosya düzenleyebilen, komut çalıştırabilen ve API çağırabilen bir sistem. DSH de V4-Pro ve V4-Flash için bu görevi görüyor.

DSH, Claude Code'un Sonnet ve Opus için tasarlandığı mantıkla V4-Pro ve V4-Flash'a yönelik geliştirilmiş DeepSeek'in birinci taraf harness'i. 31 Temmuz tarihli V4-Flash beta değişiklik kaydı, araçtan ilk kez açıkça söz etti. Kayıtta agent benchmark'larının effort=max, top_p=0.95 ve temperature=1.0 ayarlarıyla "DeepSeek Harness minimal mode (to be released soon)" kullanılarak üretildiği yazıyordu.

"Minimal mode", benchmark'a özel ince ayar yapmak yerine agent benchmark'larının yeniden üretilebilir olmasını hedefleyen sadeleştirilmiş bir yapılandırma. Maksimum çıkarım eforu ve sabit örnekleme parametreleri kullanıyor. Beta haberlerinde işaret edilen eklenti sistemi de düşünüldüğünde, tam ürünün yayınlanan skorları üreten benchmark çalıştırıcısından daha geniş kapsamlı olduğu anlaşılıyor.

V4-Pro ve V4-Flash'ın ikisi de 1M token bağlam penceresi ile üç çıkarım eforu ayarını destekliyor: basit işler için low, normal agent işleri için high, karmaşık görevler içinse max (resmi değişiklik kaydı, 13 Ağustos girdisi).

@deepseek-ai/dsh kurulumu

Node.js 18 veya daha yeni bir sürüm gerekiyor. Bu, DeepSeek'in resmi Claude Code entegrasyon rehberinde de belirtilen taban sürüm.

1. Node sürümünü kontrol edin: node --version (18+ gerekli; macOS'ta kurulu değilse brew install node).
2. Paketi global olarak yükleyin: npm install -g @deepseek-ai/dsh.
3. Anahtarınızı tanımlayın: DeepSeek platformundan aldığınız anahtarla export DEEPSEEK_API_KEY=<your key> komutunu kullanın.
4. Çalıştırın: cd /path/to/my-project && dsh.

macOS'ta global npm kurulumu sırasında yetki hatalarına sık rastlanıyor. npm'nin önerdiği çözüm, kullanıcının yazabildiği bir global prefix yapılandırmak: npm config set prefix ~/.npm-global. sudo da işe yarar; ancak sonraki paket güncellemelerinde sahiplik çakışmalarına yol açabilir.

Harness yazılımı için ayrıca açıklanmış bir ücret yok. Buna karşılık, arkasındaki model API'sinin fiyatlandırması 16 Ağustos 16:00 UTC itibarıyla değişiyor: V4 ailesi peak/off-peak tarifesine geçiyor ve off-peak fiyatı peak fiyatının yarısı olacak (resmi değişiklik kaydı).

V4-Pro GA benchmark'larında Harness etkisi

DeepSeek'in 13 Ağustos tarihli değişiklik kaydında yayımladığı resmi skorlar aşağıda yer alıyor. Tüm sonuçlar, yukarıda açıklanan harness yapılandırmasıyla elde edildi:

V4-Pro, bu benchmark'larda Flash'ı 0.5 ila 8.3 puan arasında geçiyor. En büyük farklar DeepSWE'de (+8.3) ve NL2Repo'da (+7.3). 87.9'luk Terminal Bench 2.1 sonucu ise öne çıkan skor. r/LocalLLaMA'daki bağımsız public-harness tekrarı, Flash 0731 için 445 denemede 82.7 sonucuna ulaştı; bu da yapılandırma farklarından doğan oynama payı içinde DeepSeek'in iddiasıyla örtüşüyor. DSBench-FullStack ve DSBench-Hard dahili değerlendirme setleri olduğundan, bu iki satırdaki sonuçlar DeepSeek'in kendi ölçümleri.

Yayımlanan benchmark'ların tamamı max efor ayarında çalıştırıldı. DeepSeek'in üretim kullanımı önerisi ise basit görevlerde low, sıradan agent işlerinde high, karmaşık işlerde de max kullanılması yönünde.

@deepseek-ai/dsh ile pip install deepseek-harness aynı şey değil

İsimleri neredeyse aynı olan bu iki paket, aylar arayla yayınlandı ve birbirleriyle bağlantılı değiller.

PyPI projesi bir coding agent değil, protokol adaptör kütüphanesi. Yazarı, 270'ten fazla denemede V4 API'sinin 16 davranışını belgelemiş ve bunları dört formatta dağıtılan 10 kurallı bir sözleşmeye dönüştürmüş: Python kütüphanesi, dsh CLI, MCP sunucusu ve Anthropic Skill. V4 üzerinde geliştirme yaparken en çok sorun çıkarabilecek üç bulgu şöyle:

• Çok turlu araç döngüleri, assistant mesajlarında reasoning_content korunmadığında HTTP 400 dönüyor. Bu durum iki modelde de 3/3 kez yeniden üretildi.
• /beta uç noktası, v4-pro isteğini sessizce deepseek-reasoner modeline eşliyor.
• 1,024 tokenlık bir prefix sonrasında cache hit'leri 256 tokenlık bloklar halinde görünmeye başlıyor. Beş turlu bir döngüde %95 denge noktasına ulaşıldı; bu da efektif girdi maliyetini yaklaşık 50 kat düşürdü.

Karışıklığın temel nedeni, iki paketin de dsh komutunu sunması. pip ile kurulum yaptıysanız adaptör kütüphanesini yüklemiş olursunuz. npm üzerinden @deepseek-ai scope'u altındaki paketi yüklediyseniz ise harness sizdedir.

DSH olmadan DeepSeek V4 ile coding agent kullanmak

DSH belgeleri oturmadan önce DeepSeek destekli bir coding agent kullanmak istiyorsanız, DeepSeek'in resmi entegrasyon rehberi üç desteklenen seçeneği açıklıyor:

Claude Code yapılandırması, DeepSeek modellerini Claude Code içindeki ilgili slotlara eşliyor:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Dikkat edilmesi gereken bir eşleme ayrıntısı var: claude-sonnet istekleri Pro'ya değil Flash'a yönleniyor. DeepSeek belgeleri Pro'yu Opus slotuna, Flash'ı ise Haiku slotuna yerleştiriyor. Üç araç da DeepSeek'in etkinlik veya güvenlik garantisi vermediği üçüncü taraf entegrasyonları olarak belgelenmiş durumda. Daha geniş bir karşılaştırma için coding-agent LLM karşılaştırmamıza ve V4-Pro GA API rehberine bakabilirsiniz.

SSS

@deepseek-ai/dsh, resmi DeepSeek Harness paketi mi?

@deepseek-ai npm scope'u, DeepSeek'in GitHub organizasyonuyla eşleşiyor; yayın tarihi de 31 Temmuz değişiklik kaydında verilen zamanlamayla uyumlu. Topluluk paylaşımları paketin kurulabildiğini doğruluyor. Buna karşın DeepSeek'in 13 Ağustos tarihli değişiklik kaydı V4-Pro GA'den bahsediyor ancak harness'in adını anmıyor; npm de paket sayfasının otomatik olarak doğrulanmasını engelliyor.

DSH ile PyPI'daki deepseek-harness arasındaki fark ne?

Bunlar farklı geliştiricilere ait, ayrı ürünler. @deepseek-ai/dsh, 13 Ağustos'ta yayınlanan npm tabanlı coding-agent harness'i. pip install deepseek-harness ise Henry Zhang tarafından geliştirilen, V4 API tuhaflıklarını ele alan bağımsız bir Python protokol adaptör kütüphanesini kurar; lisansı MIT, yayın tarihi 9 Mayıs. Her ikisi de dsh komutunu sunuyor.

DSH kullanmak için DeepSeek API anahtarı gerekiyor mu?

Evet. Harness, DeepSeek API üzerinden V4-Pro ve V4-Flash ile çalışıyor; dolayısıyla kullanım token başına ücretlendiriliyor. npm paketi ücretsiz kuruluyor, maliyet API tüketiminden kaynaklanıyor. V4 ailesinin fiyatlandırması 16 Ağustos 16:00 UTC itibarıyla peak/off-peak tarifesine geçiyor; off-peak fiyatı peak fiyatının yarısı.

DSH, Claude Code karşısında nerede duruyor?

Claude Code, terminal tabanlı ve iyi belgelenmiş olgun bir coding agent. Anthropic uyumlu uç nokta sayesinde DeepSeek üzerinde de çalışabiliyor. DSH'nin iddiası ise modele özgü optimizasyon: V4'ün protokol davranışına sonradan uyarlanan değil, bu davranışlar etrafında tasarlanan bir harness. Benchmark yapılandırmasının açıklanması bu avantajı makul kılıyor; ancak DSH belgeleri ve topluluk testleri yetişene kadar bağımsız kullanımda kanıtlanmış sayılmaz.

AI harness ile AI agent arasındaki fark nedir?

Harness, altyapı katmanıdır: bağlam yönetimi, araç yönlendirme ve görev orkestrasyonu gibi işleri üstlenir. Agent ise modelin bir harness içinde çalıştığı, çok adımlı eylemler gerçekleştirebilen birleşik sistemdir. Her agent'in bir harness'e ihtiyacı vardır, fakat aynı harness farklı modellere hizmet verebilir. Claude Code, Cursor, Copilot ve DSH'nin tamamı harness'tir; onları "agent" yapan, içlerinde çalışan modeldir.

Yayın durumu: Resmi olarak doğrulananlar ve topluluk bilgileri

Bu makaledeki bilgiler iki farklı kanıt düzeyine dayanıyor.

Resmi olarak doğrulananlar (tarihli DeepSeek API değişiklik kaydı girdileri):

• deepseek-v4-pro, 13 Ağustos'ta yerel OpenAI Responses API desteği ve üç çıkarım eforu seviyesiyle GA'ya ulaştı (değişiklik kaydı).
• V4-Flash, 31 Temmuz'da herkese açık betaya girdi; benchmark'ları "DeepSeek Harness minimal mode (to be released soon)" kullanılarak üretildi.
• Yayımlanan tüm V4-Pro GA ve V4-Flash beta benchmark sayıları bu değişiklik kaydı girdilerinden geliyor.
• V4 ailesi fiyatlandırması 16 Ağustos 16:00 UTC itibarıyla peak/off-peak tarifesine geçiyor.
• Claude Code, OpenCode ve OpenClaw entegrasyon rehberi resmi dokümantasyon niteliğinde.

Topluluk tarafından bildirilenler (Reddit gönderileri, yeniden üretilmiş ekran görüntüleri):

• @deepseek-ai/dsh kurulabiliyor ve çalışıyor. u/Testx01, 13 Ağustos'ta 12:56 UTC'de paket bağlantısını paylaştı; u/Available_Yam_6267 birkaç dakika sonra bunu takip etti. @deepseek-ai npm scope'u, DeepSeek'in GitHub organizasyonuyla eşleşiyor.
• npm'nin paket sayfası otomatik istekleri engellediği için sürüm, lisans ve geliştirici meta verileri registry üzerinden doğrulanamıyor.

"Deepseek harness is out on npm :)" — u/Testx01, r/DeepSeek, 13 Ağustos

• Yeniden üretilmiş bir dahili beta mesajı, 369 üyeli beta grubunun 11 Ağustos'ta son dahili sürümü yayımladığını anlatıyor. Mesajda, eklenti geliştiricilerinden 13 Ağustos'taki herkese açık beta öncesinde depolarını #dsh etiketiyle işaretlemeleri istendiği; eklentilerin yayın sonrası kişisel hesaplara taşınabilir hâle geleceği de belirtiliyor.
• Topluluk haberleri, Çin teknoloji basınında Mayıs ayında çıkan ve DeepSeek'in özel bir harness ekibi kurduğu, Agent Harness ürün rolleri için işe alım yaptığı yönündeki haberlere atıf yaptı.

DeepSeek kendi sitesinde resmi belgeleri yayımlayana kadar DSH'nin özellikleri, CLI'ı ve eklenti sistemiyle ilgili iddiaları yalnızca topluluk tarafından doğrulanmış bilgiler olarak değerlendirin.