Kurs
Yapay Zekayı Anlamak
2 sa
425.9K
OpenCode bir görevi yerine getirmek için geliştirilmiştir. Bir yapay zekâ modelini deponuza, terminalinize ve geliştirme araçlarınıza bağlayan açık kaynaklı bir ajandır. Ondan bir hatayı düzeltmesini isteyin; ilgili dosyaları bulabilir, bir plan taslağı çıkarabilir, kodu düzenleyebilir, testleri çalıştırabilir ve hatalara yanıt verebilir. Otomatik tamamlama bunu kendi başına yapamaz.
Bu daha geniş rol dikkat çekti. Bu yazı yazılırken, aktif OpenCode deposunun yaklaşık 189.000 GitHub yıldızı vardı. Yıldızları kod kalitesinin kanıtı olarak görmem, ancak projenin ne kadar ilgi çektiğini gösterirler.
Gerçeklik ise daha dağınık. OpenCode size model seçimi sunar ve ardından bu seçimi yönetmenizi ister. Ocak 2026'da bir sağlayıcı politika değişikliği, bu seçeneklerin ne kadar hızlı değişebileceğini gösterdi. Bunu, OpenCode'un nasıl çalıştığı ve nereye oturduğuyla birlikte ele alacağım.
Devam etmeden önce kısa bir adlandırma notu: OpenCode'u ararsanız, arşivlenmiş, Go tabanlı opencode-ai/opencode deposunu bulabilirsiniz. Bu proje Eylül 2025'te bakıma alınmayı bıraktı. Biz, github.com/anomalyco/opencode adresindeki, Serverless Stack (SST) çatısının arkasındaki ekip tarafından geliştirilen aktif projeye odaklanacağız.
OpenCode Nedir?
OpenCode, MIT lisansı altında yayımlanan açık kaynaklı bir yapay zekâ kodlama ajanıdır. Modelden bağımsızdır; yani tek bir model sağlayıcısıyla sınırlı değildir. Kullanıcılar kaynağı okuyabilir ve değiştirebilir. Aracı kendileri de barındırabilir. Yazılım ücretsizdir. Model faturalandırması ayrıdır; bunu özellikler bölümünde ele alacağım.
OpenCode bir büyük dil modeli (LLM) değildir. Seçilen model istemleri okur ve yanıt üretir. OpenCode ise dosya araçlarını, kabuk erişimini, oturum geçmişini, izin kurallarını ve bu modelin etrafındaki arayüzü sağlar. Bu ayrımı faydalı buluyorum çünkü modeli değiştirmek, aracın geri kalanını değiştirmeyi gerektirmez.
Anomaly (eski adıyla SST) tarafından geliştirilmektedir ve ağırlıklı olarak TypeScript ve Bun üzerinde çalışır.
Arşivlenmiş ve güncel OpenCode depolarının karşılaştırması. Görsel: Yazar.
OpenCode tek bir model ailesine bağlı değildir. Models.dev kayıt defteri aracılığıyla Anthropic, OpenAI, Google, DeepSeek, Groq ve Ollama üzerinden yerel modeller dahil 75'ten fazla sağlayıcıya bağlanır. Mevcut bazı abonelik hesapları da bağlanabilir; bunu özellikler bölümünde ele alacağım.
Dosya değişikliklerini gösteren OpenCode terminal oturumu. Görsel: Yazar.
OpenCode terminalde başladıysa da artık bir terminal arayüzü (TUI), macOS, Windows ve Linux için beta bir masaüstü uygulaması ve VS Code gibi editörler için eklentiler ile birlikte geliyor. Bu yazı yazılırken en güncel kararlı sürüm v1.18.8 idi.
OpenCode Neden Oluşturuldu?
Daha önce belirttiğim gibi OpenCode pek çok sağlayıcının modellerini destekler. Böyle tasarlandı çünkü model kalitesi ve fiyatları değişir; tek bir sağlayıcıya bağlı bir araç kullanıcıların seçeneklerini kısıtlar.
Dokümanlarda OpenCode'un herhangi bir sağlayıcıya bağlanmadığı belirtilir. Yukarıda anılan Models.dev kayıt defteri, OpenCode'un kullandığı model ayrıntılarını ve fiyatlarını sağlar.
Bu tercih faturalandırmanın ötesini etkiler. Farklı modellerin farklı bağlam sınırları, araç çağrı biçimleri ve girdi türleri vardır. OpenCode bu farklar için tek bir arayüz kullanır. Bir geliştirici, oturumu başka bir kodlama aracına taşımadan aynı projede seçili modeli değiştirebilir.
Ekip ayrıca kullanıcıların inceleyebileceği, önceliği terminal olan araçları tercih eder. Proje talimatları AGENTS.md adlı düz bir dosyada bulunur. OpenCode'un bu dosyayı nasıl oluşturup kullandığını ileride açıklayacağım.
Resmi proje üç tasarım seçeneğinden söz eder. İlki yukarıda bahsedilen sağlayıcı desteğidir. İkincisi ana kontrolleri terminalde tutar. Üçüncüsü istemci ve sunucuyu ayırır. Sırada bu ayrım var.
Ocak 2026'da Anthropic, üçüncü taraf araçların resmi olmayan kanallar üzerinden tüketici Claude aboneliklerini kullanmasını engelledi. OpenCode bunun üzerine diğer abonelik seçeneklerini ekledi ve kendi ağ geçidini kullandı. Kullanıcılar hâlâ diğer sağlayıcılar üzerinden bağlanabiliyordu.
Bu olay, OpenCode'da neden sağlayıcı seçimine bu kadar önem verildiğini açıklar. Kullanıcıların bu seçenekle ne yaptığını görmek için sonraki adım bir oturuma bakmaktır.
OpenCode Nasıl Çalışır?
OpenCode bir istemci ve yerel bir sunucu olarak çalışır. TUI, masaüstü uygulaması, IDE eklentileri ve SDK, HTTP üzerinden bu sunucuyla konuşur. Aynı sunucu, opencode attach <url> ile uzaktan bağlanmayı ve opencode serve ile başsız kullanımı destekler.
Bir oturum içinde, ajan ilgili dosyaları okur, gerekirse bir plan taslağı çıkarır, kodu düzenler ve gerektiğinde komutlar çalıştırır. Dil Sunucusu Protokolü (LSP) entegrasyonu, derleyici ve linter bulgularını tür ve sözdizimi hatalarına yanıt verebilmesi için modele geri besler.
Örneğin, bir görev dosyaları bulmak için glob veya grep ile başlayabilir. Ajan read ile bunları inceleyebilir ve seçili satırları değiştirmek için edit kullanabilir. Ardından bir test veya build komutu çalıştırmak için bash kullanabilir. Çıktı, bir sonraki model isteğinin parçası olur.
Build ve Plan ayrımını bir izin anahtarı olarak düşünmek en kolayı. Build varsayılandır ve okuma, yazma ve komut çalıştırma yetkisine sahiptir. Plan ise dosyaları düzenlemeden veya bash komutları çalıştırmadan önce sorar. Tab tuşuna basmak aralarında geçiş yapar.
İzin kontrolleri bir araç çağrıldığında uygulanır. Bir proje bir aracı izinli kılabilir, engelleyebilir veya her seferinde kullanıcıya sorabilir. Kurallar, komut desenine göre de değişebilir. Bir ekip rutin testlere izin verip diğer kabuk komutları için onay isteyebilir.
Oturumlar disk üzerinde, OpenCode'un veri dizini altında yerel olarak saklanır. OpenCode uzun konuşmaları otomatik olarak sıkıştırır. /undo ve /redo komutları Git tabanlı dosya anlık görüntüleri arasında gezinir.
OpenCode'un Temel Özellikleri
OpenCode ana işlevlerini model erişimi, proje bağlamı, görev yürütme ve yerel kullanım olarak gruplar. Aşağıdaki bölümler, bir kodlama oturumu sırasında her grubun neleri değiştirdiğini açıklar.
Çoklu model desteği
Daha önce belirtildiği gibi, OpenCode sağlayıcı listesini Models.dev üzerinden alır. Pratikte, kullanıcılar barındırılan bir hizmete, bir bulut platformuna veya OpenAI uyumlu bir uç noktaya bağlanabilir. GitHub Copilot ve ChatGPT Plus/Pro oturumları ayrı bir API anahtarı yönetimine alternatif sunar.
Sağlayıcı seçimi, her modelin aynı şekilde davranacağı anlamına gelmez. Araç kullanımı, bağlam sınırları, yanıt süresi ve fiyat yine seçilen model ve sağlayıcıya bağlıdır. Barındırılan modellere yapılan çağrılar, gerekli kod bağlamını da kendi veri kuralları altında ilgili sağlayıcıya gönderir.
OpenCode model erişimi için iki isteğe bağlı yol daha sunar. OpenCode Zen, seçili bir model listesiyle kullandıkça öde tipinde bir ağ geçididir. OpenCode Go ise seçili açık ağırlıklı modeller için ilk ay 5$, sonrasında ayda 10$ tutarında bir aboneliktir. Kullanıcılar yine kendi API anahtarlarını sağlayabilir. Fiyatlar değişebilir.
Can sıkıcı kısım şu: ücretsiz bir araç yine de bir sağlayıcı faturası çıkarabilir.
Depo bağlamıyla çalışma
/init çalıştırın ve OpenCode projenin yapısı ve kurallarına ilişkin bir AGENTS.md özeti üretir. Ekipler bu dosyayı commit'leyerek oturumların ortak talimatlarla başlamasını sağlayabilir.
Dosya; test komutlarını, klasör adlarını, adlandırma kurallarını ve projeyle ilgili notları içerebilir. Genel bir AGENTS.md birden çok projede kullanılan talimatları tutabilir. Proje dosyası ise tek bir depo için kuralları barındırır.
Daha önce anlatılan LSP kontrolleri düzenlemelerden sonra çalışır. Depo bağlamı dosya atıflarını da içerir: @ sembolü seçili bir dosyayı bir isteme çeker.
Kodlama görevlerini çalıştırma
Yukarıda açıklanan Build ve Plan ajanlarının ötesinde OpenCode, çok adımlı aramalar, kod tabanı taraması ve harici dokümantasyon için alt ajanlar içerir. Özel ajanların kendi modeli, istemi ve araç izinleri olabilir.
Her alt ajan bir alt oturumda çalışır; böylece iletileri ana oturumu aynı şekilde doldurmaz. Özel bir ajan yalnızca dosya okumakla sınırlandırılabilir, daha düşük maliyetli bir modele atanabilir veya tek tür bir görev için talimatlar alabilir.
Model Context Protocol (MCP) sunucuları harici hizmetler ekler. opencode.json içinde tanımlanırlar ve daha önce anlatılan izin kontrolleri, ekledikleri araçlar için de geçerlidir.
Planlamadan kod değişikliklerine geçiş. Video: Yazar.
Önce yerel geliştirme (ve sınırları)
“Önce yerel” terimi bir niteleme gerektirir. Bunu, hiçbir şeyin makineyi asla terk etmeyeceği bir vaat olarak okumam. Sağlayıcı bölümünde belirtildiği gibi OpenCode, Ollama'ya bağlanabilir. Bu kurulum, kod ve istemleri yerel altyapıda tutar. Barındırılan modeller, /share ve OpenCode Zen, verileri yerel makinenin dışına gönderir.
Yerel kullanım yine de modele bağlıdır. Küçük modeller geçersiz araç çağrıları döndürebilir veya dosyalar arasındaki bağlantıları kaçırabilir. Yerel bir sunucunun, seçilen model için yeterli belleğe ve her istekle gönderilen dosyalar için yeterli bağlam alanına ihtiyacı vardır.
İzin sistemi bir güvenlik kum havuzu değil, iş akışı emniyetidir. Ağ üzerinden erişilen sunucu modunda OPENCODE_SERVER_PASSWORD kullanılmalı ve localhost'a bağlanılmalıdır. Önceki kimlik doğrulamasız ifşa sorunu yamandı; yine de sunucu modu kimlik doğrulaması olmadan herkese açık şekilde yayımlanmamalıdır.
OpenCode Mimarisi
Daha önce belirttiğim gibi OpenCode, istemcilerini yerel sunucusundan ayırır. Bu ayrım, yapılandırmayı ve saklanan durumu etkiler. API, sunucuyu kullanmanın başka bir yolunu ekler.
Yalnızca TUI kullanmayı planlıyorsanız, API ayrıntılarını atlayabilirsiniz. Sonda yer alan yapılandırma paragrafı, kullanacağınız kısımdır.
TypeScript ve Bun sunucusu, model sağlayıcılarıyla konuşur ve araçları çalıştırır. Durumu da yönetir. OpenAPI 3.1 belirtimi resmi @opencode-ai/sdk'yi üretir. Betikler ve özel istemciler bu belgelenmiş API'yi kullanabilir.
API; oturumlar, iletiler, dosyalar, sağlayıcılar, araçlar, ajanlar ve yapılandırmayı kapsar. Bu, OpenCode'un kendi istemcilerinin kullandığı sunucunun aynısıdır. Bir betik, TUI'yi kontrol etmeye çalışmadan bir oturum oluşturabilir veya bir ileti gönderebilir.
OpenCode istemcileri tek bir sunucuya bağlanıyor. Görsel: Yazar.
Önceden listelenen arayüzler istemci olarak hareket eder: TUI, masaüstü uygulaması, IDE eklentisi ve opencode web. Her biri aynı sunucu süreciyle konuşur. Ayrı bir cihaz, bu süreç üzerinden mevcut bir oturuma bağlanabilir.
opencode serve çalıştırmak, sunucuyu normal TUI olmadan başlatır. opencode web çalıştırmak ise bir tarayıcı istemcisi ekler. Her iki komut da sunucu başka bir cihazdan erişilebilir durumdaysa kimlik doğrulaması gerektirir.
Yapılandırma, proje düzeyindeki opencode.json veya opencode.jsonc içinde bulunur; küresel geri dönüş ~/.config/opencode/opencode.json yolundadır. Modelleri, izinleri, MCP sunucularını ve özel ajanları kontrol eder. İş akışı bölümünde ele alındığı gibi, oturum geçmişi ve araç günlükleri kullanıcı paylaşmadıkça yerel dosyalarda kalır.
Yaygın OpenCode İş Akışları
OpenCode'un aynı parçaları, birkaç yaygın yazılım görevi için kullanılabilir. Aşağıdaki örnekler, her birinde insan incelemesinin hâlâ nerede önemli olduğunu gösterir.
Yeni özellikler geliştirme
Yukarıda açıklanan Plan'dan Build'a süreci kullanarak bir geliştirici bir özellik talep edebilir ve herhangi bir düzenleme yapılmadan önce önerilen adımları gözden geçirebilir. Ardından Tab tuşuna basmak, görevi kod değişiklikleri ve testler için Build moduna taşır.
Plan, herhangi bir dosya değişikliğinden önce revize edilebilir. Ben bu incelemeyi kapsamı düzeltmek, değişmemesi gereken dosyaları adlandırmak veya test gereksinimleri eklemek için kullanırım.
Mevcut kodu yeniden düzenleme
Aynı Plan'dan Build'a süreci yeniden düzenleme için de çalışır. Plan modu, Build modu düzenlemeleri uygulamadan önce bağımlılıkları ve çağrı yerlerini belirleyebilir. Sonuç yanlışsa /undo daha önceki anlık görüntüyü geri yükler. Testlerin geçmesi, her genel arayüzün aynı kaldığını doğrulamadığından, kullanıcı yine de diff'i incelemelidir.
Uygulamaları hata ayıklama
Hata ayıklama için OpenCode, bir yığın izi ile dil sunucusundan tür bilgisini birleştirebilir. Bir değişiklik önerebilir, hataya yol açan adımları yeniden çalıştırabilir ve sonucu kontrol edebilir. Net yeniden üretim adımları olmadan yalnızca kodun derlendiğini veya mevcut testlerin geçtiğini doğrulayabilir.
Test yazma
Daha önce anlatıldığı gibi, Build modu dosyaları düzenleyebilir ve komutlar çalıştırabilir. Test yazımı için bu, bir test oluşturabileceği, sonucu okuyabileceği ve başka bir değişiklik yapabileceği anlamına gelir. Tam bir test paketi daha fazla geri bildirim sağlar ancak daha uzun sürer.
Test kalitesi yine insan incelemesi gerektirir. Oluşturulan bir test, kullanıcıların bağlı olduğu davranışı kontrol etmek yerine uygulamayı tekrar edebilir.
Büyük kod tabanlarını anlama
Depo bölümü, /init'in proje notlarını nasıl oluşturduğunu açıklamıştı. Bu adımdan sonra “Burada kimlik doğrulama nasıl çalışıyor?” gibi bir soru aramayı yönlendirebilir. @general alt ajanı, deponun birkaç bölümünde arama yapabilir.
Belirli sorular, tüm depoyu açıklama isteklerine kıyasla genellikle daha net sonuçlar üretir. @ ile yapılan dosya atıfları aramayı daha da daraltabilir.
OpenCode vs. Diğer Yapay Zekâ Kodlama Ajanları
Bu araçlar lisans, model desteği, arayüz ve faturalandırma bakımından farklılık gösterir. Bunları, tek bir aracı varsayılan seçim olarak görmek yerine bu noktalar üzerinden karşılaştırıyorum.
OpenCode vs. Claude Code
Daha ayrıntılı bir OpenCode ve Claude Code karşılaştırması makalemiz var. Claude Code tescillidir ve Anthropic'in modeli ve hesap sistemiyle çalışır. OpenCode MIT lisansı kullanır ve kullanıcıdan bir sağlayıcı seçmesini ister. Ayrıca kullanıcılara kaynak koduna ve yapılandırmasına erişim verir. Geçmiş bölümünde belirtildiği gibi, tüketici Claude abonelikleri artık OpenCode üzerinden çalışmadığı için Claude kullanımı, ölçülen bir Anthropic API anahtarı gerektirir.
Her iki araç da dosyaları okuyabilir, değişiklik yapabilir, komut çalıştırabilir ve MCP sunucularını kullanabilir. Temel fark model erişimidir: Claude Code, yukarıda açıklanan Anthropic kurulumunda kalırken, OpenCode başka sağlayıcılara veya yerel bir uç noktaya bağlanabilir.
OpenCode vs. Cursor
Cursor, CLI ve bulut ajanları da sunan, VS Code tabanlı bir IDE'dir. Ana iş akışı önerileri, dosya değişikliklerini ve ajan eylemlerini editör içinde tutar. OpenCode, yukarıda listelenen terminal, masaüstü ve editör arayüzlerini kullanır. Cursor ücretli abonelik planları kullanır. OpenCode'un yazılımı ücretsizdir; ancak kullanıcılar tokenlar için bir model sağlayıcıya ödeme yapabilir. Başlıca farklar çalışma arayüzü, model seçimi ve faturalandırma yöntemidir.
Cursor ayrıca geliştirici yazarken satır içi tamamlama içerir. OpenCode, bir ajana verilen görevlere odaklanır ve bu tür bir tamamlamanın yerini almaz. Bazı geliştiriciler farklı işler için her iki araç türünü de kullanabilir.
OpenCode vs. Cline
Cline'ın çekirdek projesi, VS Code ve CLI arayüzlerine sahip, BYOK prensibiyle çalışan açık kaynaklı bir ajandır. Ayrıca bir JetBrains istemcisi vardır; ancak bu istemci bu yazı yazıldığı sırada açık kaynak değildir. Hem Cline hem de OpenCode MCP'yi destekler ve kullanıcıların onay kuralları belirlemesine izin verir. Cline, editör kontrollerini bir kenar çubuğuna yerleştirir. OpenCode, bir editörden bağımsız olarak çalışabilen terminal oturumları kullanır. Seçim, ağırlıklı olarak bir geliştiricinin değişiklikleri nerede gözden geçirip onaylamak istediğine bağlıdır.
Cline, Apache 2.0 lisansını kullanır. OpenCode, yukarıda belirtilen MIT lisansını kullanır. Her ikisi de kaynak incelemesine ve değişikliklere izin verir; ancak arayüzleri ve proje dosyaları farklıdır.
Aider ve Codex CLI da terminal tabanlı kodlama ajanlarıdır. OpenCode, aynı projede terminal, masaüstü ve IDE kullanımını kapsar ve birden çok sağlayıcının modellerini destekler.
OpenCode'un Kurulumu ve İlk Adımlar
Resmi kurulum betiği çoğu Unix benzeri sistemde çalışır. Komut satırı aracını kurmanın bir yolunu sağlar:
Komut, OpenCode ikili dosyasını indirir ve kullanıcının ortamına ekler. Güncellemelerin sistemin geri kalanıyla birlikte yönetildiği durumlarda bir paket yöneticisi daha uygun olabilir.
curl -fsSL https://opencode.ai/install | bashPaket yöneticisi seçenekleri arasında npm i -g opencode-ai@latest, brew install anomalyco/tap/opencode (macOS ve Linux'ta) ve scoop install opencode veya choco install opencode (Windows'ta) yer alır. macOS, Windows ve Linux için bir masaüstü uygulaması mevcuttur. Windows'ta, bazı dosya sistemi ve kabuk işlevleri orada daha iyi çalıştığı için, OpenCode dokümantasyonu WSL'yi önerir.
Kurulum, model erişimini içermez. İlk oturum yine çoklu model bölümünde anlatılan erişim yöntemlerinden birine ihtiyaç duyar.
Proje talimatlarını oluşturmadan önce OpenCode'u kurma. Video: Yazar.
OpenCode'u kullanmak gerçekten ücretsiz mi?
OpenCode içinde Claude modellerini kullanabilir miyim?
OpenCode internetsiz çalışır mı?
Arşivlenmiş opencode-ai/opencode deposu aynı proje mi?
OpenCode kaynak kodumun gizliliğini nasıl ele alıyor?
Konular