Ana içeriğe atla

OpenCode Nasıl Kurulur ve Kullanılır: Kapsamlı Rehber

BloglarOpenCodeAITerminalCLIYaklaşık 8 dakika

OpenCode Nasıl Kurulur ve Kullanılır: Kapsamlı Rehber

OpenCode, yapay zekanın gücünü doğrudan terminalinize getiren açık kaynaklı bir AI kodlama ajanıdır. Düzenleyicilerde veya tarayıcılarda çalışan geleneksel AI kodlama araçlarının aksine, OpenCode terminal tabanlı bir arayüz, masaüstü uygulaması ve IDE uzantısı sunar — hepsi sizi bir geliştirici olarak daha üretken kılmak için tasarlanmıştır. Bu kapsamlı rehber, OpenCode’u etkili biçimde kurup yapılandırmak ve kullanmak için bilmeniz gereken her şeyi adım adım anlatacaktır.

OpenCode Nedir?

OpenCode, size yardımcı olan AI destekli bir kodlama asistanıdır:

  • Akıllı kod oluşturma ve tamamlama ile kodu daha hızlı yazmak
  • Hataları analiz ederek verimli şekilde hata ayıklamak
  • Doğal dil sorguları ile kod tabanlarını anlamak
  • Otomatik planlama ve uygulama ile özellikler eklemek
  • AI destekli analiz ve önerilerle kodu gözden geçirmek
  • AI ajanları ve özel araçlarla iş akışlarını otomatikleştirmek

Anthropic, OpenAI, Google ve diğerleri dahil olmak üzere birden fazla LLM sağlayıcısını destekler, böylece ihtiyaçlarınıza en uygun modelleri seçme esnekliği sağlar.

Sistem Gereksinimleri

Ön Koşullar

OpenCode’u kurmadan önce aşağıdakilerin kurulu olduğundan emin olun:

  1. Modern Terminal Emülatörü (TUI kullanımı için):

  2. Node.js (npm/bun/pnpm/yarn kurulumu için):

    • Node.js v18 veya üzeri önerilir

  3. LLM sağlayıcıları için API Anahtarları:

    • Anthropic API anahtarı (Claude modelleri için)
    • OpenAI API anahtarı (GPT modelleri için)
    • Ya da desteklenen diğer sağlayıcıların anahtarları

Kurulum Yöntemleri

Yöntem 1: Kurulum Scripti (Önerilen)

OpenCode’u en hızlı şekilde kurmanın yolu resmi kurulum scriptini kullanmaktır:

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

Bu yöntem macOS, Linux ve Windows’ta (Git Bash veya WSL ile) çalışır.

Yöntem 2: Node.js Paket Yöneticileri

npm ile:

npm install -g opencode-ai

Bun ile:

bun install -g opencode-ai

pnpm ile:

pnpm install -g opencode-ai

Yarn ile:

yarn global add opencode-ai

Yöntem 3: Homebrew ile (macOS & Linux)

brew install opencode

Yöntem 4: Paru ile (Arch Linux)

paru -S opencode-bin

Yöntem 5: Windows’a Özel Kurulumlar

Chocolatey kullanarak:

choco install opencode

Scoop kullanarak:

scoop bucket add extras
scoop install extras/opencode

Mise kullanarak:

mise use -g github:sst/opencode

Yöntem 6: Docker

Konteyner tabanlı kullanım için:

docker run -it --rm ghcr.io/sst/opencode

Yöntem 7: İkili Dosya İndir

Önceden derlenmiş ikili dosyayı doğrudan GitHub Releases sayfasından indirebilirsiniz.

Kurulumu Doğrulama

Kurulumdan sonra çalıştığını doğrulayın:

opencode --version

Sürüm numarasını görmelisiniz.

İlk Yapılandırma

OpenCode Zen’e Bağlanma (Yeni Başlayanlar için Önerilir)

OpenCode Zen, OpenCode ekibi tarafından test edilip doğrulanmış modellerin özel bir listesidir. Başlamanın en kolay yoludur.

  1. OpenCode’u başlatın:
cd /path/to/your/project
opencode
  1. TUI’de connect komutunu çalıştırın:
/connect

  1. Sağlayıcı listesinden "opencode" seçin

  2. Yetkilendirme URL’sini ziyaret edin: opencode.ai/auth

  3. Giriş yapın ve faturalandırma bilgilerini ekleyin (veya varsa ücretsiz kredileri kullanın)

  4. API anahtarınızı kopyalayıp terminalde istenildiğinde yapıştırın

Diğer Sağlayıcılara Bağlanma

OpenCode’u başka LLM sağlayıcılarına da bağlayabilirsiniz:

/connect komutu ile:

/connect

Tercih ettiğiniz sağlayıcıyı seçin (Anthropic, OpenAI, Google vb.) ve yetkilendirme adımlarını izleyin.

CLI ile kimlik doğrulama:

opencode auth login

Bu komut, Models.dev üzerinde bulunan herhangi bir sağlayıcı için API anahtarı yapılandırmanıza rehberlik eder.

Yapılandırılmış Sağlayıcıları Listeleme:

opencode auth list

veya kısa versiyon:

opencode auth ls

Sağlayıcıdan Çıkış Yapma:

opencode auth logout

Proje Bağlamını Kurma

Bir sağlayıcı yapılandırdıktan sonra, OpenCode’u projeniz için başlatın:

  1. Proje dizinine gidin:
cd /path/to/your/project
  1. OpenCode’u başlatın:
opencode
  1. init komutunu çalıştırın:
/init

Bu, proje yapınızı analiz eder ve proje kökünde AGENTS.md dosyası oluşturur. Bu dosya, OpenCode’un kodlama alışkanlıklarınızı, kullandığınız framework’leri ve proje mimarinizi anlamasına yardımcı olur.

İpucu: AGENTS.md dosyasını Git’e ekleyin. Bu, takım genelinde tutarlılık sağlar ve zamanla OpenCode’un projenizi daha iyi kavramasına destek olur.

Terminal Kullanıcı Arayüzü (TUI) Kullanımı

OpenCode’un TUI’si terminalinizde etkileşimli bir deneyim sunar.

TUI’yi Başlatma

Sadece çalıştırın:

opencode

Alternatif olarak, opsiyonel bayraklarla:

# Son oturumu devam ettir
opencode --continue

# Belirli bir oturumu devam ettir
opencode --session <session-id>

# Prompt ile başlat
opencode --prompt "Explain this codebase"

# Belirli modeli kullan
opencode --model anthropic/claude-sonnet-4-5

# Belirli ajanı kullan
opencode --agent plan

Temel TUI Navigasyonu

  • Kaydırma: Fare tekerleği veya yön tuşları
  • Mod değiştirme: Plan ve Build modu arasında geçiş için Tab
  • Komut çalıştırma: Komut paletini açmak için / yazın
  • Dosya arama: Projedeki dosyaları bulanık arama için @
  • Çıkış: Ctrl+C veya /exit

Soru Sorma

Kod tabanınız hakkında OpenCode’a soru sorabilirsiniz:

How is authentication handled in @packages/functions/src/api/index.ts

@ işaretiyle belirli dosyaları referans gösterin. OpenCode bu dosyaları analiz ederek detaylı açıklamalar sağlar.

Özellik Ekleme

OpenCode, iki modlu iş akışıyla yeni özellikler ekleme konusunda mükemmeldir:

1. Adım: Plan Modu

  1. Tab ile Plan moduna geçin
  2. Yapmak istediğinizi açıklayın:
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
  1. Önerilen planı gözden geçirin
  2. Geri bildirimle tekrar edin:
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.

İpucu: Görselleri terminale sürükle bırak yapabilirsiniz. OpenCode bunları tarar ve analiz eder.

2. Adım: Build Modu

  1. Tekrar Tab ile Build moduna geçin
  2. Uygulamayı onaylayın:
Sounds good! Go ahead and make the changes.

OpenCode, gerekli dosyaları oluşturup değiştirerek özelliği uygular.

Doğrudan Değişiklik Yapma

Basit değişiklikler için plan aşamasını atlayabilirsiniz:

We need to add authentication to the /settings route.
Take a look at how this is handled in the /notes route
in @packages/functions/src/notes.ts and implement the same logic
in @packages/functions/src/settings.ts

Geri Alma ve Yeniden Yapma

Hata yaptınız mı? Geri almak için:

/undo

Bu, son değişiklikleri geri alır ve prompt’unuzu yeniden düzenlemenize izin verir.

Tekrar yapmak için:

/redo

Birden fazla değişikliği geri almak için /undo’yu tekrar tekrar çalıştırabilirsiniz.

CLI Komutları

OpenCode, programatik erişim ve otomasyon için güçlü bir CLI sağlar.

Doğrudan Prompt Çalıştırma

OpenCode’u etkileşim olmadan çalıştırın:

opencode run "Explain how closures work in JavaScript"

Script yazımı, otomasyon veya TUI açmadan hızlı cevaplar için kullanılır.

Modelleri Yönetme

Tüm mevcut modelleri listele:

opencode models

Sağlayıcıya göre filtreleme:

opencode models anthropic

Model önbelleğini yenile (yeni modeller eklendiğinde faydalı):

opencode models --refresh

Maliyet bilgilerini içeren detaylı model bilgisi göster:

opencode models --verbose

Headless Sunucu Başlatma

API erişimi için HTTP sunucu başlat:

opencode serve

Özel port ile:

opencode serve --port 3000

Bu, web uygulamalarına entegrasyon veya scriptlerde MCP sunucusunun soğuk açılışını atlamak için hızlı yanıt sağlar.

Sunucuya Bağlanma

Bir terminalde sunucuyu başlatın:

opencode serve

Başka bir terminalde ona bağlanarak hızlı çalıştırın:

opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Ajanları Yönetme

Yeni özel ajan oluştur:

opencode agent create

Bu, özel sistem promptları ve araç yapılandırmalarıyla ajan oluşturmanıza rehberlik eder.

GitHub Entegrasyonu

Depo otomasyonu için GitHub ajanını kurun:

opencode github install

Otomatik kod inceleme ve issue yönetimi için GitHub Actions iş akışlarını ayarlar.

OpenCode’u Güncelleme

En son sürüme yükselt:

opencode upgrade

Belirli sürüme yükselt:

opencode upgrade v0.1.48

Kurulum yöntemi belirtin:

opencode upgrade --method brew

Yapılandırma

OpenCode, JSON ayar dosyalarıyla esnek yapılandırma destekler.

Yapılandırma Konumları

Ayar dosyaları birleştirilir (yer değiştirmez), böylece global, proje bazlı ve özel yapılandırmalar olabilir.

  1. Global Ayar: ~/.config/opencode/opencode.json

    • Tema, sağlayıcılar, kısayollar ve genel ayarlar için

  2. Proje Ayarı: Proje kökünde opencode.json

    • Projeye özel sağlayıcılar, ajanlar veya ayarlar için
    • Git’e eklenebilir

  3. Özel Konfigürasyon Yolu: OPENCODE_CONFIG ortam değişkeni ile belirlenir

  4. Özel Konfigürasyon Dizini: OPENCODE_CONFIG_DIR ortam değişkeni ile belirlenir

Temel Yapılandırma Örneği

Böyle bir dosya oluşturun:

{
  "$schema": "https://opencode.ai/config.json",
  
  // Tema seçimi
  "theme": "opencode",
  
  // Ana model
  "model": "anthropic/claude-sonnet-4-5",
  
  // Hafif görevler için küçük model
  "small_model": "anthropic/claude-haiku-4-5",
  
  // Otomatik güncelleme ayarları
  "autoupdate": true
}

Sağlayıcıları Yapılandırma

API anahtarlarını doğrudan configte ayarlayabilirsiniz:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    },
    "openai": {
      "options": {
        "apiKey": "{env:OPENAI_API_KEY}"
      }
    }
  }
}

Güvenlik için ortam değişkenleri ({env:VARIABLE_NAME}) kullanılması önerilir.

Dosya Referansları Kullanma

Hassas veriler için dosya yolu referansı da kullanabilirsiniz:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "apiKey": "{file:~/.secrets/openai-key}"
      }
    }
  }
}

Özel Komutlar

Tekrarlayan işler için özel komutlar tanımlayın:

{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    "test": {
      "template": "Run full test suite with coverage report and show any failures.\nFocus on failing tests and suggest fixes.",
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "anthropic/claude-haiku-4-5"
    },
    "component": {
      "template": "Create a new React component named $ARGUMENTS with TypeScript support.\nInclude proper typing and basic structure.",
      "description": "Create a new component"
    }
  }
}

TUI’de /test veya /component MyComponent yazarak kullanabilirsiniz.

Özel Ajanlar

Uzmanlaşmış ajanlar oluşturun:

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "model": "anthropic/claude-sonnet-4-5",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

İzinlerin Yapılandırılması

OpenCode’un sorup sormadan yapabileceklerini kontrol edin:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

Bu, düzenleme ve bash işlemleri öncesi kullanıcı onayı gerektirir.

Kod Formatlayıcılar

Kodun otomatik formatlanması için formatlayıcıları ayarlayın:

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {
    "prettier": {
      "disabled": false
    },
    "custom-prettier": {
      "command": ["npx", "prettier", "--write", "$FILE"],
      "environment": {
        "NODE_ENV": "development"
      },
      "extensions": [".js", ".ts", ".jsx", ".tsx"]
    }
  }
}

TUI Ayarları

Terminal arayüzünü özelleştirin:

{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

Gelişmiş Özellikler

Sohbetleri Paylaşma

Konuşmalarınızı takımınızla paylaşın:

/share

Bu, paylaşılabilir bir link oluşturur ve panoya kopyalar. Varsayılan olarak sohbetler paylaşılmaz.

Paylaşma davranışını yapılandırma:

{
  "share": "manual"  // "manual", "auto", veya "disabled"
}

MCP Sunucuları

Model Context Protocol (MCP) sunucuları OpenCode’un yeteneklerini genişletir:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    }
  }
}

Talimatlar ve Kurallar

Proje özel talimatlar sağlayın:

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": [
    "CONTRIBUTING.md",
    "docs/guidelines.md",
    ".cursor/rules/*.md"
  ]
}

OpenCode bu dosyaları proje kodlama standartları ve sözleşmeleri için kullanır.

Ortam Değişkenleri

OpenCode’u ortam değişkenleriyle yapılandırın:

# Oturumları otomatik paylaş
export OPENCODE_AUTO_SHARE=true

# Özel konfigürasyon dosyası yolu
export OPENCODE_CONFIG=/path/to/config.json

# Konfigürasyon dizini yolu
export OPENCODE_CONFIG_DIR=/path/to/config-dir

# Otomatik güncellemeyi devre dışı bırak
export OPENCODE_DISABLE_AUTOUPDATE=true

# Varsayılan eklentileri devre dışı bırak
export OPENCODE_DISABLE_DEFAULT_PLUGINS=true

# Deneysel modelleri etkinleştir
export OPENCODE_ENABLE_EXPERIMENTAL_MODELS=true

# Exa web aramasını etkinleştir
export OPENCODE_ENABLE_EXA=true

Deneysel Özellikler

Deneysel özellikleri etkinleştirin:

export OPENCODE_EXPERIMENTAL=true

Belirli deneysel özellikler:

# Icon keşfini etkinleştir
export OPENCODE_EXPERIMENTAL_ICON_DISCOVERY=true

# TUI’de seçimle kopyalamayı devre dışı bırak
export OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT=true

# Bash komutları için maksimum çıktı uzunluğu ayarla
export OPENCODE_EXPERIMENTAL_BASH_MAX_OUTPUT_LENGTH=10000

# Bash komutları için varsayılan zaman aşımı (ms)
export OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=30000

En İyi Uygulamalar

Etkili Prompt Kullanımı

  1. Özgül olun: Net ve detaylı talimatlar verin
  2. Bağlam kullanın: Anlamayı artırmak için dosyaları @ ile belirtin
  3. Örnek verin: İstediğiniz şeyi örneklerle gösterin
  4. Parçalara ayırın: Karmaşık işleri adımlara bölün

Büyük Projelerle Çalışma

  1. /init kullanın: OpenCode’un proje yapısını anlamasını sağlayın
  2. Belirli dosyalar referansı: Bağlamı sınırlamak için @ kullanın
  3. Plan modunu kullanın: Uygulamaya geçmeden planları gözden geçirin
  4. Kademeli değişiklikler: Küçük ve yönetilebilir değişiklikler yapın

Maliyet Optimizasyonu

  1. Küçük modeller kullanın: Hafif işler için small_model yapılandırın
  2. Planlayıp sonra inşa edin: Tekrarlamaları azaltmak için Plan modunda inceleyin
  3. Özel komutlar: Yaygın görevler için verimli iş akışları oluşturun
  4. Kullanımı izleyin: Sağlayıcı panellerinden kullanım istatistiklerini kontrol edin

Güvenlik En İyi Uygulamaları

  1. API anahtarlarını asla commits içine koymayın: Ortam değişkenleri kullanın
  2. İzinleri yapılandırın: Hassas işlemler için permission onayı zorunlu kılın
  3. Değişiklikleri gözden geçirin: OpenCode’un önerilerini hep kontrol edin
  4. Ayrı anahtarlar kullanın: OpenCode için uygun sınır ve izinlere sahip özel anahtarlar oluşturun

Sorun Giderme

Kurulum Sorunları

Sorun: Kurulum sonrası komut bulunamıyor

Çözüm:

  • Kurulumu doğrulayın: which opencode
  • PATH değişkenini kontrol edin: echo $PATH
  • Tam yolu deneyin: ~/.local/bin/opencode
  • Alternatif kurulum yöntemi deneyin

Kimlik Doğrulama Sorunları

Sorun: API anahtarı tanınmıyor

Çözüm:

  • Anahtarın doğru olduğundan emin olun: opencode auth list
  • Ortam değişkenlerini kontrol edin: echo $ANTHROPIC_API_KEY
  • Tekrar kimlik doğrulaması yapın: opencode auth login

Performans Sorunları

Sorun: Yanıt süreleri yavaş

Çözüm:

  • Daha hızlı çalıştırmak için opencode serve kullanın
  • Daha hızlı model seçin
  • Daha küçük bağlam pencereleri kullanın
  • Kullanılmayan araçları konfigürasyonda devre dışı bırakın

TUI Sorunları

Sorun: Terminal görüntüleme sorunları

Çözüm:

  • Modern terminal emülatörü kullanın (WezTerm, Alacritty vb.)
  • Terminalin 24-bit renk desteğini kontrol edin
  • Farklı tema deneyin
  • Kaydırma hızlanmasını sorun varsa devre dışı bırakın

Model Sorunları

Sorun: Model bulunamıyor

Çözüm:

  • Model listesi yenileyin: opencode models --refresh
  • Sağlayıcının yapılandırıldığını kontrol edin: opencode auth list
  • Model adının düzgün formatta olduğundan emin olun: provider/model
  • Sağlayıcının modeli hizmette sunduğunu doğrulayın

OpenCode’u İş Akışınıza Entegre Etme

Günlük Geliştirme

  1. Sabah: Kod değişiklikleriyle senkronize olmak için /init çalıştırın
  2. Özellik geliştirme: Plan moduyla tasarlayıp, Build moduyla uygulayın
  3. Hata ayıklama: Dosya referanslarıyla hatalar hakkında soru sorun
  4. Kod inceleme: Özel kod inceleme ajanı kullanın
  5. Dokümantasyon: Özel komutlarla dokümanlar üretin

Takım İşbirliği

  1. Ayarları paylaşın: opencode.json ve AGENTS.md dosyalarını Git’e ekleyin
  2. Konuşmaları paylaşın: Uygulamaları tartışmak için /share komutunu kullanın
  3. Özel komutlar: Takım spesifik komutları proje ayarlarında tanımlayın
  4. Tutarlı ajanlar: Tutarlılık için paylaşılan ajan tanımları kullanın

CI/CD Entegrasyonu

  1. GitHub ajanı: Otomatik PR incelemeleri için kurun
  2. Testler: CI'de özel test komutlarını kullanın
  3. Kod kalitesi: Formatlayıcılar ve izinleri yapılandırın

Sonuç

OpenCode, güçlü AI yeteneklerini doğrudan terminalinize getirerek AI destekli geliştirmede yeni bir paradigma sunar. Esnek yapılandırma seçenekleri, birçok LLM sağlayıcısı desteği ve sezgisel TUI arayüzü sayesinde, var olan iş akışınızı bozmadan üretkenliğinizi artırmak için tasarlanmıştır.

Ana Noktalar:

  • Kurulum scripti veya favori paket yöneticinizle kurun
  • API anahtarlarını /connect veya opencode auth login ile yapılandırın
  • Projeleri daha iyi bağlam için /init ile başlatın
  • Karmaşık özellikler için Plan, direkt değişiklikler için Build modunu kullanın
  • Konfigürasyon dosyaları, komutlar ve ajanlarla özelleştirin
  • Otomasyon ve scriptler için CLI komutlarından faydalanın
  • Güvenlik için API anahtarları ve izinler konusunda dikkatli olun

Sonraki Adımlar:

Geliştirme iş akışınızı hızlandırmaya hazır mısınız?
AI optimizasyonlu LightNode hosting çözümlerine göz atın — AI destekli uygulamalarınızı özel GPU instance’lar ve ölçeklenebilir altyapı ile dağıtmak için.

OpenCode açık kaynaklıdır ve sürekli gelişmektedir. Projeye katkıda bulunun, sorunları raporlayın veya deneyiminizi paylaşarak herkes için daha iyi hale gelmesini sağlayın. İyi kodlamalar!

Ucuz VPS Hosting ile Büyük Tasarruf