Açık kaynak · MIT Ücretsiz Aktif geliştiriliyor Kod Asistanı

OpenCode Kurulumu

Terminalde çalışan açık kaynak kod ajanı: Projenizi okur, dosyaları düzenler, komut çalıştırır; Ollama'daki yerel modelle de çalışır.

Editör testi: · sürüm 2.1.4 221 bin GitHub yıldızı Son sürüm v1.19.4 (2 gün önce)

OpenCode nedir?

OpenCode, terminalde çalışan açık kaynak bir yapay zekâ kod ajanıdır. Bir proje klasöründe açtığınızda dosyaları okur, istediğiniz değişikliği yapar, testleri ve başka komutları çalıştırır, sonucu size anlatır. Claude Code ve GitHub Copilot'un ajan modu gibi araçların açık kaynak karşılığıdır; farkı, modeli sizin seçmenizdir.

Model olarak ücretli API'leri, OpenCode'un hesap gerektirmeyen ücretsiz bulut modellerini ya da Ollama ile kendi bilgisayarınızda çalışan yerel modelleri kullanabilirsiniz. Yerel modelle kodunuz bilgisayarınızdan hiç çıkmaz ve kurulduktan sonra internetsiz çalışır. Bedeli donanımdır: Kod ajanları her adımda uzun bir talimat metni gönderdiği için yerel modelin uzun bağlamla çalışması gerekir ve 4 GB ekran kartında basit bir düzeltme bile birkaç dakika sürdü.

Bu sayfadaki kurulum, OpenCode'u Ollama'daki yerel bir modelle çalıştırmayı anlatır; karşılaştığımız iki sessiz tuzağın (kısa bağlam ve Qwen'in düşünme modu) çözümü kurulum adımlarındadır. Ekran kartınız güçlü değilse ya da hız önemliyse aynı kurulumla ücretsiz bulut modellerini de deneyebilirsiniz. Editörünüzün içinde çalışan bir asistan arıyorsanız Cline'a bakın.

Arayüz
Komut satırı
İnternet
Kurulumdan sonra internetsiz çalışır
Kurulum
Orta: Birkaç komut satırı adımı; terminal açmayı bilmek yeter.
Türkçe
Arayüz Türkçe değil. Arayüz İngilizce; isteklerinizi Türkçe yazabilirsiniz. Yerel 4 milyar parametreli model kimi zaman cevabının yarısını İngilizce yazdı, bulut modeli baştan sona Türkçe cevap verdi.
Geliştirici
Anomaly

Artıları

  • Ollama'yı ayarsız bulur; indirdiğiniz modeller model listesinde kendiliğinden görünür.
  • Hesap açmadan kullanılabilen ücretsiz bulut modelleri var; ekran kartı olmayan bilgisayarda da çalışır.
  • Dosya okuma, düzenleme ve komut çalıştırma gibi işleri kendisi yapar; değişiklikleri ekranda fark olarak gösterir.
  • Salt okunur "plan" ajanı, kod değiştirmeden önce projeyi incelemek için güvenli bir mod sunar.
  • MIT lisanslı; şirket projelerinde de ücretsiz kullanılabilir.

Eksileri

  • Yerel model için uzun bağlam gerekir; 4 GB ekran kartında model yarı yarıya işlemcide çalışır ve her görev dakikalar sürer.
  • Küçük yerel modeller yanlış araç seçebilir ve yapmadığı işi yaptım diyebilir; sonucu kendiniz doğrulamanız gerekir.
  • Ollama'nın varsayılan 4 bin belirteçlik bağlamı OpenCode'a yetmez ve bunu uyarı vermeden bozuk cevapla gösterir.
  • Arayüz İngilizce ve yalnız terminalde çalışır; masaüstü uygulaması beta aşamasında.
  • 2. sürüme geçiş sürüyor; eski belgeler ve paket adları (opencode-ai) 1. sürümü anlatır.

Bilgisayarınız yeter mi?

Ekran kartınızı ve belleğinizi seçerek bu projenin bilgisayarınızda nasıl çalışacağını görün.

Donanımımı seç
DonanımDestekEn düşükÖnerilen
NVIDIA ekran kartı OpenCode'un kendisi ekran kartı istemez; yerel modeli Ollama çalıştırır. Boş 4 GB kartımızda qwen3.5:4b, 32 bin belirteçlik bağlamla 4,4 GB tuttu (yarısı işlemcide) ve test görevini 2 dakika 8 saniyede bitirdi. Kod ajanları uzun bağlam istediği için daha büyük kod modellerinde 16 GB ve üzeri VRAM gerekir. Tam destek 4 GB VRAM 16 GB VRAM
AMD ekran kartı Yerel model Ollama'nın AMD desteğiyle (ROCm ya da Vulkan) çalışır. Editörlerimiz AMD'de test etmedi. Tam destek 4 GB VRAM 16 GB VRAM
Apple Silicon (M serisi) Model birleşik belleği kullanır; uzun bağlam için 16 GB ve üzeri önerilir. Editörlerimiz Mac'te test etmedi. Tam destek 16 GB RAM 32 GB RAM
Ekran kartı yok (yalnız işlemci) Yerel model yalnız işlemcide çalışırsa her adım dakikalar sürer. Ekran kartınız yoksa OpenCode'u ücretsiz bulut modelleriyle kullanabilirsiniz; aynı görevi bulut modeli 10 saniyede yaptı, ama kodunuz bilgisayarınızdan çıkar. Çalışır ama yavaş 16 GB RAM 32 GB RAM
  • Sistem belleği en az 8 GB, önerilen 16 GB
  • Disk alanı en az 5 GB
  • npm paketi bütün işletim sistemleri için hazır programlarla birlikte 916 MB yer kaplar. Yerel model ayrıca iner: qwen3.5:4b 3,3 GB. Bulut modelleriyle kullanırsanız model indirmeniz gerekmez.

Resmî kaynak

GitHub deposunu aç

github.com/anomalyco/opencode

Resmî site

Yazılımı yalnızca bu adreslerden indirin. Sitemiz dosya barındırmaz; bağlantılar doğrudan projenin kendi sayfasına gider.

OpenCode'u yalnız opencode.ai adresinden ya da npm'deki @opencode/cli paketinden kurun. Adında "opencode" geçen başka projeler resmî ekiple bağlantılı değildir; eski opencode-ai paketi 1. sürümü kurar.

Lisans
MIT
Son sürüm
v1.19.4
Son güncelleme
24 Ekim 2026
GitHub yıldızı
221 bin
Reklam

Kurulum: Windows, macOS ve Linux'ta

İşletim sisteminizi seçin. Adımları tamamladıkça işaretleyin; ilerlemeniz bu tarayıcıda saklanır, sayfaya döndüğünüzde kaldığınız yerden devam edersiniz.

Windows · npm

0 / 3 adım tamamlandı

Gerekenler: Resmî belgeye göre; editörlerimiz Windows'ta test etmedi. Node.js ve Windows için Ollama kurulu olmalı. OpenCode 2 Windows paket yöneticilerini (Scoop, Chocolatey) desteklemiyor.

  1. OpenCode'u kurun

    PowerShell'de OpenCode'u npm ile kurun.

    PowerShell 
    npm install -g --allow-scripts=@opencode/cli @opencode/cli@latest

  2. Ollama'nın bağlam uzunluğunu artırın

    Ollama uygulamasının Settings ekranındaki Context length sürgüsünü en az 32k yapın. Sonra modeli indirin.

    PowerShell 
    ollama pull qwen3.5:4b

  3. Düşünme modunu kapatıp OpenCode'u açın

    Linux yöntemindeki 4. adımın içeriğini %USERPROFILE%\.config\opencode\opencode.jsonc dosyasına kaydedin, sonra proje klasörünüzde OpenCode'u açın.

    PowerShell 
    cd $env:USERPROFILE\projem
opencode

macOS · Homebrew

0 / 3 adım tamamlandı

Gerekenler: Resmî belgeye göre; editörlerimiz Mac'te test etmedi. Homebrew ve macOS için Ollama kurulu olmalı.

  1. OpenCode'u kurun

    Terminalde OpenCode'un Homebrew paketini kurun.

    Terminal 
    brew install anomalyco/tap/opencode-v2

  2. Ollama'nın bağlam uzunluğunu artırın

    Ollama uygulamasının Settings ekranındaki Context length sürgüsünü en az 32k yapın. Sonra modeli indirin.

    Terminal 
    ollama pull qwen3.5:4b

  3. Düşünme modunu kapatıp OpenCode'u açın

    Linux yöntemindeki 4. adımın içeriğini ~/.config/opencode/opencode.jsonc dosyasına kaydedin, sonra proje klasörünüzde OpenCode'u açın.

    Terminal 
    cd ~/projem
opencode

Linux · npm ve Ollama ile yerel model

0 / 5 adım tamamlandı

Gerekenler: Bu adımları Ubuntu 24.04'te Node.js 22 (npm 12) ve Ollama 0.40.10 ile test ettik. Node.js ve Ollama kurulu olmalı; Ollama'nın kurulumu için sitemizdeki Ollama sayfasına bakın.

  1. OpenCode'u kurun

    OpenCode'u npm ile kurun. npm 12 paketlerin kurulum betiklerini engellediği için OpenCode'un betiğine izin veren seçeneği ekliyoruz; eski npm sürümleri bu seçeneği yok sayar. Kurulum bizde 5 saniye sürdü.

    Terminal 
    npm install -g --allow-scripts=@opencode/cli @opencode/cli@latest
    Şunu görmelisiniz 
    changed 5 packages in 5s

  2. Ollama'yı uzun bağlamla başlatın

    Ollama varsayılan olarak 4 bin belirteçlik bağlam açar; OpenCode'un talimatı buna sığmaz ve model uyarı vermeden saçmalar. Ollama'yı 32 bin belirteçle başlatın ve bu terminali açık bırakın.

    Terminal 
    OLLAMA_CONTEXT_LENGTH=32768 ollama serve

    Ollama'nın belgesi OpenCode için 64 bin öneriyor. 4 GB kartımızda 64 binle model 5,7 GB tuttu ve görev 4 dakika 57 saniye sürdü; 32 binle 4,4 GB ve 2 dakika 8 saniye. Ekran kartı belleğiniz 8 GB ve üzeriyse 65536 yazın.

    Ollama'yı resmî betikle kurduysanız arka planda servis olarak çalışır. O durumda sudo systemctl edit ollama.service ile [Service] altına Environment="OLLAMA_CONTEXT_LENGTH=32768" satırını ekleyip servisi yeniden başlatın.

  3. Modeli indirin

    Yeni bir terminalde araç çağırmayı destekleyen bir model indirin. 4 GB ekran kartı için qwen3.5:4b (3,3 GB) uygun; Gemma 3 araç çağırmayı desteklemediği için kod ajanında çalışmaz.

    Terminal 
    ollama pull qwen3.5:4b

  4. Qwen'in düşünme modunu kapatın

    Qwen 3.5 her cevaptan önce uzun uzun düşünür; yerel modelde bu, isteklerin 5 dakikalık sınıra takılmasına yol açtı. ~/.config/opencode/opencode.jsonc dosyasını oluşturup aşağıdaki içeriği yapıştırın. Dosya ayrıca qwen3.5:4b'yi varsayılan model yapar.

    Dosya içeriği 
    {
  "$schema": "https://opencode.ai/config.json",
  "model": "ollama/qwen3.5:4b",
  "providers": {
    "ollama": {
      "models": {
        "qwen3.5:4b": { "body": { "reasoning_effort": "none" } }
      }
    }
  }
}

  5. Projenizde OpenCode'u açın

    Proje klasörünüze geçip OpenCode'u açın ve isteğinizi Türkçe yazın. Modelin listede göründüğünü opencode models ile de kontrol edebilirsiniz.

    Terminal 
    cd ~/projem
opencode
    Şunu görmelisiniz 
    > build · qwen3.5:4b
→ Read fiyat.py
← Edit fiyat.py

Linux · Resmî kurulum betiği

0 / 3 adım tamamlandı

Gerekenler: Resmî belgeye göre; editörlerimiz bu yolu test etmedi. Betik programı ~/.opencode/bin klasörüne indirir, Node.js gerektirmez ve klasörü kabuğunuzun ayar dosyasına (ör. ~/.bashrc) ekler.

  1. Betiği çalıştırın

    Resmî kurulum betiğini indirip çalıştırın.

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

  2. Terminali yeniden açın

    Betik PATH ayarını kabuk dosyanıza yazar; yeni bir terminal açıp sürümü kontrol edin.

    Terminal 
    opencode --version

  3. Yerel modeli ayarlayın

    Ollama'yı uzun bağlamla başlatma, model indirme ve düşünme modunu kapatma adımları npm yöntemindeki 2–4. adımlarla aynıdır.

    Terminal 
    OLLAMA_CONTEXT_LENGTH=32768 ollama serve
Reklam

İlk çalıştırma

OpenCode, açtığınız klasörü proje olarak görür. Terminalde proje klasörünüze geçip opencode yazın.

  • Alttaki kutuya isteğinizi Türkçe yazın, örneğin "Testler başarısız oluyor, hatayı bul ve düzelt". OpenCode dosyaları okuyup değişikliği fark olarak gösterir ve komut çalıştırmadan önce izin ister.
  • Model seçmek için kutuya /models yazın. Ollama çalışıyorsa indirdiğiniz modeller ollama/ önekiyle listede görünür; adında "Free" geçenler OpenCode'un ücretsiz bulut modelleridir.
  • Tab tuşu "build" ve "plan" ajanları arasında geçer. "plan" dosya değiştirmez ve komut çalıştırmadan önce sorar; yabancı bir projeyi incelerken bununla başlayın.
  • Tek seferlik işler için arayüzü açmadan da çalıştırabilirsiniz: opencode run "README dosyasını Türkçeye çevir".

Küçük yerel modeller yanlış aracı seçebilir ya da çalıştıramadığı testler için "başarılı" diyebilir. Değişikliği git diff ile gözden geçirip testleri kendiniz çalıştırın.

qwen3.5:4b, KDV hesabındaki hatayı doğru düzeltti; üstteki açıklamada ise olmayan bir "Prettier hatası" uydurdu.
qwen3.5:4b, KDV hesabındaki hatayı doğru düzeltti; üstteki açıklamada ise olmayan bir "Prettier hatası" uydurdu.
Testler geçti. Bu tekrarda model gereksiz bir __init__.py da oluşturdu; ekran kaydı işlemciyi paylaştığı için 11 dakika sürdü.
Testler geçti. Bu tekrarda model gereksiz bir __init__.py da oluşturdu; ekran kaydı işlemciyi paylaştığı için 11 dakika sürdü.
Model seçici (/models): Üstte ücretsiz bulut modelleri, altta Ollama'daki yerel modeller; DeepSeek bölümü bağlı bir API anahtarından geliyor.
Model seçici (/models): Üstte ücretsiz bulut modelleri, altta Ollama'daki yerel modeller; DeepSeek bölümü bağlı bir API anahtarından geliyor.

Sorun giderme 4

Ekranda gördüğünüz hata metnine tıklayın; nedeni ve çözümü açılır.

Neden: npm 12 paketlerin kurulum betiklerini varsayılan olarak engelliyor. OpenCode bu betikle işletim sisteminize uygun programı seçtiği için kurulum bitse de opencode komutu çalışmaz.

Çözüm: Kurulumu, OpenCode paketinin betiğine izin vererek yeniden yapın.

Terminal 
npm install -g --allow-scripts=@opencode/cli @opencode/cli@latest

Neden: Ollama, 24 GB'tan az ekran kartı belleğinde 4 bin belirteçlik bağlam açar. OpenCode'un talimatı yaklaşık 9.800 belirteç olduğu için kesilir. OpenCode hata göstermez; model dosyayı hiç açmadan alakasız kod uydurur. Bu satırı yalnız Ollama'nın kaydında görürsünüz.

Çözüm: Ollama'yı bağlamı büyüterek yeniden başlatın. Ollama'nın belgesi OpenCode için 64 bin öneriyor; 4 GB kartta 32 bin iki kat hızlıydı ve küçük projeye yetti. Ollama servis olarak kuruluysa değişkeni systemctl edit ollama.service ile ekleyin.

Terminal 
OLLAMA_CONTEXT_LENGTH=32768 ollama serve

Neden: Qwen 3.5 varsayılan olarak cevap vermeden önce "düşünür". Test görevinde 8 binden fazla belirteç düşündü; saniyede 9 belirteç hızla her istek 5 dakikalık sınıra takıldı ve OpenCode ekranında yalnız model adı kaldı.

Çözüm: OpenCode ayar dosyasında bu model için düşünmeyi kapatın (Kurulum › Linux › 4. adım). Dosyayı kaydettikten sonra OpenCode'u yeniden açın.

Dosya içeriği 
{
  "$schema": "https://opencode.ai/config.json",
  "model": "ollama/qwen3.5:4b",
  "providers": {
    "ollama": {
      "models": {
        "qwen3.5:4b": { "body": { "reasoning_effort": "none" } }
      }
    }
  }
}

Neden: Küçük model testleri terminal yerine kod çalıştırma aracıyla (execute) denedi; bu araç kabuk komutu anlamadığı için hata döndü. Bir denemede model bu hatayı görmezden gelip "testler başarıyla tamamlandı" dedi.

Çözüm: Modelin "başarılı" demesine güvenmeyin; testleri kendiniz çalıştırın. İsteğinize "testleri terminalde çalıştır" diye eklemek doğru aracı seçmesine yardım eder; daha büyük bir model bu hatayı yapmadı.

Terminal 
python3 -m unittest

Güncelleme ve kaldırma

Güncelleme

opencode upgrade komutu OpenCode'u son sürüme yükseltir. npm ile kurduysanız aynı kurulum komutunu yeniden çalıştırmanız da yeterlidir. Ayarlarınız ve oturum geçmişiniz korunur.

Kaldırma

opencode uninstall programı kaldırır, oturum verilerini ve ayarlarınızı bırakır. npm ile kurduysanız npm uninstall -g @opencode/cli da kullanabilirsiniz. Her şeyi silmek için ayar ve veri klasörlerini de silin: ~/.config/opencode ve ~/.local/share/opencode. Ollama'daki modeli ollama rm qwen3.5:4b ile kaldırırsınız.

Disk alanı

npm paketi 916 MB, oturum verileri birkaç on MB tutar. Yerel model ayrıca yer kaplar: qwen3.5:4b 3,3 GB.

Lisans ve ticari kullanım

Açık kaynak MIT Ticari kullanım serbest

OSI onaylı lisans: kodu kullanabilir, değiştirebilir ve dağıtabilirsiniz.

OpenCode'un kodu MIT lisanslıdır; şirket projelerinde de ücretsiz kullanabilir, değiştirebilir ve dağıtabilirsiniz. Kullandığınız modelin lisansı ve koşulları ayrıdır: Ollama'daki yerel modeller kendi lisanslarıyla gelir, ücretsiz bulut modellerinin bir kısmı ücretsiz dönemde gönderdiğiniz verileri modeli geliştirmek için kullanabilir. Şirket kodunu buluta göndermeden önce seçtiğiniz modelin gizlilik notunu okuyun.

Bu bölüm bilgilendirme amaçlıdır, hukuki görüş değildir. Ticari bir işte kullanmadan önce yazılımın ve indirilen modelin lisans metnini okuyun.

Alternatifler

Kurmakla uğraşmak istemiyorsanız

Aynı işi tarayıcıda yapan bulut araçları; kurulum gerektirmez ama çoğunda kullanım sınırı ya da ücretli paket vardır.

Bununla devam edin

OpenCode ile çalışan modeller

OpenCode hakkında sık sorulan sorular

OpenCode ücretsiz mi?

Programın kendisi ücretsiz ve açık kaynak. Maliyet seçtiğiniz modelden gelir: Ollama'daki yerel modeller ücretsizdir, OpenCode'un listesinde adında "Free" geçen bulut modelleri sınırlı süre ücretsiz sunuluyor, diğer bulut modelleri kullandıkça ücretlendirilir. Testimizde ücretsiz bulut modeli için hesap açmamız gerekmedi.

4 GB ekran kartı kod ajanı için yeter mi?

Basit işler için yeter ama yavaştır. qwen3.5:4b ile küçük bir hatayı bulup düzeltmek 2 dakika 8 saniye sürdü ve model bir denemede çalıştıramadığı testler için "başarılı" dedi. Çok dosyalı projelerde 4 milyar parametreli model kolayca yolunu kaybeder. Gizlilik şart değilse aynı işi ücretsiz bulut modeli 10 saniyede yaptı.

Ücretsiz bulut modellerinde kodum nereye gider?

Kodunuz OpenCode'un ABD ve AB'deki sunucuları üzerinden model sağlayıcısına gider. OpenCode'un belgesine göre DeepSeek V4.1 Flash Free gibi bazı modellerin sağlayıcısı veriyi saklamıyor ve eğitimde kullanmıyor; Big Pickle ve NVIDIA'nın ücretsiz modelleri gibi bazıları ise ücretsiz dönemde verileri modeli geliştirmek için kullanabilir. Şirket kodunda yerel modeli seçin ya da modelin gizlilik notunu okuyun.

OpenCode 1 ile 2 arasındaki fark nedir?

2. sürüm 2026 sonbaharında çıktı ve kurulum adresi, npm paketi (@opencode/cli) ve ayar dosyasının yapısı değişti. İnternetteki eski anlatımlar ve opencode-ai paketi 1. sürümü kurar; ayar örneklerinde "provider" yerine 2. sürümde "providers" kullanılır. Bu sayfadaki adımlar 2.1.4 ile test edildi.

Reklam