DeepSeek Harness (dsh) Nedir? Açık Kaynak Claude Kod Rakibi Detaylı İnceleme

DeepSeek, 13 Ağustos 2026'da alışılmadık bir şey yayınladı: bir model değil, bir modeli çalıştıran makine. DeepSeek Harness (dsh), şirketin resmi açık kaynaklı aracı "harness"idir. Büyük bir dil modelini, oturum döngüsü, araç yürütme, izin denetimleri ve yerel bir web arayüzü ile çalışan bir kodlama aracısına dönüştüren yazılım katmanıdır. DeepSeek V4-Pro'nun API'da yayınlandığı gün piyasaya sürüldü ve VentureBeat bunu Claude Code'un açık kaynaklı bir rakibi olarak değerlendirdi.

Geliştirici topluluğu hızla tepki verdi. 20 Ağustos itibarıyla, deepseek-harness deposu yayınlandıktan bir hafta sonra yaklaşık 169.000 yıldıza ve 18.100 çatallanmaya ulaştı. Yedi gün içinde bu büyüklükteki sayılar, kod hakkında daha az, iştah hakkında daha çok şey söylüyor: geliştiriciler, inceleyebilecekleri, değiştirebilecekleri ve herhangi bir modele yönlendirebilecekleri bir aracı "harness"i istiyor.

düğme

DeepSeek Harness aslında nedir?

Bir "harness", modelin etrafındaki her şeydir. Model jetonları tahmin eder. "Harness", modelin ne gördüğüne, hangi araçları çağırabileceğine, dosya düzenlemelerinin ve kabuk komutlarının nasıl onaylandığına ve çok adımlı bir oturumun nasıl bir arada tutulduğuna karar verir. Claude Code, Codex CLI ve Gemini CLI'ın hepsi, kendi tedarikçilerinin modellerini saran "harness"lerdir. Bu ikisinin nasıl karşılaştırıldığı hakkında bilgi almak isterseniz, bunu Claude Code vs Codex CLI yazımızda ele aldık.

DeepSeek Harness, bu kategoride DeepSeek'in girişimidir ve çerçeveyi belirleyen üç özelliği vardır:

• Resmidir. Bu, DeepSeek AI'dan birinci taraf bir projedir, API'ları etrafında topluluk tarafından oluşturulmuş bir sarmalayıcı değildir.
• Açık kaynaklıdır. MIT lisanslıdır ve üçüncü taraf bağımlılıkları deponun THIRD_PARTY_NOTICES dosyasında belgelenmiştir. Kod tabanınıza güvendiğiniz aracı döngüsünü okuyabilirsiniz.
• Bir geliştirici önizlemesidir. README, kelimesi kelimesine şöyle uyarıyor: "GERİ UYUMLULUĞU BOZAN DEĞİŞİKLİKLER OLACAKTIR." Bunu olduğu gibi kabul edin. Uygulamada ne anlama geldiği aşağıda daha fazla açıklanmıştır.

Lansman zamanlaması da önemlidir. dsh, API'da DeepSeek V4-Pro ile birlikte geldi, böylece "harness" ve amiral gemisi varsayılan modeli bir ikili olarak piyasaya sürüldü. Model tarafını değerlendiriyorsanız, DeepSeek V4-Pro API kılavuzumuz uç noktaları, model kimliklerini ve istek örneklerini kapsamaktadır.

Mimari: her şey bir eklentidir

dsh'nin ana akım kodlama aracılarıdan ayrıştığı nokta burasıdır. Çoğu "harness" monolitiktir. Aracı döngüsü, model istemcisi, araç tanımları ve oturum deposu tek bir uygulama olarak gönderilir. Bunları yapılandırabilir, bazen genişletebilirsiniz, ancak temel parçalarını değiştiremezsiniz.

dsh bunu tersine çevirir. Tasarım prensibi "her şey bir eklentidir" ve Cordis adlı bir çerçeve üzerine kuruludur. Bu çerçevenin tasarımı "Spatiotemporal Composability için Bir Programlama Paradigması" başlıklı bir makalede açıklanmıştır. Akademik başlığı bir kenara bırakırsak, pratik iddia şudur: genellikle birbirine kaynaklanmış olan bir aracının parçaları, dsh'de değiştirilebilir modüllerdir. Bunlar şunları içerir:

• Model adaptörü. LLM API ile konuşan katman bir eklentidir. Bunu değiştirin ve dsh farklı bir arka ucu sürer.
• Araç kaydı. Aracının çağırabileceği araçlar (dosya düzenlemeleri, kabuk, arama) eklentiler tarafından kaydedilir, kodlanmaz.
• Oturum günlüğü. Oturumların nasıl kaydedildiği ve tekrar oynatıldığı takılıp çıkarılabilir.
• Aracı döngüsünün kendisi. Hatta çekirdek karar verme-hareket etme-gözlemleme döngüsü bile değiştirebileceğiniz bir eklentidir.

Bu neden önemli? Çünkü 2026'da gerçek deneyler "harness" katmanında gerçekleşiyor. Ekipler farklı bağlam yönetimi stratejileri, farklı izin modelleri, farklı depolar için farklı araç setleri denemek istiyor. Monolitik bir aracıyla satıcının fikrinizi göndermesini beklersiniz. dsh ile bir eklenti yazarsınız.

Taviz de aynı derecede gerçektir. Her şeyin değiştirilebilir olduğu bir sistemin arıza alanı daha geniştir ve geriye uyumluluğu bozan değişiklikler vaat eden bir geliştirici önizlemesi, yol boyunca eklentileri bozacaktır. dsh'nin sizden yapmanızı istediği bahis budur: şimdi esneklik, sonra istikrar.

Hızlı başlangıç: sıfırdan çalışan bir aracıya

Kurulum yolu tek bir komuttur:

npx @deepseek-ai/dsh web

Bu, http://127.0.0.1:3080 adresinde yerel bir web kullanıcı arayüzü başlatır ve tarayıcınızı o adrese açar (açmasını istemiyorsanız --no-open parametresini geçirin). Küresel kurulum yok, kapı olarak hesap oluşturma yok.

Kaynaktan derlemeyi tercih ederseniz, depo yolu da işe yarar: depoyu klonlayın, ardından pnpm install, pnpm run build ve pnpm dsh web komutlarını çalıştırın.

Oradan, ilk çalıştırma akışı üç adımdan oluşur:

1. Ayarlarda bir DeepSeek API anahtarı yapılandırın. Anahtarlar $DSH_HOME/.credentials.yaml dosyasında bulunur ve ana ayarlar dosyasından ayrı tutulur, bu dosya yalnızca onlara referansları barındırır.
2. Bir çalışma alanı seçin. "Çalışma alanı seç"e tıklayın, dsh'yi başlattığınız proje dizinini ekleyin ve onu seçin. Bu adım isteğe bağlı değildir: bir çalışma alanı seçilene kadar oturum oluşturucu kullanılamaz kalır. dsh, herhangi bir şey çalıştırmadan önce "hangi dosyalar hakkında düşünmeme izin var" sorusuna açık bir yanıt ister.
3. Bir görev çalıştırın ve işlemleri onaylayın. Web kullanıcı arayüzü, "aktif izin politikası kapsamında onay gerektiren" işlemlerden önce sorar. Dosya yazma ve kabuk komutları sessizce yürütülmek yerine istemler olarak yüzeye çıkar.

Web kullanıcı arayüzü yalnızca bir giriş noktasıdır. Kaputun altında, dsh profilleri başlatır: dsh web, dsh --profile web için bir kısaltmadır ve profiller $DSH_HOME/profiles/<name> altında bulunur. Tek bir yeni oturumu yürüten, sonucu yazdıran ve çıkan başlıksız bir mod (dsh --profile headless "job") vardır; bu, betikler ve CI için istediğiniz şekildir. Bir dsh plugin alt komutu, profil dizinindeki pnpm'ye yönlendirerek bir profilin eklentilerini yönetir ve --dump-config ve --dump-default-config gibi başlatıcı bayrakları, oluşturulmuş yapılandırma ağacını önyükleme yapmadan yazdırır. Tam liste CLI README dosyasındadır.

Hangi modelleri çalıştırabilir?

DeepSeek modelleri varsayılan olarak gelir ve V4-Pro ana eşleşmedir. Maliyet tarafında bilmekte fayda var: DeepSeek, yoğun olmayan saatlerdeki indirimini kalıcı hale getirdi, bu da tüm gün jeton yakan bir aracı çalıştırmanın ekonomisini değiştiriyor. Detaylar DeepSeek V4-Pro fiyat indirimi hakkındaki yazımızda ve resmi referans api-docs.deepseek.com adresinde bulunmaktadır.

Ancak model adaptörü bir eklentidir ve dsh bunu destekler. Varsayılanın ötesinde iki yol mevcuttur:

• Katalog sağlayıcıları. Anthropic, OpenAI, Bedrock, Vertex ve Azure için yerleşik sağlayıcı girişleri, her biri sağlayıcıya özgü kimlik bilgisi yönetimine sahiptir.
• Özel sağlayıcılar. Herhangi bir OpenAI uyumlu uç nokta, $DSH_HOME/settings.yaml dosyasında temel bir URL, anahtar için bir ortam değişkeni ve bir model listesi ile kaydedilebilir. Bu, yalnızca bulut API'lerini değil, yerel çalışma zamanlarını ve ağ geçitlerini de kapsar.

Bir model seçmek, onu yeni oturumlar için varsayılan yapar ve her oturum, başladığı modeli kaydeder, bu nedenle proje ortasında geçiş yapmak geçmişinizi karıştırmaz. Sağlayıcılar kılavuzu yapılandırma formatını belgeler. Bu bölümü kasıtlı olarak kısa tutuyoruz: özel uç noktalar için tam YAML dahil olmak üzere tüm rehber, DeepSeek Harness'ta herhangi bir modeli nasıl çalıştıracağınız makalesindedir.

Eklenti ekosistemi, bir hafta sonra

Eklentiler dsh-plugin GitHub başlığı aracılığıyla keşfedilir ve topluluk GitHub Tartışmaları ve bir Discord sunucusu aracılığıyla koordine olur. Lansmandan bir hafta sonra, ekosistem şimdiden talebin şeklini gösteriyor:

• Masaüstü sarmalayıcıları. deepseek-harness-desktop (Tauri) ve dsh_desktop (Windows) gibi projeler, web kullanıcı arayüzünü yerel bir uygulama olarak paketler. Bunlar resmi DeepSeek sürümleri değil, topluluk projeleridir, bu nedenle API anahtarlarınıza dokunan herhangi bir üçüncü taraf sarmalayıcıya uygulayacağınız incelemeyi bunlara da uygulayın.
• Yetkinlik eklentileri. dsh-context ve dsh-vision-router gibi topluluk depoları, oturumların ne görebileceğini ve yönlendirebileceğini genişletir. Aynı uyarı: topluluk tarafından oluşturulmuştur.
• MCP desteği. Bu yazı itibarıyla dsh, çekirdeğinde yerel Model Bağlam Protokolü desteği sunmuyor. Mevcut olan, MCP için bir Ayarlar sayfası ekleyen topluluk eklentisi olan dsh-mcp-manager'dır: uzak HTTP veya yerel stdio sunucuları, OAuth veya statik belirteç kimlik doğrulaması, mcp__<name>__* adları altında kaydedilen araçlar ve çalışma alanının .dsh dizini içinde projelere özel sunucu yapılandırmaları.

Bu son nokta vurguyu hak ediyor çünkü yanlış anlaşılması kolaydır. dsh'nin "MCP'yi desteklediğini" iddia eden bir yazı okursanız, doğru versiyon şudur: topluluk, her şeyin bir eklenti olduğu mimarinin tam olarak amacı olan bir eklenti olarak MCP desteğini oluşturmuştur. Çekirdek, bunu daha sonra bünyesine katabilir. Henüz katmadı.

API iş akışınız nereye sığıyor?

Bir aracı "harness"i, özünde, API çağrılarını yürüten bir makinedir: sürdüğü model API'si ve onu işaret ettiğiniz projenin içindeki API'ler. dsh, arka ucunuza karşı kod yazdığında, uç noktalarınız hakkındaki kod tabanından kazıyabileceği herhangi bir anlayışla çalışır. API'nizin gerçek davranışı spesifikasyonuna uymuyorsa, aracı yanlış sözleşmeye güvenerek kod yazar ve bunu çalışma zamanında fark edersiniz.

Çözüm sıkıcı ama etkili: aracı ona dokunmadan önce API yüzeyini doğrulayın. Apidog bu katmanı kapsar. OpenAPI spesifikasyonunu tasarlayın veya içe aktarın, gerçek uç noktaları buna göre test edin ve arka uç hareket halindeyken bile aracının kararlı, spesifikasyona uygun yanıtlara karşı geliştirme yapabilmesi için sahte sunucular kurun. Doğrulanmış bir sahte sunucuya karşı yineleme yapan bir aracı, eski koddan tahmin yürüten bir aracıdan çok daha az halüsinasyonlu entegrasyon üretir.

Doğrudan bir entegrasyon yolu da var. Apidog MCP Sunucusu, API spesifikasyonlarınızı MCP üzerinden yapay zeka araçlarına sunar. dsh'de bu, yukarıda açıklanan topluluk dsh-mcp-manager eklentisi aracılığıyla gerçekleşir: eklentiyi yükleyin, Apidog MCP Sunucusunu kaydedin ve oturumlar speğinizi çıkarım yapmak yerine gerçek spesifikasyonunuzu sorgulayabilir. Aracının kendisinin tetikleyebileceği CLI tabanlı test çalıştırmaları dahil olmak üzere tüm döngüyü, DeepSeek Harness'ta Apidog CLI kullanma makalesinde ele alıyoruz. Denemeden önce API tarafını hazır hale getirmek istiyorsanız, önce Apidog'u İndirin ve speğinizi içe aktarın. Bu, en büyük aracı hatası kaynağını ortadan kaldıran beş dakikalık bir kurulumdur.

Şimdi mi denemelisiniz yoksa beklemeli misiniz?

Dürüst cevap, onu ne için kullanacağınıza bağlıdır.

Şimdi deneyin eğer:

• Aracı "harness"lerinin dahili olarak nasıl çalıştığını anlamak istiyorsanız. dsh, mevcut en incelenebilir büyük "harness"tir ve gerçek bir aracı döngüsünü okumak, herhangi bir blog yazısından daha fazlasını öğretir.
• Model esnekliğine ihtiyacınız varsa. Ekibiniz farklı görevler için farklı modeller çalıştırıyorsa veya kendi kendine barındırıyorsa, takılabilir model adaptörü, monolitik aracıların size sunmayacağı bir özelliktir.
• Araçlar geliştiriyorsanız. Eklenti ekosistemi bir haftalıktır. Bu kadar dikkat çeken bir depodaki erken eklenti yazarları orantısız görünürlük elde eder.
• Zaten DeepSeek'in API'ını kullanıyorsanız ve V4-Pro için birinci taraf aracı deneyimini istiyorsanız.

Bekleyin eğer:

• Stabil bir günlük sürücüye ihtiyacınız varsa. "GERİ UYUMLULUĞU BOZAN DEĞİŞİKLİKLER OLACAKTIR" pazarlama mütevazılığı değil, bir vaattir. Yapılandırmanız, eklentileriniz ve kas hafızanız sürümler arasında bozulabilir.
• Kuruluşunuz doğrulanmış, desteklenen araçlar gerektiriyorsa. Kimlik bilgilerini yöneten topluluk eklentilerine sahip bir geliştirici önizlemesi, bir destek sözleşmesi olan GA ürününden farklı bir risk profiline sahiptir.
• Olgun "harness"lerin cilasını istiyorsanız. Claude Code, ergonomi konusunda uzun bir başlangıç avantajına sahipti ve bir haftalık bir önizleme henüz her yerde ona yetişemez.

Çoğu çalışan geliştirici için pragmatik hareket ikisidir: üretim işleri için mevcut aracınızı kullanmaya devam edin, dsh'yi bir yan projede çalıştırın ve önizleme etiketi kalkmadan önce kendi fikrinizi oluşturun. Ana sorunuz, mevcut rakibe karşı nasıl durduğu ise, DeepSeek Harness vs Claude Code yazımızda yan yana karşılaştırmayı yaptık.

Sıkça Sorulan Sorular

DeepSeek Harness ücretsiz mi?

"Harness"ın kendisi MIT lisansı altında ücretsiz ve açık kaynaktır. Maliyeti olan, arkasındaki modeldir: DeepSeek platformundaki (veya yapılandırdığınız sağlayıcıdaki) API kullanımı, o sağlayıcı tarafından normal şekilde faturalandırılır. Adaptör katmanı takılıp çıkarılabilir olduğundan, dsh'yi yerel olarak barındırılan bir modele de yönlendirebilir ve jeton başına hiçbir şey ödemezsiniz; kurulum için DeepSeek Harness'ta herhangi bir modeli çalıştırma makalesine bakın.

dsh yalnızca DeepSeek modelleriyle mi çalışır?

Hayır. DeepSeek modelleri varsayılandır, ancak model adaptörü bir eklentidir. Katalog sağlayıcıları Anthropic, OpenAI, Bedrock, Vertex ve Azure'u kapsar ve herhangi bir OpenAI uyumlu uç nokta $DSH_HOME/settings.yaml aracılığıyla eklenebilir.

DeepSeek Harness kod tabanımda çalıştırmak için güvenli mi?

İzin modeli artı yargınız kadar güvenlidir. Web kullanıcı arayüzü, herhangi bir oturum çalışmadan önce bir çalışma alanı seçmenizi gerektirir ve aktif izin politikası kapsamında onay gerektiren işlemlerden önce istemler sunar. Bununla birlikte, bu bir geliştirici önizlemesidir ve topluluk eklentileri (masaüstü sarmalayıcıları dahil) API anahtarlarınızı işleyebilecek üçüncü taraf kodlardır. Ne yüklediğinizi gözden geçirin ve hatalı bir düzenlemenin zarar vereceği depolardan önizlemeyi uzak tutun.

Bir "harness" modelden nasıl farklıdır?

Model, mantık yürütme motorudur; "harness" ise onun hareket etmesini sağlayan her şeydir. Oturum yönetimi, araç çağrıları, dosya erişimi, izin istemleri ve bağlam derlemesi hepsi "harness" içinde yer alır. Aynı modeli kullanan iki aracı, "harness"leri farklı olduğu için tamamen farklı davranabilir, bu nedenle "harness" katmanı, çoğu kodlama aracı rekabetinin şu anda gerçekleştiği yerdir.