Agent harness nedir ve ne işe yarar?
Agent harness yapısının bir dil modelinden farkını ve çalışma prensibini öğrenin. Modelin döngü, araçlar ve oturum yönetimi ile nasıl bir ajana dönüştüğünü keşfedin.
Ajan donanımı (agent harness) nedir
Ajan donanımı, bir dil modelinin etrafında çalışan ve onu bir ajana dönüştüren programdır. Bu yapı; modeli sürekli çağıran döngüyü, modelin kullanmasına izin verilen araç tanımlarını, bu çağrılardan hangilerinin gerçekten çalıştırılacağına karar veren izin kurallarını, turlar arasında varlığını sürdüren oturum durumunu ve işin gerçekleştiği çalışma dizinini barındırır. Model, bu yapının içinde değiştirilebilir durumdadır.
Akılda tutulması gereken kısım son cümledir. Bir model tek başına bir soruyu yanıtlar ve sizi unutur. Bir donanım ise modele bir sonraki adımda ne yapması gerektiğini sorar, modelin istediği komutu çalıştırır, sonucu geri besler ve tekrar sorar. İnsanlar "ajan" dediklerinde bu tekrarlanan süreci kastederler. Eğer kullanılan terminoloji hala belirsizse, bir yapay zeka ajanı, bir LLM ve bir asistan arasındaki fark konusu, bir araç seçmeden önce kavramları netleştirmenize yardımcı olacaktır.
Harness, model değildir
Satıcılar bunları tek bir marka adı altında piyasaya sürdüğü için bu ikisi birbirine karıştırılır.
dsh ve DeepSeek farklı ürünlerdir. 13 Ağustos 2026 tarihinde github.com/deepseek-ai/deepseek-harness adresinde MIT lisansı ile yayımlanan DeepSeek Harness, bir makineye kurduğunuz bir Node programıdır. DeepSeek modelleri ise bir API (uygulama programlama arayüzü) arkasında sunulan ağırlıklardır. dsh noktasını başka bir satıcının modeline yönlendirdiğinizde sistem çalışmaya devam eder; çünkü harness yalnızca mesajları kabul eden ve araç çağrıları döndüren bir yapıya ihtiyaç duyar.
Claude Code ve Claude aynı ikilidir. Claude Code bir harness'tır: bir döngüye, izin sistemine, dosya ve kabuk araçlarına sahip bir terminal programıdır. Claude ise varsayılan olarak çağırdığı model ailesidir. Codex ve Gemini CLI da aynı şekilde ayrılır.
Bu durumu her seferinde netleştiren test şudur: Bir harness kurarsınız. Bir model çağırırsınız. Eğer söz konusu şeyin diskinizde bir sürümü ve ev dizininizde bir yapılandırma dosyası varsa, bu bir harness'tır. Eğer bu yapılandırma dosyasının içinde deepseek-flash gibi bir metin dizisi yer alıyorsa, o modeldir.
Döngünün gerçekte ne yaptığı
Bir harness döngüsünün bir turu şu şekilde işler. Bunu yavaş okuyun, çünkü harness'lar arasındaki neredeyse her fark bu beş adımın içindedir.
- Harness, o ana kadarki konuşmayı ve araç tanımlarının bir listesini modele gönderir.
- Model, metinle veya bu araçlardan birini çağırma isteğiyle yanıt verir.
- Harness, bu isteği izin kurallarına göre kontrol eder ve ya çalıştırır ya da size sormak için durur.
- Harness aracı çalıştırır, çıktıyı ve çıkış kodunu yakalar; çıktı çok uzunsa kısaltır.
- Harness bu sonucu konuşmaya ekler ve 1. adıma geri döner.
Harness'ların günlük kullanımda en çok farklılaştığı yer 3. adımdır. Her komuttan önce soran bir harness güvenli ancak yorucudur. Asla sormayan bir harness ise modelin yanlış anladığı bir yolda er ya da geç yıkıcı bir komut çalıştıracaktır. Claude Code orta bir ayarı destekler: sormadan çalışan komutlardan oluşan bir izin listesi ve diğer komutlar için bir onay istemi.
Farkın geri kalanının bulunduğu yer 1. adımdır. Harness ayrıca bu isteklerin her birinde beraberinde giden sistem istemini (system prompt) yazar. Claude Code bu kontrolü doğrudan size verir, çünkü bir çıktı stili gönderdiği sistem istemini düzenler ve böylece gelen her yanıtı değiştirir. Konuşma her turda büyür ve modelin sabit bir bağlam penceresi (context window) vardır; bu nedenle harness neyin atılacağına, neyin özetleneceğine ve neyin bir dosyaya yazılıp daha sonra tekrar okunacağına karar vermelidir. Bu karar, aynı modeli kullanan iki harness'ın neden farklı kalitede iş çıkardığının temel nedenidir. Eğer bu beş adım hala soyut geliyorsa, çözüm kendi basit döngünüzü bir kez yazmaktır; yapay zeka ajanlarını öğrenmek için aşamalı bir yol tam olarak bunu erken bir aşamada inşa etmenizi sağlar.
Çoğu harness artık harici araçları, bir aracı onu konuşabilen herhangi bir harness'a sunmanın standart bir yolu olan MCP (model context protocol) üzerinden bağlamaktadır; böylece tek bir entegrasyon birkaç harness'a ulaşır. Bir VPS üzerinde MCP sunucuları çalıştırmak bu tarafı ele alır. Web araması genellikle insanların ilk eklediği araçtır ve ajanı kendi SearXNG örneğinize yönlendirmek, sorguları üçüncü taraflardan uzak tutarken ajanın okuduğu her sayfanın döngü içine giren güvenilmez bir girdi olduğunu açıkça ortaya koyar.
Agent harness ile agent framework karşılaştırması
Bu soru, her yeni harness piyasaya sürüldüğünde gündeme gelir ve cevaplar, kısmen satıcıların farklı görüşleri nedeniyle çelişir. İşte geçerliliğini koruyan açıklama:
Framework, içe aktardığınız bir kütüphanedir. Agent'ı kod içerisinde, framework'ün döngüsünü kullanarak veya kendi döngünüzü yazarak oluşturursunuz. LangChain bunun iyi bilinen bir örneğidir: yapı taşlarını alırsınız ve agent'ı kodla birleştirirsiniz.
Harness ise çalıştırdığınız bir programdır. Döngü halihazırda yazılmıştır, araçlar zaten mevcuttur ve izin modeli varsayılan ayarlara sahiptir. İlk komutla çalışan bir agent elde edersiniz ve oradan yapılandırırsınız.
Kurulum testi genellikle bu ayrımı belirler. Eğer kurulumu yapıp ardından kod yazıyorsanız, bu bir framework'tür. Eğer kurulumu yapıp ardından onunla etkileşime geçiyorsanız, bu bir harness'tır.
Sınır gerçekten tartışmalıdır ve bunun en net kanıtı LangChain'in kendi dokümantasyonudur. Ekim 2026 itibarıyla Deep Agents'ı hem "bir agent harness" hem de "LangChain'in temel agent yapı taşları üzerine inşa edilmiş bağımsız bir kütüphane" olarak adlandırırken, langchain-ai/deepagents deposu kendisini "her şey dahil agent harness" olarak tanımlamaktadır. Her iki tanım da doğrudur. Deep Agents, içe aktardığınız bir Python SDK (yazılım geliştirme kiti) olduğundan kurulum testi onu bir kütüphane olarak sınıflandırır; ancak sunduğu varsayılan davranışlar sayesinde insanlar onu bir harness gibi kullanır. Microsoft, 9 Temmuz 2026'da Foundry Agent Service bünyesindeki Hosted Agents için genel erişimi duyurmuş ve 22 Temmuz 2026 tarihli gönderisinde Microsoft Agent Framework Harness'ın piyasaya sürüldüğünü açıklamıştır; bu da söz konusu terimin artık teknik jargon olmaktan çıkıp bir ürün kategorisine dönüştüğünü göstermektedir.
Bu nedenle, iş yükünüzü belirleyen soruyu sorun. Eğer döngüyü siz yazıyorsanız, döngünün sorumluluğu sizdedir: yeniden denemeler, bağlam kırpma, izin istemleri ve gerçekleşen olayların kaydı. Eğer döngü hazır geliyorsa, tüm bu konularda başkasının çözümünü devralırsınız; bu, başlangıç için çok daha hızlıdır ancak daha sonra değiştirilmesi daha zordur.
Harness ile sohbet penceresi arasındaki fark
Sohbet penceresi ve harness, her ikisi de model çıktısını gösterir. Aradaki fark, işlemin kimin bilgisayarında gerçekleştiğidir. Sohbet penceresinde, modelin çalıştırdığı her kod, yüklediğiniz dosyalar üzerinde, tedarikçinin korumalı alanında (sandbox) yürütülür. Harness ise araçları, onu başlattığınız makinede, başlatan kullanıcı yetkileriyle, gerçek dosyalarınız üzerinde ve ortamınızdaki gerçek kimlik bilgilerinizle çalıştırır.
Bu durum, iki cümleyle tüm avantajı ve tüm riski özetler. Ajan nihayet işi yapabilir. Ajan aynı zamanda işi silebilir.
Kullanıcıların fiilen çalıştırdığı araçlar
Bu liste, 19 Ağustos 2026 tarihi itibarıyla bilinçli olarak güncel tutulmuştur. Kategori haftalık olarak değiştiğinden, her türlü özet hızla eskir.
- Claude Code ve Codex satıcı odaklı araçlardır. Terminal önceliklidirler, varsayılan olarak kendi satıcılarının modellerine bağlıdırlar ve en gelişmiş izin yönetimine sahiptirler. Claude Code, Cursor, Codex ve Copilot karşılaştırması bu araçları detaylıca inceler.
- DeepSeek Harness (
dsh) MIT lisanslıdır ve tek bir fikir üzerine kuruludur: her şey bir eklentidir; dolayısıyla modeller, araçlar, oturumlar, sandbox ortamları ve kullanıcı arayüzü değiştirilebilir parçalardır. Yüklediğiniz her eklenti, ajanın kendi izinleriyle çalışır; bu nedenle bir dsh eklentisini eklemeden önce erişebileceği alanları kontrol etmek, sabit araç setine sahip bir yapıya göre burada daha önemlidir. - Hermes, Nous Research tarafından geliştirilmiş, bir kodlama aracından ziyade genel amaçlı otonom bir ajandır. Şubat 2026'da MIT lisansıyla yayınlanmıştır ve yerleşik depolaması yereldir: anıları ve yetenekleri
~/.hermesaltında dosya olarak, oturum geçmişi ise yerel bir SQLite veritabanında tutulur. Mem0 veya Hindsight gibi isteğe bağlı harici bellek sağlayıcılarından birini etkinleştirdiğinizde durum değişir. Ekim 2026 itibarıyla Hermes belgeleri, aktif bir sağlayıcının her yanıttan sonra konuşma sırasını ve yerleşik bellek yazmalarının bir kopyasını aldığını belirtir; bu durumda verileriniz ilgili sağlayıcıda da barındırılır. Hindsight ve Mem0 karşılaştırması konusunu etkinleştirmeden önce okumakta fayda vardır; Hermes'i bir VPS üzerinde self-host etmek ise kurulumun geri kalanını anlatır. - Omnigent bir meta-araçtır: Claude Code ve Codex dahil olmak üzere diğer araçları, paylaşımlı oturumlar, harcama limitleri ve işletim sistemi düzeyinde bir sandbox ile tek bir API arkasından yönetir. Çoklu ajan aracı olarak Omnigent bu yapının sağladığı avantajları kapsar.
- OneCLI, ekiplere yönelik, sandbox içinde çalışan bir araçtır. Ajanın giden isteklerine kimlik bilgilerini enjekte eden bir ağ geçidi etrafında kuruludur; böylece ajanın kendisi gerçek anahtarları hiçbir zaman görmez.
Bu araçlardan üçü, model eşleştirme, lisans, olgunluk ve sunucu üzerinde çalıştırma gereksinimleri açısından sıkça aynı kısa listeye girer; bu nedenle DeepSeek Harness, Claude Code ve Omnigent karşılaştırması yazısını okumak faydalıdır.
dsh hızlı başlangıç komutu tek bir satırdan oluşur ve bir aracı tanımanın en hızlı yolu bu komutu bir kez çalıştırmaktır. Makinede Node.js yüklü olması gerekir.
npx @deepseek-ai/dsh webBu komut, web arayüzünü (user interface) http://127.0.0.1:3080 adresinde başlatır. Güvenilir bir şekilde kullanmadan önce README dosyasını okuyun; çünkü dsh kendisini bir geliştirici önizlemesi olarak tanımlar ve uyumluluğu bozacak değişikliklerin olacağını açıkça belirtir. Eğer bu ilk komut doğrudan başarısız olursa veya beklemediğiniz bir sürümü çekerse, belirli bir dsh sürümünü sabitlemek ve npx önbelleğini temizlemek genellikle sorunu çözer. DeepSeek Harness'i bir VPS üzerinde çalıştırmak sunucu kurulumunu, adresin neden 127.0.0.1 ile başladığı ise loopback varsayılanını açıklar.
Router'lar harness'ın üzerinde konumlanır
Bir model router, harness ile sağlayıcı API'si arasında yerel bir proxy görevi görür. Claude Code Router bunun yaygın bir örneğidir: varsayılan olarak 127.0.0.1:3456 adresine bağlanır, Claude Code'un kendi sağlayıcısına göndereceği istekleri kabul eder ve bunları yapılandırdığınız sağlayıcıya iletir. Harness, herhangi bir değişiklik yapıldığının farkında değildir.
Router'ların var olma nedeni modelin değiştirilebilir olmasıdır; bu durum, bu yazının ana fikrini kanıtlar niteliktedir. Ayrıca, proxy her istemi (prompt) gördüğü ve her sağlayıcı anahtarını elinde tuttuğu için riski tek bir noktada toplarlar. Bu yapıyı bir kolaylık aracı olarak değil, altyapı olarak değerlendirin. Bir harness'ın API anahtarlarını ve model ayarlarını nerede tuttuğu sorunu, bir katman altta da aynı şekilde geçerlidir.
Harness bir VPS üzerinde çalıştığında neler değişir
Harness dizüstü bilgisayarınızdan çıkıp kiraladığınız bir sunucuya taşındığında dört şey değişir.
Kapağı kapattığınızda çalışmaya devam eder. Uzun süren bir görev, yolculuğunuzdan ve pil ömrünüzden bağımsız olarak sürer. Görevi tmux içinde başlatın ve oturumdan ayrılın:
tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agentYeniden başlatma sonrasında geri gelmesi gereken her şey için bir kullanıcı servisi, terminal oturumundan daha iyidir:
loginctl enable-linger $USER
systemctl --user status my-agent.serviceloginctl enable-linger insanların gözden kaçırdığı kısımdır. Bu ayar olmadan, systemd'nin varsayılan davranışı, son oturumunuz kapandıktan 10 saniye sonra kullanıcı servis yöneticinizi durdurmaktır; bu nedenle bir kullanıcı servisi, siz çıkış yaptıktan sonra ajanı çalışır durumda tutmaz. dsh'yi systemd altında başsız (headless) çalıştırma bölümünde birim dosyası mevcuttur. Sunucuda bir oturum aktif olduğunda, ikinci bir oturum başlatabilirsiniz ve aynı makinedeki iki Claude Code oturumu birbirine mesaj gönderebilir; böylece bu sabah başlattığınız oturum, siz manuel olarak aktarmak zorunda kalmadan diğerine bir iş devredebilir.
Anahtarlarınızı tutar. Sağlayıcı anahtarı artık o sunucudaki bir yapılandırma dosyasında yaşar. Kimin okuyabildiğini kontrol edin:
ls -l ~/.configKullanıcı adınızla çalışan herhangi bir süreç bu dosyayı okuyabilir; buna ajan ve ajanın çalıştırmayı seçtiği her şey dahildir.
Diğer makinelerinize erişebilir. Diğer makinelerinizle aynı özel ağ üzerinde bulunan bir VPS, ajana onlara ulaşması için bir rota sağlar. Asıl amaç budur ancak bu aynı zamanda etki alanını (blast radius) da belirler.
Nerede olursanız olun erişilebilirdir. Çoğu harness bir web arayüzü sunar ve çoğu bunu bir nedenden dolayı loopback adresine bağlar. Sizinkini kontrol edin:
ss -tlnp | grep 3080127.0.0.1:3080, yalnızca sunucunun kendisinin bağlanabileceği anlamına gelir. 0.0.0.0:3080, arayüzün tüm arayüzlerde dinleme yaptığı anlamına gelir; bu nedenle önündeki bir güvenlik duvarı portu engellemediği sürece, sunucunun genel adresine ulaşabilen herkes bağlanabilir. Ekim 2026 itibarıyla dsh, başlangıçta bunun gibi bir joker karakter adresini reddeder, ancak diğer birçok web arayüzü bunu kabul eder. Bağlama adresini değiştirmek yerine, bir SSH tüneli aracılığıyla loopback arayüzüne erişin:
ssh -N -L 3080:127.0.0.1:3080 you@your-serverArdından dizüstü bilgisayarınızdaki tarayıcıda http://127.0.0.1:3080 adresini açın. Trafik SSH oturumu içinde taşınır, bu nedenle internete yeni hiçbir şey açılmaz.
Bunların her biri aynı zamanda bir güvenlik argümanıdır
Dört özelliği bir saldırganın bakış açısıyla tekrar inceleyin.
Sistem gözetimsiz çalıştığı için, modelin bir yolu yanlış okuduğu anı kimse fark etmez. Anahtarlarınızı elinde tuttuğu için, okunabilir tek bir yapılandırma dosyası tüm sağlayıcı hesabınızın ele geçirilmesi anlamına gelir. Diğer makinelerinize erişebildiği için, bir prompt injection (yani bir web sayfasında veya ajanın okuduğu bir dosyada gizlenmiş talimatlar), veritabanı sunucunuza giden bir yol açar. Her yerden erişilebilir olduğu için, önünde güvenlik duvarı olmayan ve kendi kimlik doğrulama mekanizması bulunmayan, genel bir IP adresi üzerinde dinleme yapan bir web arayüzü, onu bulan herkes için bir kabuk (shell) görevi görür. dsh, başlangıçta yazdırdığı URL içerisine bir işlem belirteci (process token) yerleştirir; bu yardımcı olsa da, söz konusu URL artık bir kimlik bilgisi haline gelmiştir, bu nedenle onu bir parola kadar dikkatli paylaşın.
Her durum için çözüm sıkıcıdır ve her seferinde aynıdır. Ajana kendi kullanıcı hesabınız yerine, ayrıcalıksız bir kullanıcı hesabı atayın:
sudo adduser --disabled-password --gecos "" agentWeb arayüzünü loopback üzerinde tutun ve ona SSH üzerinden erişin. Ajana, işini tamamlamasına yetecek en kısıtlı yetkilere sahip kimlik bilgilerini verin; bu konu yapay zeka ajanlarından sırları uzak tutmak başlığında detaylıca ele alınmıştır. Siz izlemiyorken çalışan her şey için, özenle yapılandırılmış bir makineden ziyade tek kullanımlık bir makine daha iyidir: kodlama ajanlarını geçici bir VM üzerinde çalıştırmak ve Claude Code'u bir VPS üzerinde güvenli bir şekilde çalıştırmak yöntemlerinin her ikisi de bu yolu izler.
Bir aracı (agent) donanımına ihtiyacınız var mı?
Eğer işiniz tek seferde tek bir sorudan ibaretse, bir sohbet penceresi yeterlidir; bir donanım (harness) ise yalnızca denetlemeniz gereken bir döngü ekler. Bir donanım, görev gerçek dosyalar üzerinde çok sayıda adım gerektirdiğinde veya siz uyurken çalışmaya devam etmesi gerektiğinde maliyetini karşılamaya başlar.
Bu kategorideki araçların çoğu henüz yenidir. dsh, Ekim 2026 itibarıyla kendi README dosyasında geliştirici önizlemesi (developer preview) olduğunu belirtmektedir; diğerleri ise bugün yazdığınız bir yapılandırma dosyasının gelecek ay düzenlenmesini gerektirecek kadar hızlı değişmektedir. Bu durum, kurulumunuzu küçük ve tekrarlanabilir tutmanız ve yaptığınız değişiklikleri not etmeniz için bir nedendir. Aynı kısıtlama, aracıyı çalışan en küçük değişikliğe yönlendiren bir beceri sayesinde, gözetimsiz bir çalıştırmanın sonunda gerçekten okuyabileceğiniz bir diff (fark dosyası) elde etmenizi sağlayan döngü içinde de yardımcı olur. Bir sunucuda bir donanım ile başlayın, ona bir görev ve bir kısıtlı anahtar verin; erişimini ancak o ilk görev bir hafta boyunca sorunsuz ve rutin bir şekilde işledikten sonra genişletin. Bugün çalıştırılmaya değer self-hosted aracılar, ilkini seçmek için makul bir başlangıç noktasıdır.
FAQ
Agent harness nedir, basitçe açıklayabilir misiniz?
Modelin etrafındaki programdır. Model metin üretir ve araçları kullanma talebinde bulunur. Harness, sürekli sorgulama döngüsünü çalıştırır, modelin talep ettiği araçları yürütür, hangi araçların izinsiz çalışabileceğine dair kuralları uygular ve oturum durumu ile dosyaları turlar arasında korur. Modeli değiştirdiğinizde harness çalışmaya devam eder; bu da ikisinin birbirinden ayrı yapılar olduğunun en net göstergesidir.
Claude Code bir model midir yoksa bir harness mı?
Claude Code bir harness'tır. Döngüye, izin sistemine ve yerleşik dosya ve shell araçlarına sahip bir terminal programıdır. Claude, varsayılan olarak çağrılan model ailesidir. Aynı ayrım, kurduğunuz bir Node programı olan DeepSeek Harness (dsh) ile API üzerinden sunulan DeepSeek modelleri için de geçerlidir. Bir makineye harness kurarsınız. Bir modeli ise ağ üzerinden çağırırsınız.
Agent harness ile agent framework arasındaki fark nedir?
Framework, içe aktardığınız ve kendi döngünüzü yazarak veya mevcut olanı kullanarak kod geliştirdiğiniz bir kütüphanedir. Harness ise çalıştırdığınız bir programdır; bu nedenle döngü, yeniden denemeler ve bağlam yönetimi, kod yazmak yerine yapılandırdığınız varsayılan ayarlarla birlikte gelir. Uygulamada bu ayrım belirsizleşebilir: Ekim 2026 itibarıyla, LangChain'in Deep Agents projesi, kendi deposunda "batteries-included" (tümleşik) bir agent harness olarak adlandırılan, içe aktarılabilir bir SDK'dır. Döngüyü kendinizin mi yazacağınıza bakın. Bu sorunun cevabı, hangi terimin durumunuza uygun olduğunu belirler.
Bir agent harness çalıştırmak için VPS gerekir mi?
Hayır. Burada adı geçen her harness bir dizüstü bilgisayarda çalışır. Bir sunucu dört şeyi değiştirir: bilgisayarın kapağını kapattığınızda agent çalışmaya devam eder, anahtarlarınızı sürekli açık olan bir makinede tutar, diğer sunucularınıza erişebilir ve herhangi bir cihazdan aynı oturuma geri dönebilirsiniz. Bunların her biri aynı zamanda bir güvenlik konusudur; bu nedenle agent'a kendi kullanıcı hesabını atayın ve herhangi bir web arayüzünü 127.0.0.1 adresine bağlayın.
Aynı harness içinde farklı bir model kullanabilir miyim?
Genellikle evet; bu, bir harness'ın belirleyici özelliğidir. Çoğu, yapılandırmasında bir model adı ve temel URL kabul eder, bu nedenle birini başka bir sağlayıcıya yönlendirmek yeniden yazmaktan ziyade bir düzenleme işlemidir. Bir harness buna izin vermediğinde, Claude Code Router gibi yerel bir yönlendirici, harness ile sağlayıcı arasına girerek istekleri çevirir ve varsayılan olarak 127.0.0.1:3456 adresine bağlanır. Bu proxy'ye dikkat edin; çünkü her istemi görür ve her anahtarı tutar.