Otonom bir kodlama ajanına doğrudan geliştirici bilgisayarında tam kabuk erişimi vermek, tek bir hatalı paket kurulumunda veya dikkatsiz bir dosya temizliğinde yerel çalışma ortamını bozabilir. Kasım 2026 açık kaynak yapay zeka ajan ekosistemi içinde uçtan uca hata çözümü hedefleyen ve kurumsal yapay zeka çözümleri geliştiren ekipler için OpenHands, konteyner tabanlı yürütme izolasyonunu mimarinin merkezine koyar.
OpenHands nedir? OpenHands (eski adıyla OpenDevin / All-Hands-AI), herhangi bir firmaya veya modele bağlı kalmadan çalışan MIT lisanslı açık kaynak otonom yazılım mühendisliği platformudur. Docker veya Kubernetes tabanlı izole sandbox ortamlarında birden fazla dosyayı düzenler, bağımlılık kurar, test paketlerini çalıştırır ve hataları okuyarak testler yeşil olana dek yinelemeli düzeltme yapar.
Önemli
Yönetici Özeti — OpenHands Neden Tercih Ediliyor?
- Üretici Bağımsızlığı ve MIT Lisansı: Çekirdek platform, Software Agent SDK, CLI ve değerlendirme paketi MIT lisanslıdır; ticari API'ler veya kurum içi açık ağırlıklı modeller arasında kilitlenme olmadan geçiş yapılır.
- İzole Çoklu Dosya ve Test Döngüsü: Varsayılan Docker Runtime ve Kubernetes Remote Runtime, ana işletim sistemini riske atmadan kod düzenleme, derleme ve test doğrulamasını geçici konteynerlerde yürütür.
- Modüler V1 SDK ve Yönetişim: Deterministik
EventStream, onay politikaları (AlwaysConfirm,ConfirmRisky,NeverConfirm),--llm-approve, Microagents ve OAuth destekli yerel MCP sunar.
OpenHands V1 Modüler Mimarisi ve EventStream
OpenHands, erken dönem prototip yapısından çıkarak resmi GitHub deposu ve Software Agent SDK etrafında ayrıştırılmış V1 mimarisine geçmiştir. Bu ayrışma sayesinde web çalışma alanı ile başsız CI otomasyonu aynı motoru paylaşır.
Ayrıştırılmış V1 Paket Katmanları
openhands.sdk:LLM,Agent,Conversation,Eventve güvenlik politikalarını barındırır. LiteLLM uyumlu arayüz sayesinde model sağlayıcısı yalnızca ortam değişkeniyle değiştirilir.openhands.tools:TerminalTool(kabuk yürütme),FileEditorTool(çoklu dosya yamaları) veTaskTrackerTool(yapılandırılmış görev planlama) araçlarını standart şemayla sunar.openhands.workspace: Yerel dizin, geçici Docker konteyneri veya uzak konteyner sunucusu arasındaki yürütme sınırını soyutlar.openhands.agent_server: Oturum durumunu REST ve WebSocket üzerinden dışa açar; tarayıcı tabanlı Agent Canvas ve OpenHands CLI bu katmana istemci olarak bağlanır.
Deterministik EventStream Günlüğü
OpenHands yalnızca metin sohbet geçmişi tutmak yerine her planlama adımını, kabuk komutunu, dosya yamasını ve test hata çıktısını sıralı bir EventStream akışına kaydeder. openhands.agent_server, bu olay akışını WebSocket üzerinden anlık olarak Agent Canvas arayüzüne ve CLI istemcisine aktarır; mühendisler konteyner kabuğuna doğrudan bağlanmadan canlı dosya farklarını ve standart hata çıktılarını izleyebilir. LOG_ALL_EVENTS=true ile kaydedilen bu deterministik yapı; başarısız oturumların adım adım analiz edilmesini, uyumluluk ekipleri için doğrulanabilir denetim izi oluşturulmasını ve kesintiye uğrayan uzun görevlerin güvenle devam ettirilmesini sağlar.
İzole Sandbox Ortamında Çoklu Dosya Değişikliği ve Test Döngüsü
Üretim depolarında bir hatayı kapatmak veya yeni özellik eklemek çoğu zaman veri şeması, iş mantığı, API uç noktası ve test dosyalarında eşzamanlı değişiklik gerektirir. OpenHands bunu iki katmanlı yürütme izolasyonuyla yönetir.
Docker Runtime, Kubernetes Remote Runtime ve Local Runtime
Varsayılan Docker Runtime, her oturum için geçici ve izole bir konteyner başlatır. Paket kurulumları ve derleme adımları konteyner içinde kaldığı için bağımlılık çakışmaları ana bilgisayarı etkilemez ve oturum bitiminde konteyner temizlenir. Paralel CI görevleri ve toplu depo değerlendirmeleri için Remote Runtime oturumları Kubernetes podlarına dağıtır. Konteyner gerektirmeyen hafif klasör işleri içinse Local Runtime seçeneği mevcuttur.
Kendi Kendini Doğrulayan Kodlama Akışı
Sandbox hazırlandığında ajan TaskTrackerTool ile plan oluşturur, FileEditorTool ile ilgili tüm dosyalarda değişiklik yapar ve TerminalTool üzerinden bağımlılıkları kurup birim ve entegrasyon testlerini çalıştırır. Test başarısız olursa hata yığınını (stack trace) okur, kök nedeni belirleyip yeni yama uygular ve çıktı tamamen yeşil dönene kadar döngüyü sürdürür. Özel yazılım geliştirme projelerinde bu kapalı devre doğrulama, eski kod tabanlarını güvenle modernize etmeyi hızlandırır.
Kurulum, CLI, Docker Sandbox ve Python SDK
Resmi dokümantasyon docs.openhands.dev ve openhands.dev üzerinde yer alır. Kurulum CLI, tam Docker konteyneri veya Python V1 SDK üzerinden yapılabilir.
CLI Kurulumu, Headless Görevler ve MCP Komutları
Python 3.12 ile uv (veya alternatif olarak pip install openhands-ai) kurulumunun ardından Agent Canvas (--mount-cwd, isteğe bağlı --gpu), --llm-approve destekli başsız görevler ve MCP sunucu yönetimi tek arayüzden yürütülür:
uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
--task "Auth modülündeki token yenileme hatasını düzelt ve pytest testlerini geçir"
openhands mcp add docs-mcp --url https://mcp.example.internal/sse
openhands mcp list
Docker Sandbox ile Yalıtımlı Başlatma
İzole agent-server imajı ve tam EventStream kaydıyla OpenHands uygulamasını konteynerde başlatmak için resmi Docker komutu kullanılır:
docker run -it --rm --pull=always \
-e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
-e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands:/.openhands \
-v $(pwd):/workspace:rw \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.openhands.dev/openhands/openhands:1.8
Uyarı
Docker Soketi Sınırı: /var/run/docker.sock bağlaması, OpenHands'in görev başına kardeş sandbox konteynerleri açmasını sağlar. Üretim sırları veya kişisel SSH anahtarları taşıyan bilgisayarlarda NeverConfirm modunu açmayın; tam otonom başsız akışları yalnızca yalıtılmış CI koşucularında veya Kubernetes Remote Runtime üzerinde çalıştırın.
Python Software Agent SDK ile Orkestrasyon
Platform ekipleri kendi otomasyon servislerine V1 SDK üzerinden ajan gömebilir:
import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
api_key=os.getenv("LLM_API_KEY"),
base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
llm=llm,
tools=[
Tool(name=TerminalTool.name),
Tool(name=FileEditorTool.name),
Tool(name=TaskTrackerTool.name),
],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
"Ödeme servisindeki kuruş yuvarlama hatasını düzelt ve pytest çıktısını doğrula."
)
conversation.run()
Güvenlik Politikaları, Microagents ve MCP Entegrasyonu
Konteyner izolasyonu ana bilgisayarı korur; politika katmanı ise ajanın hangi komutları çalıştırabileceğini ve depo kurallarına nasıl uyacağını denetler.
Onay Politikaları ve LLM Güvenlik Analizörü
AlwaysConfirm: Her kabuk komutu ve dosya değişikliği öncesinde açık onay ister.ConfirmRisky: Varsayılan dengeli politikadır; zararsız okuma ve test adımlarını otomatik çalıştırır, yüksek riskli eylemlerde duraklayıp onay bekler.NeverConfirm: Duraklamadan tam otonom çalışır; yalnızca yalıtılmış geçici CI ortamları için uygundur.
--llm-approve etkinleştirildiğinde LLM tabanlı güvenlik analizörü her komutu yürütme öncesinde değerlendirir; yıkıcı silme işlemleri, gizli anahtar sızdırma riskleri veya yetkisiz dış ağ çağrıları başlamadan engellenir.
Microagents ve Yerel OAuth MCP Desteği
Ekipler ~/.openhands/microagents/ altında (ve taşınabilir .agents/skills/ yapısıyla uyumlu biçimde) Microagents tanımlayarak proje kurallarını dosya yolu veya anahtar kelime bazında otomatik olarak bağlama yükler. Yerel MCP desteği (openhands mcp add, openhands mcp list) OAuth doğrulamalı kurumsal sunucuları destekler. Kapalı protokol veya ikili dosya analizlerinde REA (Reverse Engineer Anything) MCP mimari rehberi araçları doğrudan OpenHands oturumuna bağlanarak tersine mühendislik bulguları aynı sandbox içinde test edilmiş koda dönüştürülebilir.
İpucu
Kurumsal Yönetişim İpucu: Yeni depolarda ilk haftalarda ConfirmRisky politikasını --llm-approve ve versiyonlanmış Microagents kurallarıyla eşleştirin. EventStream kayıtlarını inceleyip gerçek verilere göre onay eşiğinizi ayarladıktan sonra tekrarlayan işleri başsız CI akışına alın.
Mimari Karşılaştırma: OpenHands, OpenCode, Goose ve Kapalı Ajanlar
| Kriter | OpenHands | OpenCode | Goose | Kapalı Bulut / IDE Ajanları |
|---|---|---|---|---|
| Yürütme Modeli | Otonom döngü (Agent Canvas, CLI, Headless, Python V1 SDK) | Etkileşimli terminal (TUI) kodlama oturumu | Masaüstü uygulaması, CLI ve API tarifleri | IDE eklentisi veya kapalı bulut sohbeti |
| Sandbox İzolasyonu | Varsayılan geçici Docker Runtime & Kubernetes Remote (+ Local) | Doğrudan yerel çalışma dizini ve kabuk | Yerel ortam; konteyner dış yapılandırmaya bağlı | Sağlayıcıya bağlı; bulut veya yerel IDE |
| Çoklu Dosya Testleri | Konteynerde bağımlılık kurulumu, test koşumu ve otomatik düzeltme | Geliştirici eşliğinde dosya düzenleme ve terminal testi | Eklenti ve tarif tabanlı çoklu adım zinciri | Sıkça kısıtlı derleme ve test erişimi |
| Model Bağımlılığı | Yok — MIT lisanslı, LiteLLM ile tüm ticari/yerel modeller | Yok — Çoklu model ve yerel uç nokta desteği | Yok — Açık kaynak çoklu model yapılandırması | Yüksek — Tek üretici veya zorunlu abonelik |
| MCP ve Genişletme | Yerel MCP (openhands mcp add, OAuth), Microagents, V1 SDK | Geniş MCP sunucusu ve araç yapılandırması | Zengin MCP eklentileri ve YAML tarifleri | Onaylı mağaza veya kısıtlı bağlayıcılar |
Hızlı etkileşimli terminal akışları için OpenCode terminal kodlama ajanı rehberi, masaüstü ve CLI tariflerini birleştiren iş akışları için Goose açık kaynak kodlama ajanı rehberi incelenebilir. Tam yalıtımlı konteyner içinde bağımlılık kurup tüm test paketini yeşile döndüren ve EventStream denetimi sunan boru hatlarında ise OpenHands net biçimde ayrışır.
Kurumsal Dağıtım ve Kling Digital Mühendislik Yaklaşımı
OpenHands'i bireysel deneme aşamasından kurumsal mühendislik standardına taşımak için dört temel kontrol noktası uygulanmalıdır:
- Ağ Çıkış (Egress) Kısıtlamaları: Sandbox konteynerlerinin yalnızca kurum içi paket aynalarına ve onaylı LLM ağ geçidine erişmesine izin verilmelidir.
- Kısa Ömürlü Gizli Anahtar Yönetimi: API anahtarları ve depo belirteçleri bağlı çalışma dizini dışında tutulmalı, yalnızca aktif dal için geçerli en düşük yetkili belirteçler üretilmelidir.
- Merkezi EventStream Arşivi:
LOG_ALL_EVENTS=trueile kaydedilen olay akışları değiştirilemez gözlemlenebilirlik deposuna aktarılarak her pull request için tam kanıt zinciri korunmalıdır. - Zorunlu İnsan Onayı ve SAST Kapısı: Sandbox içinde geçen testler doğrulama kanıtı sayılmalı; her değişiklik standart insan kod incelemesi ve statik güvenlik taramasından geçirilmelidir.
Kling Digital, üretici bağımlılığı olmayan otonom yazılım geliştirme sandbox'ları, Kubernetes Remote Runtime kümeleri ve OAuth korumalı iç MCP entegrasyonları tasarlar. Kurumunuza özel güvenli OpenHands V1 mimarisi için Kling Digital iletişim sayfasından teknik ekibimizle görüşebilirsiniz.




