OpenCode'da Ustalaşmak: Yerel Öncelikli Yapay Zeka Kodlama için Nihai Kılavuz

OpenCode, sadece bir başka yapay zeka kodlama asistanı değildir. Gerçek bir eşli programcı (pair programmer) olarak hareket etmek üzere tasarlanmış yerel öncelikli, otonom bir kodlama ajanıdır. Basit otomatik tamamlama araçlarının aksine, OpenCode tüm deponuzu anlar, karmaşık yeniden düzenlemeler (refactoring) planlar ve terminal komutlarını yürütür — tüm bunları yaparken kodunuzu makinenizde güvende tutar.

Bu nihai kılavuzda, sıfırdan başlayıp OpenCode'un en gelişmiş özelliklerinde ustalaşmak için ihtiyacınız olan her şeyi ele alacağız.

1. Kurulum: Otonom Kodlamaya Açılan Kapınız

Başlamak, sorunsuz olacak şekilde tasarlanmıştır. OpenCode terminalinizde yerel olarak çalışır, yani VS Code, JetBrains veya bağımsız bir kabuk (shell) olsun, çalıştığınız her yerde çalışır.

Hızlı Kurulum (Mac, Linux, Windows WSL)

Kurulumun en hızlı yolu resmi betiğimizdir:

curl -fsSL "https://opencode.ai/install" | bash

Alternatif: npm Paketi

Araçları Node.js üzerinden yönetmeyi tercih ediyorsanız, OpenCode'u global olarak kurabilirsiniz:

npm install -g opencode-ai

Kurulduktan sonra, kurulumu doğrulamak ve kullanıcı arayüzünü başlatmak için opencode yazmanız yeterlidir.

2. Modeller ve Sağlayıcılar: Sınırsız Seçenek (BYOK)

OpenCode'un temel felsefelerinden biri Model Tarafsızlığıdır. Sizi tek bir "kara kutu" modele hapsetmeyiz. Bunun yerine, kendi anahtarlarınızı getirmenize (BYOK) veya mevcut yapay zeka aboneliklerinize bağlanmanıza izin veririz.

Kimlik Doğrulama

Tercih ettiğiniz model sağlayıcısını bağlamak için şunu çalıştırın:

opencode auth login

Bu etkileşimli komut, şunlarla oturum açmanız için size rehberlik edecektir:

• Anthropic (Claude 4.5 Sonnet, Opus)
• OpenAI (GPT-5, o1-preview)
• Google (Gemini 3 Pro, 1.5 Pro)
• Models.dev (75+ açık kaynaklı ve barındırılan modele erişim)

Modelleri Yönetme

Göreve bağlı olarak modelleri anında değiştirebilirsiniz. Basit düzeltmeler için daha hızlı bir model, mimari planlama için daha güçlü bir akıl yürütme modeli kullanın.

# Mevcut tüm modelleri listele
opencode models

# Yeni bir sağlayıcı ekledikten sonra model listesini yenile
opencode models --refresh

Ollama ile Yerelleşme

Üstün gizlilik ve çevrimdışı yetenek için OpenCode, Ollama aracılığıyla yerel modelleri destekler. Hiçbir veri ağınızdan çıkmadan kodlamak için OpenCode'u yerel örneğinize yönlendirin — kurumsal ortamlar veya hassas fikri mülkiyet üzerinde çalışmak için mükemmeldir.

3. Temel İş Akışı: Etkileşimli vs. Tek Seferlik

OpenCode, çalışma şeklinize uyum sağlar.

Etkileşimli Oturum

OpenCode'u kullanmanın en güçlü yolu Etkileşimli Oturumdur. Kalıcı bir sohbet ortamına girmek için proje kök dizininizde opencode çalıştırın.

• Bağlam Farkındalığı: Ajan, dosya yapınızı ve LSP sinyallerini okur.
• Çok Turlu: Planı iyileştirebilir, düzeltmeler isteyebilir ve yineleyebilirsiniz.
• Araç Kullanımı: Ajan özerk olarak dosyaları okuyabilir, kodu düzenleyebilir ve testler çalıştırabilir.

Tek Seferlik Komut (One-Off)

Tam bir konuşmaya ihtiyacınız olmayan hızlı görevler için opencode run kullanın. Bu, "ateşle ve unut" talimatları için mükemmeldir.

# Kod tabanını özetle ve iyileştirmeler öner
opencode run "Analyze this codebase and propose a refactoring plan for performance"

# Hızlı düzeltme
opencode run "Fix the type error in src/utils/helper.ts"

4. Ajanlar ve İzinler: Önce Güvenlik

Bir yapay zekaya terminalinize ve dosya sisteminize erişim vermek güven gerektirir. OpenCode bunu sağlam bir İzin Sistemi ve uzmanlaşmış Ajanlar ile çözer.

Ayrıntılı İzinler

Ajanın tam olarak ne yapabileceğini siz kontrol edersiniz. İzinleri global olarak veya oturum başına ayarlayın:

• İzin Ver (Allow): Ajan komutları çalıştırır ve dosyaları otomatik olarak düzenler.
• Sor (Ask): Ajan her eylem için onayınızı istemelidir (hassas işlemler için varsayılan).
• Reddet (Deny): Ajanın eylemi gerçekleştirmesi kesinlikle yasaktır.

Uzmanlaşmış Ajanlar: Planla vs. İnşa Et

Riski en aza indirmek için bölünmüş bir iş akışı öneriyoruz:

1. Planlama Ajanı (Plan Agent): Kodu analiz etmek ve bir strateji taslağı oluşturmak için bir "Planlayıcı" model kullanın. Bu ajanı Salt Okunur veya Sor modunda tutun.
2. İnşa Ajanı (Build Agent): Plan onaylandıktan sonra, değişiklikleri hızla yürütmek için İzin Ver izinlerine sahip bir "İnşaatçı" ajanına geçin.

5. Gelişmiş Özellikler: Çoklu Oturum ve Paylaşım

Gerçek dünya mühendisliği doğrusal değildir. OpenCode, çoklu görev ihtiyaçlarınızı karşılamak için gelişmiş iş akışlarını destekler.

Paralel Oturumlar

Uzun süren bir yeniden düzenlemenin hızlı hata düzeltmenizi engellemesine izin vermeyin. OpenCode, birden fazla paralel oturum çalıştırmanıza olanak tanır.

• Oturum A: "Kimlik doğrulama ara yazılımını yeniden düzenle."
• Oturum B: "Anasayfadaki CSS z-index hatasını düzelt."

Bu oturumlar bağımsız olarak çalışır ve bağlamın görevler arasında karışmamasını sağlar.

Paylaşılabilir Bağlantılar

Bir ekip arkadaşınıza yapay zekanın ne yaptığını göstermeniz mi gerekiyor? Oturumunuzun titiz, salt okunur bir kaydını oluşturmak için /share kullanın.

• İşbirliği: Bir PR inceleyicisine bir bağlantı gönderin, böylece değişikliklerin neden yapıldığını görebilsinler.
• Dokümantasyon: Başarılı oturumları gelecekteki görevler için "tarifler" olarak kaydedin.
• Gizlilik Kontrolü: Paylaşım varsayılan olarak kapalıdır. Neyin yayınlanacağını açıkça siz kontrol edersiniz.

Sonuç

OpenCode, kontrolden veya gizlilikten ödün vermeden yapay zekanın gücünü isteyen geliştiriciler için oluşturulmuştur. Bu iş akışlarında ustalaşarak — doğru modelleri seçerek, ayrıntılı izinlerden yararlanarak ve paralel oturumları kullanarak — OpenCode'u basit bir yardımcıdan yorulmak bilmeyen otonom bir ortağa dönüştürebilirsiniz.

Başlamaya hazır mısınız? OpenCode'u şimdi kurun ve yerel öncelikli mühendisliğin geleceğini deneyimleyin.