Büyük bir monorepo üzerinde çalışırken IDE eklentilerinin her ay değişen kota politikalarıyla veya tek bir yapay zekâ sağlayıcısına bağımlı kalmakla uğraşmak, modern mühendislik ekiplerinin ortak operasyonel sürtünme noktası hâline geldi. Bir oturumda mimari planlama için güçlü bir akıl yürütme modeline, hemen ardından seri test düzeltmeleri için hızlı ve düşük maliyetli bir modele, hassas müşteri kodunda ise tamamen çevrimdışı yerel bir modele geçmek istediğinizde kapalı ekosistemler önünüzü keser. Kling Digital mühendislik ekiplerinin kurumsal yapay zekâ çözümleri kapsamında sahada sıklıkla gözlemlediği bu bağımlılık problemini, 2026 itibarıyla açık kaynak terminal ajanları doğrudan çözüyor.
OpenCode, anomalyco/opencode deposunda MIT lisansıyla geliştirilen, herhangi bir firmaya veya tekil model sağlayıcısına bağlı kalmadan kendi makinenizde çalışan hafif bir açık kaynak terminal kodlama ajanıdır. 228 bini aşkın GitHub yıldızına sahip olan proje; istemci-sunucu çekirdeği, otomatik LSP kod analizi, 75'ten fazla LLM sağlayıcı desteği ve MCP entegrasyonu ile klavye odaklı geliştirme akışları sunar.
Önemli
- Sağlayıcı Bağımsız Çekirdek: Tek bir abonelik veya model ailesine sıkışmadan Anthropic, OpenAI, Google, AWS Bedrock, OpenRouter ve yerel Ollama dahil 75'ten fazla sağlayıcı arasında anlık geçiş yapılır.
- Otomatik LSP Bağlamı: Proje dosyalarını körü körüne bağlam penceresine yığmak yerine aktif Dil Sunucusu Protokolü (LSP) üzerinden gerçek tip imzaları, sembol tanımları ve derleyici tanıları çekilir.
- İstemci-Sunucu Mimarisi ve İzin Matrisi: Terminal arayüzü (TUI), masaüstü uygulaması ve uzak sunucu modu (
opencode serve) aynı headless motoru paylaşır; V2 sıralı izin kuralları dosya ve kabuk komutlarını sıkı biçimde denetler.
Ayrık İstemci-Sunucu Mimarisi, Bun Çalışma Zamanı ve OpenTUI
Terminal tabanlı yapay zekâ araçlarının erken kuşakları genellikle tek bir monolitik betik içinde hem LLM akışını hem de terminal çizimini yönetiyordu. Bu tasarım, oturum geçmişi büyüdüğünde veya eşzamanlı araç çağrıları yapıldığında terminal ekranında takılmalara, kopan SSH bağlantılarında ise tüm çalışma bağlamının kaybolmasına yol açıyordu. OpenCode bu darboğazı, motor ile sunum katmanını birbirinden tamamen ayıran modüler bir TypeScript monorepo mimarisiyle (@opencode/cli, @opencode/protocol, @opencode/client) çözer.
Çalışma zamanı ve paket yöneticisi olarak Bun kullanan çekirdek motor; oturum durumunu, mesaj geçmişini ve araç çağrı izlerini yerel bir SQLite veritabanında saklar. Kullanıcı arayüzü tarafında ise SolidJS reaktif programlama modeli, @opentui/core ve @opentui/solid bileşenleriyle birleştirilerek modern terminal emülatörlerinde (WezTerm, Alacritty, Ghostty, Kitty) düşük gecikmeli, bölünmüş panelli ve Vim benzeri kısayolları destekleyen akıcı bir TUI deneyimi üretilir.
Aynı headless motor yalnızca yerel terminalde değil, çapraz platform masaüstü uygulamasında ve IDE eklentilerinde de ortak çekirdek olarak görev yapar. Dağıtık ekipler veya güçlü geliştirme sunucularında çalışan mühendisler için bu mimarinin en pratik getirisi uzak bağlantı desteğidir:
- Headless Arka Plan Sunucusu:
opencode serveveyaopencode webkomutuyla ajan çekirdeği güçlü bir derleme sunucusunda ya da Docker geliştirme ortamında başlatılır. - Hafif İstemci Bağlantısı: Geliştirici, dizüstü bilgisayarından
opencode attachkomutuyla bu çalışan oturuma bağlanır; kaynak kodu yerel diske kopyalanmadan doğrudan sunucu bağlamında düzenlenir. - Oturum Sürekliliği: İstemci terminal kapansa dahi SQLite destekli arka plan çekirdeği durumunu koruduğu için uzun süren yeniden düzenleme oturumları kesintisiz biçimde devam ettirilir.
Otomatik LSP Entegrasyonu ile Bağlam Mühendisliği
Kodlama ajanlarının üretim ortamında başarısız olmasının başlıca nedeni model zekâsının eksikliği değil, eksik veya yanlış dosya bağlamıdır. Klasik yaklaşımlar grep veya dosya listeleme araçlarıyla yüzlerce satır kaynak kodu bağlam penceresine doldurur; bu da hem girdi token maliyetini şişirir hem de modelin eski tip tanımlarına göre halüsinasyon üretmesine neden olur.
OpenCode, çalışma dizinindeki TypeScript, Python, Go, Rust ve benzeri dillerin kurulu Language Server Protocol (LSP) sunucularını otomatik olarak algılar ve arka planda başlatır. Ajan bir fonksiyonu değiştirmeden önce ham metin araması yapmakla yetinmez; doğrudan LSP sunucusundan aşağıdaki yapısal verileri sorgular:
- Kesin Sembol Tanımları ve Referanslar: Bir arayüzün veya fonksiyon imzasının proje genelinde hangi modüller tarafından çağrıldığı milisaniyeler içinde haritalanır.
- Tip İmzaları ve Aşırı Yüklemeler: Üçüncü parti kütüphanelerin
node_modulesveya sanal ortam içindeki gerçek tip tanımları modele eksiksiz iletilir. - Anlık Derleyici ve Linter Tanıları: Ajan bir dosyaya yama uyguladığı anda LSP'nin ürettiği tip uyuşmazlıkları veya eksik import hataları derhâl döngüye beslenir; böylece geliştirici müdahale etmeden hata yakalanır.
Bu yapısal yaklaşım, özellikle dokümantasyonu zayıf eski projelerde veya karmaşık protokol analizlerinde büyük avantaj sağlar. Ekibiniz kapalı kaynaklı bir API'yi veya ikili dosyayı çözümleyip ardından yerel depoda istemci kodu yazıyorsa, OpenCode'un LSP bağlamını REA (Reverse Engineer Anything) MCP mimari rehberinde ele aldığımız tersine mühendislik araçlarıyla aynı oturumda birleştirmek uçtan uca bir analiz hattı kurmanızı sağlar.
75+ LLM Sağlayıcı Desteği, Plan ve Build Ajan Modları
OpenCode'un 228 bin yıldızı aşan topluluk benimsenmesinin temelinde, model katmanında tam egemenlik sunması yatar. Proje, Models.dev kayıt defteri entegrasyonu sayesinde 75'ten fazla LLM sağlayıcısına doğrudan bağlanır. Anthropic Claude, OpenAI GPT, Google Gemini, AWS Bedrock, Groq ve OpenRouter gibi bulut servislerinin yanı sıra, verilerin şirket ağı dışına çıkmasının yasak olduğu senaryolarda Ollama veya LM Studio üzerinden çalışan yerel açık ağırlıklı modeller aynı arayüzde kullanılır.
Kimlik doğrulama yönetimi opencode auth login komutuyla yerel olarak ~/.local/share/opencode/auth.json dosyasında tutulur ya da CI/CD ve konteyner ortamları için standart .env değişkenlerinden okunur. Ayrıca geliştiriciler mevcut kurumsal kodlama aboneliklerini (GitHub Copilot veya ChatGPT hesapları gibi) ek ara katman yazmadan bağlayabilir.
Plan ve Build Modları Arasında Kontrollü Geçiş
Mühendislik hatalarının çoğu, ajanın mimari sınırları netleştirmeden doğrudan dosyalara yazmaya başlamasından kaynaklanır. OpenCode, varsayılan olarak iki ayrı birincil ajan profiliyle gelir ve TUI içinde Tab tuşuyla (veya CLI'da --agent plan parametresiyle) anında geçiş yapılmasına olanak tanır:
planAjanı: Kod tabanını incelemek, bağımlılık grafiklerini çıkarmak, veri şeması değişikliklerini tartışmak ve adım adım uygulama planı oluşturmak için yüksek analiz odaklı çalışır.buildAjanı: Onaylanan plan doğrultusunda düşük sıcaklık (temperature) ayarlarıyla deterministik dosya yamaları uygular, test komutlarını çalıştırır ve LSP tanıları temizlenene kadar düzenlemeyi tamamlar.
Kurulum, MCP Sunucuları ve V2 Sıralı İzin Matrisi
OpenCode, kurulum tarafında bağımlılık karmaşasını ortadan kaldıran hafif dağıtım kanalları sunar. macOS, Linux veya Windows ortamında tercih ettiğiniz paket yöneticisiyle birkaç saniyede kurulum yapabilirsiniz:
# Hızlı kurulum betiği (macOS / Linux)
curl -fsSL https://opencode.ai/v2/install | bash
# Alternatif: Homebrew (macOS / Linux)
brew install anomalyco/tap/opencode-v2
# Alternatif: npm ile çapraz platform kurulum
npm i -g @opencode/cli@latest
# Sağlayıcı kimlik doğrulaması ve uzak sunucu başlatma
opencode auth login
opencode serve --port 4096
# Başka bir terminalden çalışan sunucuya bağlanmak için:
opencode attach http://127.0.0.1:4096
Proje kök dizinine yerleştirilen opencode.jsonc (veya opencode.json) dosyası, ekip genelinde aynı model varsayılanlarını, Model Context Protocol (MCP) bağlantılarını ve güvenlik sınırlarını Git altında versiyonlamanızı sağlar. OpenCode V2 şemasında MCP sunucularının mcpServers yerine mcp.servers altında, izinlerin ise tekil anahtar yerine kök düzeydeki permissions dizisinde tanımlanması gerekir:
{
"$schema": "https://opencode.ai/config.json",
"default_agent": "plan",
"model": "anthropic/claude-sonnet-4-5",
"agent": {
"plan": {
"temperature": 0.4,
"description": "Salt okunur mimari inceleme ve görev ayrıştırma ajanı"
},
"build": {
"temperature": 0.15,
"description": "Onaylı plan doğrultusunda kod yazma ve yama uygulama ajanı"
}
},
"mcp": {
"servers": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "./src"],
"enabled": true
},
"internal-docs": {
"type": "remote",
"url": "https://mcp.internal.example/sse",
"headers": {
"Authorization": "Bearer ${INTERNAL_MCP_TOKEN}"
},
"enabled": true
}
}
},
"permissions": [
{ "action": "shell", "resource": "*", "effect": "ask" },
{ "action": "shell", "resource": "git status *", "effect": "allow" },
{ "action": "shell", "resource": "git diff *", "effect": "allow" },
{ "action": "shell", "resource": "npm test *", "effect": "allow" },
{ "action": "shell", "resource": "git push *", "effect": "deny" }
]
}
Uyarı
OpenCode varsayılan olarak kendi geliştirici makinenizdeki kabuk ortamında doğrudan çalışır; Docker tabanlı bir sanal kum havuzu (sandbox) sağlamaz. V2 permissions dizisi "son eşleşen kural kazanır" (last-match wins) mantığıyla değerlendirildiğinden, önce genel "" için "ask" kuralını koyun, ardından yalnızca güvenli salt okunur komutları "allow", git push veya veritabanı sıfırlama komutlarını ise en altta açıkça "deny" ile kilitleyin.
Mühendislik Karşılaştırması: OpenCode, OpenHands, Goose ve Kapalı Ajanlar
2026 açık kaynak kodlama ajanı ekosisteminde tek bir aracın her iş yükünü kusursuz çözmesini beklemek gerçekçi değildir. Kasım 2026 açık kaynak yapay zekâ ajan ekosistemi ve eğilimler analizimizde ayrıntılandırdığımız üzere, doğru mimari seçim çalışma izolasyonu, form faktörü ve otonomi düzeyine göre belirlenir.
| Karşılaştırma Boyutu | OpenCode | OpenHands | Goose | Kapalı Sağlayıcı Ajanları |
|---|---|---|---|---|
| Çalışma Modeli | Hafif terminal TUI, masaüstü ve istemci-sunucu (serve/attach) | Web arayüzü, CLI ve Python/TS SDK destekli otonom ajan | Rust tabanlı masaüstü uygulaması, CLI ve REST/SSE API (goosed) | Tek sağlayıcıya bağlı CLI veya IDE eklentisi |
| İzolasyon Düzeyi | Yerel makinede doğrudan çalışma + V2 kural tabanlı izin matrisi | Varsayılan Docker/Kubernetes sandbox konteyner izolasyonu | Yerel makinede çalışma, TLS + gizli anahtar korumalı arka plan servisi | Sağlayıcı bulut kum havuzu veya yerel eklenti onay penceresi |
| Kod Zekâsı ve Bağlam | Otomatik LSP sunucu keşfi, sembol ve derleyici tanıları | Olay akışı (EventStream), çoklu dosya yama ve otonom test döngüsü | 70+ MCP eklentisi ve taşınabilir YAML tarifleri (Recipes) | Sağlayıcıya özel indeksleme ve kapalı bağlam yönetimi |
| Model Özgürlüğü | 75+ LLM sağlayıcı (Models.dev), yerel Ollama ve abonelik desteği | Model bağımsız (bulut API ve yerel modeller), mikroajan desteği | 15+ LLM sağlayıcı (Anthropic, OpenAI, Google, Bedrock, Ollama) | Genellikle tek model ailesi veya kısıtlı özel uç noktalar |
| Lisans ve Yönetişim | MIT Lisansı (anomalyco/opencode) | MIT Lisansı (OpenHands/OpenHands) | Apache-2.0 Lisansı (Linux Foundation AAIF — aaif-goose/goose) | Ticari kapalı kaynak lisans |
| İdeal Kullanım Alanı | Günlük hızlı terminal kodlaması, LSP hassasiyeti, düşük gecikme | İzole ortamda çoklu dosya refaktöring ve kendi testini koşturan görevler | Masaüstü + CLI + gömülü API ve tekrarlanabilir ekip tarifleri | Tek ekosistemde yönetilen standart kurumsal lisanslar |
Tablodan açıkça görüldüğü gibi OpenCode, geliştiricinin klavyeden elini kaldırmadan aktif olarak eşli programlama (pair programming) yaptığı, LSP tip doğruluğunun ve milisaniye düzeyinde TUI tepkiselliğinin öne çıktığı günlük mühendislik işlerinde rakipsiz bir hız sunar. Buna karşılık bir görevi tamamen arka plana devredip izole bir konteyner içinde onlarca dosyayı değiştirmesini ve tüm birim testleri yeşil olana kadar yinelemesini istiyorsanız OpenHands sandbox otonom yazılım ajanı rehberini incelemelisiniz. Aynı motoru hem teknik olmayan ekip üyeleri için yerel bir masaüstü uygulamasında hem de arka uç mikroservislerinden çağrılan bir REST/SSE API olarak konumlandırmak istediğinizde ise Goose masaüstü, CLI ve API kodlama ajanı rehberi doğru mimari alternatifi sunar.
Kurumsal Ekipler İçin OpenCode Devreye Alma Kontrol Listesi
OpenCode'u bireysel bir terminal aracından kurumsal standartta güvenilir bir mühendislik bileşenine dönüştürmek için ekip içinde şu beş pratik kuralı uygulamak gerekir:
- Sürüm Kontrollü
opencode.jsoncŞablonu: Her deponun kökünde varsayılan ajanıplanolarak sabitleyen, tehlikeli kabuk kalıplarını yasaklayan ve ekip onaylı MCP sunucularını tanımlayan temiz bir yapılandırma dosyası bulundurun. - Merkezi Model Yönlendirme ve Veri Sınırları: KVKK, GDPR veya müşteri gizlilik sözleşmesi kapsamındaki depolarda API anahtarlarını bireysel geliştirici makinelerine dağıtmak yerine şirket içi bir LLM ağ geçidine veya yerel Ollama sunucusuna yönlendirin.
- MCP Tedarik Zinciri Denetimi:
npx -yile dışarıdan anlık paket indiren MCP sunucularının sürüm numaralarını sabitleyin; üretim veritabanlarına yalnızca salt okunur rol tanımlı bağlantılar açın. - LSP Sağlığı ve Derleme Senkronizasyonu: TypeScript, Go veya Python dil sunucularının geliştirme konteynerlerinde (DevContainer) hazır yüklü gelmesini sağlayın; böylece OpenCode ilk açılışta tam sembol grafiğiyle başlar.
- Ölçülebilir Kod İnceleme Disiplini: Ajanın ürettiği her yamayı standart pull request şablonundan, statik analiz araçlarından ve otomatik test hattından geçirerek kalite metriklerini takip edin.
İpucu
Eski ve büyük bir kod tabanına yeni katılan geliştiricileri hızlandırmak için iç derleme sunucusunda yalnızca plan moduna izin veren bir opencode serve örneği çalıştırın. Yeni ekip üyeleri opencode attach ile bağlanıp hiçbir dosyayı bozma riski olmadan LSP destekli mimari analiz soruları sorabilir.
Kurumunuzun özel yazılım geliştirme süreçlerine sağlayıcı bağımsız yapay zekâ kodlama ajanları, özel MCP sunucuları ve sıfır güven izin mimarileri entegre etmek istiyorsanız, Kling Digital mimarlarıyla doğrudan görüşmek için iletişim sayfamız üzerinden bize ulaşabilirsiniz.




