OpenCode kurulumu ve OmniProxy yapılandırması

OpenCode; terminalde, IDE’de veya masaüstünde kod yazabilen açık kaynaklı bir kodlama asistanıdır. Kodunuzu ve bağlamınızı saklamadığı için gizliliğin önemli olduğu projelere uygundur. build projeyi değiştirmek için kullanılır. Varsayılan olarak salt okunur olan plan ise önce yabancı olduğunuz kodu anlamak ve yapılacak değişiklikleri planlamak için uygundur. Model hizmetini ihtiyaçlarınıza göre seçebilirsiniz.

Kurulum öncesi hazırlık

En kolay yöntem kurulum betiğini kullanmaktır. Komut çalıştırabileceğiniz ve proje dosyalarıyla işlem yapabileceğiniz modern bir terminal uygulamasına ihtiyacınız vardır. WezTerm, Alacritty, Ghostty veya Kitty bunlara örnektir. Windows’ta öncelikle WSL kullanın. WSL, Windows içinde Linux ortamı çalıştıran ve daha kapsamlı performans ile işlevsellik sunan bir araçtır.

En kolay

Kurulum betiği

• curl opencode.ai/install
• macOS Linux üzerinde doğrudan kullanın
• Windows için WSL önerilir

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Formülden daha sık güncellenir
• Arch için de paket var

Yerel Windows

Paket yöneticisi

• choco veya scoop
• Ya da npm ile genel kurulum
• Releases üzerinden de indirilebilir

Ayrıca geçerli model listesindeki model ID’sini hazırlayın. Model ID, hizmetin belirli bir modeli doğru biçimde tanımak için kullandığı addır.

Kurulum ve ilk çalıştırma

Kullanılabilecek en kolay kurulum komutu şudur:

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

Aşağıdaki kurulum yöntemlerini de kullanabilirsiniz:

• Node.js: npm install -g opencode-ai. Bun, pnpm ve Yarn için de karşılık gelen global kurulum komutları vardır; sayfanın sonundaki tanıtım sayfasına bakın.
• macOS ve Linux’ta Homebrew: brew install anomalyco/tap/opencode. Homebrew ekibinin bakımını yaptığı brew install opencode komutuna göre daha sık güncellendiği için bu tap’i kullanın.
• Arch Linux: Kararlı sürüm için sudo pacman -S opencode; daha yeni sürüm için AUR’daki opencode-bin kullanılabilir.
• Windows: choco install opencode, scoop install opencode veya npm install -g opencode-ai kullanabilirsiniz. Releases sayfasından ikili dosya da indirilebilir. Windows’ta Bun ile kurulum desteği hâlâ geliştirilmektedir.

Proje dizininize gidin ve OpenCode’u başlatın:

cd /path/to/project
opencode

İlk kullanımda /init komutunu çalıştırabilirsiniz. Bu komut projeyi analiz eder ve proje kök dizininde AGENTS.md dosyasını oluşturur. Projenin bu açıklamayı koruyabilmesi için dosyayı Git’e kaydedebilirsiniz.

OmniProxy’den bağlantı parametrelerini alma

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Geçerli OmniProxy model listesinden kopyalayın

baseURL hizmet adresi, API Key erişim kimlik bilgisi, Model ID ise modelin tam adıdır.

/v1/chat/completions kullanıldığında npm paketi olarak @ai-sdk/openai-compatible kullanın. Buradaki Chat Completions, sohbet istekleri için kullanılan bir arayüzdür. Yalnızca model /v1/responses kullanıyorsa @ai-sdk/openai paketine geçin. OmniProxy, Chat Completions uç noktası üzerinden kullanılıyorsa uyumluluk paketini değiştirmeyin.

Model ID’sinin tamamını geçerli OmniProxy listesinden kopyalayın ve içindeki eğik çizgileri koruyun. 2026-10-09 tarihindeki iki karşılaştırma ID’si claude-sonnet-5-5 ve gpt-6-luna idi. gpt-6-luna, Chat Completions özelliğini destekler. Chat Completions içinde işlev çağırma yalnızca reasoning_effort değeri none olduğunda desteklenir. Listede bulunmayan ID’leri kopyalamayın.

Araç yapılandırmasını girme

Provider, OpenCode’un model hizmetine bağlanırken kullandığı bir yapılandırma grubu olarak düşünülebilir. Provider belgelerinde, “/connect listesinde bulunmayan OpenAI uyumlu hizmetler” özel Provider olarak tanımlanır. OpenAI uyumlu hizmet, aynı istek biçimini kullanan ve aynı tür istemciler tarafından çağrılabilen bir hizmettir.

1. OpenCode içinde /connect komutunu çalıştırın ve Other seçeneğine kadar kaydırın.
2. Bir Provider ID girin. Aşağıda omniproxy kullanılmaktadır. Yapılandırma dosyasında da aynı ID kullanılacağı için kolay hatırlanabilir bir değer seçin.
3. OmniProxy API Key değerini girin. Bu adım yalnızca kimlik bilgisini kaydeder; adresi ve modeli ayrıca opencode.json dosyasına yazmanız gerekir. Kimlik bilgisi ~/.local/share/opencode/auth.json konumunda saklanır.
4. Proje dizininde opencode.json dosyasını oluşturun veya düzenleyin:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. /models komutunu çalıştırın. Özel Provider ve modeller listede görünecektir.

/connect içindeki ID, opencode.json dosyasındaki anahtarla aynı olmalıdır. Gerçek anahtarı bu dosyaya yazmayın. /connect kullanmıyorsanız options.apiKey içinde {env:değişken_adı} gibi bir ortam değişkeni gösterimi de kullanabilirsiniz. 2026-10-09 tarihinde OpenCode 1.18.34 ile anahtar doğrudan projenin options.apiKey alanına yazılıp /connect kullanılmadan da bağlantı kurulabildi. Ağ geçidi anahtarı doğrulamıyorsa bu alan yalnızca yerel makinede kullanılan bir yer tutucu karakter dizisi olabilir. models içindeki anahtarlar için listede bulunan tam ID’leri kullanın.

Anahtar

/connect

• En alttaki Diğer'i seçin
• Provider ID değerini kendiniz belirleyin
• auth.json içinde saklanır

Proje

opencode.json

• provider anahtarının adı aynı olmalı
• npm için uyumluluk paketini kullanın
• baseURL /v1 ile bitmeli

Seçim

/models

• Model listede görünmeli
• Soru sormadan önce birini seçin
• ID için ağ geçidi listesini esas alın

Gerçek bir görevle doğrulama

Önce proje dizininde gerçek bir görev çalıştırın. Model başvurusu Provider ID/model ID biçimindedir. Model ID içindeki eğik çizgileri koruyun:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Belirttiğim bir dosyanın ne yaptığını açıkla; dosyayı değiştirme."

--auto, bu çalıştırmanın dosya okuma gibi araçları kullanabilmesini sağlar. 2026-10-09 tarihinde OpenCode 1.18.34 ile belirtilen dosyanın içeriği okunabildi. İlk çalıştırma yaklaşık iki dakika sürdü.

Etkileşimli kullanım için opencode komutunu çalıştırın, ardından /models ile modeli seçin. Dosya aramak için @ kullanılabilir. /connect aracılığıyla kaydedilen kimlik bilgilerini doğrulamak için opencode auth list komutunu kullanabilir, ardından OmniProxy çağrı kayıtlarından kaynağı ve model ID’sini kontrol edebilirsiniz.

Başlatma

opencode açılabiliyor

• Önce proje dizinine cd ile geçin
• auth list içinde ID görünüyor
• Yapılandırma dosyası projenin içinde

Görev

Kodu okudu

• Belirli bir dosyayı sorun
• Açıklamasını inceleyin
• Yanlışsa /undo kullanın

Kayıtlar

Ağ geçidinde görünüyor

• Kaynak OpenCode
• Model ID eşleşiyor
• Anahtarı göndermeyin

Yaygın hatalar

• /models içinde OmniProxy görünmüyor: /connect içindeki ID ile opencode.json anahtarının aynı olup olmadığını, npm değerinin @ai-sdk/openai-compatible olarak ayarlanıp ayarlanmadığını ve baseURL değerinin /v1 ile bitip bitmediğini kontrol edin.
• Kimlik bilgisi kayboldu: opencode auth list komutunu çalıştırın. Bedrock gibi ortam değişkenlerine dayanan Provider’lar burada görünmez. Özel bir Provider için /connect kullanıldıysa burada görünmesi gerekir.
• Windows işlevleri eksik: WSL içindeki kurulum betiğini kullanın.
• Model ID geçersiz: ID’yi geçerli OmniProxy listesinden yeniden kopyalayın ve models içindeki anahtarı değiştirin.
• İstek yanlış arayüze gidiyor: Sohbet tamamlama için @ai-sdk/openai-compatible kullanmaya devam edin. OmniProxy üzerindeki model gerçekten /v1/responses kullanmıyorsa yalnızca Responses arayüzü için paketi değiştirmeyin.

Resmî referanslar

Kurulum için OpenCode tanıtımına bakın. Özel Provider yapılandırması için Providers sayfasına bakın. Örneklerde kullanılan model ID’leri için Claude model genel görünümüne ve GPT-6 Luna sayfasına bakın.

Tüm yer tutucuları kendi OmniProxy yapılandırmanızdaki değerlerle değiştirin. Gerçek bir anahtar asla paylaşmayın.

Kaydedilmiş bir sonuç veya yalnızca HTTP 200, tam Aracı uyumluluğunu kanıtlamaz. OmniProxy'nin çağrı kaydındaki kaynağı ve modeli kontrol edin.

Resmi kaynaklar · OpenCode ↗