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, modeli çalıştıran makine. DeepSeek Harness (dsh), şirketin resmi açık kaynaklı “harness”idir. Büyük dil modelini; oturum döngüsü, araç yürütme, izin denetimleri ve yerel web arayüzüyle çalışan bir kodlama aracısına dönüştüren yazılım katmanıdır. DeepSeek V4-Pro’nun API’de yayınlandığı gün piyasaya sürüldü ve VentureBeat bunu Claude Code’un açık kaynaklı rakibi olarak değerlendirdi.

Apidog'u bugün deneyin

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ı. Bu ölçekteki yedi günlük büyüme, koddan çok talebi gösteriyor: geliştiriciler inceleyebilecekleri, değiştirebilecekleri ve farklı modellere yönlendirebilecekleri bir aracı harness’i istiyor.

DeepSeek Harness aslında nedir?

Bir harness, modelin etrafındaki çalışma katmanıdır.

Model jeton tahmin eder. Harness ise şunları yönetir:

• Modelin gördüğü bağlam
• Çağrılabilecek araçlar
• Dosya değişiklikleri ve kabuk komutları için onaylar
• Çok adımlı oturumların durumu
• Oturum kayıtları ve tekrar oynatma

Claude Code, Codex CLI ve Gemini CLI da kendi sağlayıcılarının modellerini saran harness’lerdir. Bu ikisinin karşılaştırması için Claude Code vs Codex CLI yazısına bakabilirsiniz.

DeepSeek Harness’i tanımlayan üç temel özellik vardır:

• Resmidir: DeepSeek AI’ın birinci taraf projesidir; topluluk tarafından oluşturulmuş bir API sarmalayıcısı değildir.
• Açık kaynaklıdır: MIT lisanslıdır. Üçüncü taraf bağımlılıklar depodaki THIRD_PARTY_NOTICES dosyasında belgelenir.
• Geliştirici önizlemesidir: README açıkça şunu belirtir: “GERİ UYUMLULUĞU BOZAN DEĞİŞİKLİKLER OLACAKTIR.”

Bu son maddeyi operasyonel bir uyarı olarak değerlendirin. Yapılandırmalarınız, eklentileriniz ve iş akışlarınız sürümler arasında değişebilir.

dsh, API’de DeepSeek V4-Pro ile birlikte yayınlandı. Model tarafını test ediyorsanız DeepSeek V4-Pro API kılavuzunda uç noktaları, model kimliklerini ve istek örneklerini bulabilirsiniz.

Mimari: her şey bir eklentidir

dsh’nin diğer kodlama aracılarıdan ayrıldığı nokta mimarisidir.

Çoğu harness monolitiktir: aracı döngüsü, model istemcisi, araç tanımları ve oturum deposu tek uygulama içinde gelir. Yapılandırabilirsiniz; bazen genişletebilirsiniz; ancak temel bileşenleri kolayca değiştiremezsiniz.

dsh bunu tersine çevirir. Tasarım ilkesi “her şey bir eklentidir” yaklaşımıdır ve Cordis çerçevesi üzerine kuruludur. Pratikte, normalde birbirine sıkı bağlanmış parçalar değiştirilebilir modüller hâline gelir:

• Model adaptörü: LLM API ile konuşan katman eklentidir. Adaptörü değiştirerek farklı bir model arka ucuna geçebilirsiniz.
• Araç kaydı: Dosya düzenleme, kabuk çalıştırma veya arama gibi araçlar kod içine gömülmez; eklentiler tarafından kaydedilir.
• Oturum günlüğü: Oturumların saklanması ve tekrar oynatılması değiştirilebilir.
• Aracı döngüsü: Karar ver → işlem yap → sonucu gözlemle döngüsünün kendisi de eklenti olarak değiştirilebilir.

Bu yapı özellikle şu senaryolarda yararlıdır:

1. Farklı depolar için farklı araç setleri kullanmak.
2. Bağlam yönetimi stratejilerini denemek.
3. İzin politikalarını ekip veya proje bazında değiştirmek.
4. Aynı aracı deneyimini farklı model sağlayıcılarına taşımak.

Ancak esneklik bir maliyet getirir: değiştirilebilir bileşen sayısı arttıkça arıza alanı da genişler. Geliştirici önizlemesi olarak dsh’yi, üretim standardı yerine deneysel ve genişletilebilir bir platform olarak konumlandırmak daha doğru olur.

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

Yerel web arayüzünü tek komutla başlatın:

npx @deepseek-ai/dsh web

Bu komut:

• Yerel web arayüzünü http://127.0.0.1:3080 adresinde başlatır.
• Varsayılan olarak tarayıcıyı açar.
• Küresel paket kurulumu veya hesap oluşturma gerektirmez.

Tarayıcının otomatik açılmasını engellemek için:

npx @deepseek-ai/dsh web --no-open

Kaynaktan çalıştırmak isterseniz depoyu klonladıktan sonra şu adımları izleyin:

pnpm install
pnpm run build
pnpm dsh web

İlk çalıştırma akışı üç adımdan oluşur.

1. DeepSeek API anahtarını yapılandırın

Ayarlar ekranından DeepSeek API anahtarınızı ekleyin.

Kimlik bilgileri şu dosyada tutulur:

$DSH_HOME/.credentials.yaml

Bu dosya, ana yapılandırma dosyasından ayrı tutulur. Ana ayarlar dosyası doğrudan anahtarı değil, kimlik bilgilerine yönelik referansları barındırır.

2. Bir çalışma alanı seçin

Web arayüzünde çalışma alanı seçeneğini kullanın:

1. Çalışma alanı seç seçeneğine tıklayın.
2. dsh’yi başlattığınız proje dizinini ekleyin.
3. Bu dizini aktif çalışma alanı olarak seçin.

Bu adım zorunludur. Çalışma alanı seçilmeden oturum oluşturucu kullanılamaz.

Böylece dsh, işlem yapmadan önce hangi dosyalar üzerinde düşünebileceğini ve çalışabileceğini açıkça bilir.

3. Görevi çalıştırın ve işlemleri onaylayın

Aracıdan bir görev istediğinizde, aktif izin politikası kapsamında onay gerektiren işlemler için arayüz istem gösterir.

Örneğin:

• Dosya yazma
• Dosya düzenleme
• Kabuk komutu yürütme

Bu işlemler sessizce yürütülmez; onay akışında görünür.

Profiller ve başlıksız kullanım

Web arayüzü tek giriş noktası değildir. dsh, çalışma biçimlerini profil olarak başlatır.

Şu komutlar eşdeğerdir:

dsh web

dsh --profile web

Profil dizinleri şurada bulunur:

$DSH_HOME/profiles/<name>

Betikler veya CI işleri için başlıksız modu kullanabilirsiniz:

dsh --profile headless "job"

Bu mod tek bir oturumu çalıştırır, sonucu yazdırır ve çıkar.

Profil eklentilerini yönetmek için:

dsh plugin

Başlatma yapmadan oluşturulmuş yapılandırmayı incelemek için:

dsh --dump-config
dsh --dump-default-config

Tam bayrak ve komut listesi için CLI README dosyasını inceleyin.

Hangi modelleri çalıştırabilir?

DeepSeek modelleri varsayılan olarak gelir ve V4-Pro ana eşleşmedir.

Maliyet planlaması yapıyorsanız DeepSeek’in yoğun olmayan saat indirimini kalıcı hâle getirdiğini dikkate alın. Bu, sürekli token tüketen aracı iş akışlarında maliyet hesabını etkiler. Ayrıntılar için DeepSeek V4-Pro fiyat indirimi yazısına ve resmi api-docs.deepseek.com referansına bakın.

Model adaptörü eklenti olduğu için dsh yalnızca DeepSeek modelleriyle sınırlı değildir.

Katalog sağlayıcıları

Yerleşik sağlayıcı girişleri şunları kapsar:

• Anthropic
• OpenAI
• Bedrock
• Vertex
• Azure

Her sağlayıcının kendi kimlik bilgisi yönetim yaklaşımı vardır.

Özel sağlayıcılar

OpenAI uyumlu herhangi bir uç noktayı şu dosyada kaydedebilirsiniz:

$DSH_HOME/settings.yaml

Yapılandırma; temel URL, API anahtarı için ortam değişkeni ve model listesi içerir. Bu yaklaşım şunları kapsar:

• Bulut API’leri
• Yerel model çalışma zamanları
• API ağ geçitleri

Bir model seçtiğinizde, o model yeni oturumlar için varsayılan olur. Her oturum başladığı modeli kaydeder; bu nedenle proje sırasında model değiştirmeniz oturum geçmişini karıştırmaz.

Yapılandırma formatı için sağlayıcılar kılavuzunu inceleyin. Özel uç noktalar için tam YAML örnekleri gerekiyorsa DeepSeek Harness’ta herhangi bir modeli nasıl çalıştıracağınız rehberine bakın.

Eklenti ekosistemi

Eklentileri GitHub’daki dsh-plugin başlığı üzerinden keşfedebilirsiniz. Topluluk, GitHub Discussions ve Discord üzerinden koordine olur.

Lansmandan sonraki ilk haftada öne çıkan eklenti türleri şunlardı:

• Masaüstü sarmalayıcıları: deepseek-harness-desktop (Tauri) ve dsh_desktop (Windows), web arayüzünü yerel uygulama olarak paketler.
• Yetkinlik eklentileri: dsh-context ve dsh-vision-router gibi projeler, oturumun görebildiği veya yönlendirebildiği içeriği genişletir.
• MCP desteği: Çekirdekte yerel Model Bağlam Protokolü desteği yoktur; ancak topluluk tarafından geliştirilen dsh-mcp-manager eklentisi MCP ayarları ekler.

Topluluk masaüstü sarmalayıcıları ve eklentileri resmi DeepSeek sürümleri değildir. API anahtarlarınıza veya dosya sisteminize erişebilecek her üçüncü taraf eklentiyi kod incelemesinden geçirin.

MCP desteği nasıl çalışır?

Bu yazı itibarıyla dsh çekirdeği yerel MCP desteği sunmaz.

dsh-mcp-manager eklentisiyle şunları yapılandırabilirsiniz:

• Uzak HTTP MCP sunucuları
• Yerel stdio MCP sunucuları
• OAuth veya statik belirteç kimlik doğrulaması
• mcp__<name>__* biçiminde kaydedilen araçlar
• Çalışma alanının .dsh dizininde proje bazlı sunucu yapılandırmaları

Dolayısıyla “dsh MCP destekliyor” ifadesinin doğru karşılığı şudur: MCP desteği, eklenti mimarisi üzerinden topluluk tarafından sağlanır; çekirdek ürünün yerel özelliği değildir.

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

Bir aracı harness’i, temelde API çağrılarını yöneten bir makinedir:

1. Çalıştırdığı model API’sine çağrı yapar.
2. Çalıştığı proje içindeki araçları ve API’leri kullanır.
3. Kod tabanından ve sağlanan bağlamdan API sözleşmesini anlamaya çalışır.

API’nizin gerçek davranışı spesifikasyonuyla uyuşmuyorsa aracı yanlış sözleşmeye göre kod üretebilir. Sorun genellikle çalışma zamanında ortaya çıkar.

Pratik yaklaşım: aracıya erişim vermeden önce API yüzeyinizi doğrulayın.

Apidog bu iş akışında şu katmanları sağlar:

1. OpenAPI spesifikasyonunu tasarlama veya içe aktarma.
2. Gerçek uç noktaları spesifikasyona karşı test etme.
3. Arka uç geliştirmesi devam ederken sahte sunucu oluşturma.
4. Aracının kararlı ve spesifikasyona uygun yanıtlarla geliştirme yapmasını sağlama.

Doğrulanmış bir sahte sunucuya karşı çalışan aracı, eski koddan API davranışı tahmin eden aracıya göre daha az hatalı entegrasyon üretir.

Doğrudan entegrasyon için Apidog MCP Sunucusu, API spesifikasyonlarınızı MCP üzerinden yapay zeka araçlarına sunar.

dsh tarafındaki akış şöyledir:

1. dsh-mcp-manager eklentisini yükleyin.
2. Apidog MCP Sunucusunu kaydedin.
3. Oturumun API davranışını tahmin etmesi yerine gerçek spesifikasyonu sorgulamasını sağlayın.

Aracının tetikleyebileceği CLI tabanlı test çalıştırmaları da dahil olmak üzere tüm akış için DeepSeek Harness’ta Apidog CLI kullanma rehberine bakın.

Başlamadan önce API tarafını hazırlamak isterseniz Apidog’u indirin ve spesifikasyonunuzu içe aktarın.

Şimdi mi denemelisiniz, beklemeli misiniz?

Karar, kullanım amacınıza bağlıdır.

Şimdi deneyin, eğer

• Aracı harness’lerinin iç yapısını anlamak istiyorsanız.
• Farklı görevlerde farklı modeller çalıştırmanız gerekiyorsa.
• Kendi barındırdığınız modelleri kullanıyorsanız.
• Eklenti geliştiriyorsanız.
• Halihazırda DeepSeek API kullanıyorsanız ve V4-Pro için birinci taraf aracı deneyimi istiyorsanız.

Bekleyin, eğer

• Günlük kullanım için stabil bir araca ihtiyacınız varsa.
• Kuruluşunuz doğrulanmış ve desteklenen araçlar gerektiriyorsa.
• Kimlik bilgilerini işleyen topluluk eklentilerinin riskini kabul edemiyorsanız.
• Olgun harness’lerdeki ergonomi ve kararlılık seviyesine ihtiyacınız varsa.

Çoğu geliştirici için pragmatik yaklaşım şudur:

1. Üretim işleri için mevcut aracınızı kullanmaya devam edin.
2. dsh’yi yan proje veya izole bir depo üzerinde deneyin.
3. Eklenti ve yapılandırma değişikliklerini sürüm yükseltmelerinden önce test edin.
4. Önizleme etiketi kalkmadan önce kendi kullanım senaryonuza göre değerlendirme yapın.

Claude Code ile doğrudan karşılaştırma için DeepSeek Harness vs Claude Code yazısına bakın.

Sıkça Sorulan Sorular

DeepSeek Harness ücretsiz mi?

Harness’in kendisi MIT lisansı altında ücretsiz ve açık kaynaklıdır.

Maliyet, arkasındaki modele aittir:

• DeepSeek platformu kullanıyorsanız API kullanımı DeepSeek tarafından faturalandırılır.
• Başka bir sağlayıcı yapılandırdıysanız o sağlayıcının fiyatlandırması geçerlidir.
• Yerel olarak barındırılan bir modele yönlendirirseniz token başına API ücreti ödemezsiniz.

Yerel veya özel model yapılandırması için DeepSeek Harness’ta herhangi bir modeli çalıştırma rehberini kullanın.

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

Hayır.

DeepSeek modelleri varsayılan olsa da model adaptörü eklentidir. Katalog sağlayıcıları Anthropic, OpenAI, Bedrock, Vertex ve Azure’u kapsar. OpenAI uyumlu başka bir uç noktayı da $DSH_HOME/settings.yaml üzerinden ekleyebilirsiniz.

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

Güvenlik, izin modeli ve sizin denetimleriniz kadar güçlüdür.

dsh şunları yapar:

• Oturum başlatmadan önce çalışma alanı seçmenizi ister.
• Aktif izin politikası kapsamında onay gerektiren işlemler için istem gösterir.
• Dosya yazma ve kabuk çalıştırma gibi işlemleri görünür hâle getirir.

Ancak bu bir geliştirici önizlemesidir. Ayrıca topluluk eklentileri ve masaüstü sarmalayıcıları API anahtarlarınızı işleyebilecek üçüncü taraf kodlardır.

Uygulama önerisi:

1. Eklenti kaynak kodunu veya bakım geçmişini inceleyin.
2. İlk denemeleri izole bir depo üzerinde yapın.
3. Kritik depolarda ayrı çalışma alanları ve sınırlı izinler kullanın.
4. Hatalı düzenlemenin zarar vereceği kod tabanlarında önizleme sürümünü doğrudan çalıştırmayın.

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

Model, mantık yürütme ve token üretme motorudur.

Harness ise modelin işlem yapmasını sağlayan katmandır:

• Oturum yönetimi
• Araç çağrıları
• Dosya erişimi
• İzin istemleri
• Bağlam derleme
• Sonuçların kaydedilmesi

Aynı modeli kullanan iki aracı, farklı harness’ler kullandıkları için tamamen farklı davranabilir. Bu nedenle kodlama aracıları arasındaki rekabetin önemli bölümü harness katmanında gerçekleşir.