DeepSeek Harness Nedir? Kurulum ve Fiyat

Claude Code’un yaptığı işi yapan, kaynağı açık ve kendi modelinizi taktığınız bir ajan. DeepSeek Harness kısaca bu. Ağustos ortasından beri GitHub’da duruyordu ve geliştiriciler onu terminalden ya da tarayıcıdan çalıştırıyordu. Bugün DeepSeek, Node.js kurmadan açılan bir masaüstü uygulaması yayımladı. Depo 240 bine yakın yıldıza ulaşmış durumda. Bu yazıda ne olduğunu, nasıl kurulduğunu, neye mal olduğunu ve Claude Code’dan nerede ayrıldığını anlatıyorum.

DeepSeek Harness Nedir?

“Harness”, bir dil modelinin etrafına kurulan ve ona dosya okuma, komut çalıştırma, plan tutma, alt ajana iş devretme gibi yetenekler veren katmanın adı. Claude Code, Codex CLI ve opencode da birer harness. Aynı modelin hangi harness içinde çalıştığı hem başarıyı hem faturayı değiştiriyor; bunu Codex ve Claude Code’un maliyet farkını anlattığımız yazıda ölçümle görmüştük.

DeepSeek Harness bu katmanın DeepSeek imzalı, TypeScript ile yazılmış açık kaynak sürümü. DeepSeek’in tanımına göre şu işleri yapıyor:

• Günlük işler: Word, Excel, PDF ve sunum dosyalarıyla çalışmak.
• Kodlama: hata düzeltmek, özellik eklemek, test çalıştırmak.
• Araştırma: bilgi bulup kaynak göstermek.
• Arka plan görevleri: betik çalıştırıp ilerlemeyi takip etmek.
• Eklentiler: hazır eklenti kurmak ya da kendi eklentinizi yazmak.

Altında Cordis adlı bir çatı var. DeepSeek bunun için 92 sayfalık bir de makale yayımladı (arXiv 2608.25512 ). Makalenin iddiası, çalışan bir sistemden bir bileşeni çıkardığınızda onun bıraktığı tüm yan etkilerin de geri alınabilmesi. Pratikteki karşılığı şu: eklentileri uygulamayı yeniden başlatmadan kurup kaldırabiliyorsunuz ve kaldırılan eklenti arkasında kırıntı bırakmıyor.

Video: Sharbel A., DeepSeek Harness kurulumu (İngilizce)

DeepSeek Harness Nasıl Kurulur?

Üç yol var. Hangisini seçerseniz seçin, sonraki adımlar aynı: API anahtarı, çalışma klasörü, ilk görev.

1. Masaüstü uygulaması (en kolayı). deepseek.com/en/harness sayfasından indirin. Windows 64-bit kurulum dosyası yaklaşık 290 MB, macOS sürümü yaklaşık 370 MB ve indirme sayfasında yalnızca Apple silicon (M serisi) için sunuluyor. Node.js ya da pnpm kurmanız gerekmiyor, uygulama kendi Node’unu getiriyor. Linux için hazır paket yok; orada aşağıdaki iki yoldan birini kullanın.

2. Tek komutla web arayüzü. Node.js kuruluysa:

npx @deepseek-ai/dsh web

Komut arayüzü http://127.0.0.1:3080 adresinde açıp tarayıcıyı başlatıyor. Başka port için --port 8080, tarayıcı açılmasın istiyorsanız --no-open ekleyin.

3. Kaynaktan derleme. Kodu kurcalamak isteyenler için:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

API anahtarını girmek

Uygulama açılınca Settings → Models bölümüne gidin, platform.deepseek.com adresinden aldığınız API anahtarını DeepSeek kartına yapıştırıp kaydedin. Yeniden başlatmak gerekmiyor. Anahtar arayüze geri gösterilmiyor, $DSH_HOME/.credentials.yaml dosyasında tutuluyor.

Sonra Choose workspace ile proje klasörünüzü seçin. Klasör seçilmeden mesaj kutusu açılmıyor. İlk görev olarak belgelerdeki örnek iyi bir başlangıç: “Bu depoyu özetle ve ana paketlerini listele.” Ajan dosya düzenlemek ya da komut çalıştırmak istediğinde, izin politikası gerektiriyorsa önce size soruyor.

Terminal ve otomasyon modları

Masaüstü ve web arayüzü dışında dsh komutunun başka modları da var:

• dsh --profile headless "testleri çalıştır": tek bir görevi çalıştırıp sonucu yazdırıyor ve çıkıyor. CI betikleri için uygun.
• dsh --profile acp: editörlerin konuştuğu ACP protokolüyle servis veriyor.
• dsh --profile sdk: Python SDK’sına JSON-RPC üzerinden bağlanıyor.

Eklentiler ve Creator Mode

Resmi eklenti listesinde şu an Agent Teams (ajan ekibi, ortak görev panosu), Voice input (sesi SenseVoice ile yerelde yazıya döküyor), Shell, Agent loop, Subagent ve DeepSeek arama sağlayıcısıyla çalışan Web search var. Tanıtım sayfasında deneysel olarak Scheduled tasks (zamanlanmış görev), Auto approval review (otomatik onay denetimi) ve Terminal de listeleniyor.

İlginç kısım Creator mode. Sohbete “bana ekranın üstünde duran bir Pomodoro sayacı eklentisi yaz” diyorsunuz; ajan eklenti yazma becerisini yüklüyor, arayüzde nereye bağlanacağını inceliyor, dosyaları oluşturuyor, eklentiyi kuruyor ve çalıştığını doğruluyor. DeepSeek’in tanıtımındaki bu örnek 5 dakika 24 saniye sürmüş. Başkalarının yazdığı eklentiler GitHub’da dsh-plugin etiketiyle toplanıyor.

Zamanlanmış görevler eklentisi açıkken “her cuma 17:00’de bu haftanın proje notlarını haftalık rapora çevir” gibi tekrarlayan işler kurabiliyorsunuz. Bir şey ters gittiğinde geliştirici araçları ekranı her turu, her araç çağrısını, girdisini, çıktısını ve süresini tek tek gösteriyor.

DeepSeek Harness Ücretsiz mi, Ne Kadar Tutar?

Uygulamanın kendisi ücretsiz ve MIT lisanslı. Para, kullandığınız modele gidiyor. Varsayılan model DeepSeek V4.1 Flash (API’deki adıyla deepseek-flash). DeepSeek’in fiyatları yoğun saate göre değişiyor:

Yoğun saatler hafta içi UTC 01:00-04:00 ve 06:00-10:00. Türkiye saatiyle 04:00-07:00 ve 09:00-13:00. Öğleden sonra, akşam ve hafta sonu yarı fiyat geçerli. Ajanlar aynı bağlamı tekrar tekrar gönderdiği için önbellek fiyatı burada belirleyici: önbellekten okunan girdi normal girdiden 50 kat ucuz. Kendi senaryonuzu LLM maliyet hesaplayıcısında diğer modellerle karşılaştırabilirsiniz. Modelin ayrıntıları için DeepSeek V4.1 Flash yazımıza bakın.

Claude veya ChatGPT aboneliğim var, onu kullanabilir miyim? Hayır. Harness’a Anthropic, OpenAI, Kimi (moonshotai) ve GLM (zai) sağlayıcılarını ekleyebiliyorsunuz ama hepsi API anahtarıyla. Belgeler, Codex gibi OAuth ile giriş yapılan sağlayıcıların henüz desteklenmediğini açıkça yazıyor. OpenAI Chat Completions, OpenAI Responses ya da Anthropic Messages protokolünü konuşan her ağ geçidini (kendi sunucunuz, OpenRouter tarzı aracılar) özel sağlayıcı olarak tanımlayabiliyorsunuz.

DeepSeek Harness mı, Claude Code mu?

İkisi aynı işi yapıyor ama farklı yerlerden geliyor:

Bir not: iki dünya birbirine kapalı değil. DeepSeek API’nin Anthropic uyumlu bir adresi var (https://api.deepseek.com/anthropic), yani Claude Code’u da DeepSeek modeliyle çalıştırabilirsiniz. Nasıl yapılacağını Claude Code’u Ollama, Kimi ve GLM ile kullanma rehberinde anlattık, adım aynı. Claude Code’u hiç kullanmadıysanız Claude Code nasıl kullanılır yazısıyla başlayın.

Seçim kabaca şöyle: Claude aboneliğiniz varsa ve kararlı bir araç istiyorsanız Claude Code. Faturayı düşük tutmak, modeli serbestçe değiştirmek ya da ajanın içini eklentiyle kurcalamak istiyorsanız DeepSeek Harness. opencode da açık kaynak ve çok modelli ama terminal odaklı; DeepSeek Harness’ı ayıran şey masaüstü arayüzü ve eklenti mimarisi.

Kurmadan Önce Bilmeniz Gerekenler

Güvenlik uyarısını ciddiye alın. DeepSeek’in kendi güvenlik notu, projenin güvenlik denetiminden geçmediğini, model çıktısının dosya silebileceğini ya da kimlik bilgisi sızdırabileceğini yazıyor. Önerisi: en az yetkiyle, mümkünse sanal makine ya da konteyner içinde çalıştırmak, ajanın erişebildiği dosyaların yedeğini almak ve üçüncü taraf eklentileri kurmadan önce incelemek.

Masaüstü uygulaması kullanım verisi gönderiyor. Belgelere göre masaüstü sürümü seçili etkileşimleri varsayılan olarak raporluyor ve bunu kapatacak bir arayüz düğmesi yok; yalnızca yapılandırma dosyasındaki product-analytics ayarıyla kapanıyor. İstemleriniz, model yanıtları ve API anahtarları bu olaylara girmiyor. npx ile açılan web sürümü bu verileri hiç göndermiyor.

Sürümler hızlı değişiyor. Son iki haftada sekiz ön sürüm çıktı. Bugünkü sürüm (0.2.0-rc.2) bazı eski model kimliklerini kaldırdı, kaydedilmiş model seçimlerini yeniden yapmanız gerekebilir.

Sıkça Sorulan Sorular (SSS)

DeepSeek Harness nedir?

DeepSeek’in geliştirdiği açık kaynaklı (MIT) yapay zeka ajanı. Kod yazıp test çalıştırıyor, belge ve tablo işliyor, araştırma yapıp kaynak gösteriyor ve zamanlanmış görev yürütüyor. “Her şey bir eklenti” mimarisiyle Cordis çatısı üzerine kurulu.

DeepSeek Harness ücretsiz mi?

Uygulama ücretsiz ve açık kaynak, ama model kullanımı ücretli. DeepSeek API anahtarı gerekiyor. Varsayılan model V4.1 Flash, yoğun olmayan saatte milyon token başına 0,15 dolar girdi ve 0,60 dolar çıktı.

DeepSeek Harness nasıl indirilir?

Windows 64-bit ve Apple silicon Mac için masaüstü uygulaması deepseek.com/en/harness sayfasında. Node.js kuruluysa npx @deepseek-ai/dsh web komutuyla tarayıcıda da açabilirsiniz; Linux’ta bu yol ya da kaynaktan derleme kullanılıyor.

DeepSeek Harness Claude aboneliğiyle çalışır mı?

Hayır. Claude ve OpenAI modellerini bağlayabiliyorsunuz ama API anahtarıyla. Abonelik hesabıyla (OAuth) giriş yapılan sağlayıcılar henüz desteklenmiyor.

DeepSeek Harness mı Claude Code mu?

Claude Code kapalı kaynaklı ve kararlı, Claude aboneliğiyle kullanılabiliyor. DeepSeek Harness açık kaynaklı, model bağımsız ve yalnızca API kullanımı kadar tutuyor, ama henüz geliştirici önizlemesinde.