OpenCode Kurulum Kılavuzu

Genel bakış

OpenCode sağlayıcıları bir JSON yapılandırmasından okur. Her UnoRouter modelini kullanmak için UnoRouter'i OpenAI uyumlu adaptörle ekleyin.

Hızlı yapılandırma

Bunları istemciye yapıştırın. Giriş yaptığınızda anahtarınız otomatik dolar.

Temel URL: https://api.unorouter.com/v1
API Anahtarı: YOUR_API_KEY

Uyumluluk

Adım adım kurulum

1. 1
   OpenCode yapılandırma dosyasını açın

   OpenCode yapılandırmanı bir metin düzenleyicide aç. Dosya yoksa oluştur.

   WindowsmacOSLinux

   powershell

   $f = "$env:USERPROFILE\.config\opencode\opencode.json"
   md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f

   API anahtarınızı otomatik doldurmak için giriş yapın

2. 2
   Dosya içeriğini değiştirin

   UnoRouter sağlayıcı bloğunu yapılandırmana ekle. Mevcut dosyayla birleştir ve sahip olduğun mcp veya agent bloklarını koru.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter-live": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         },
         "models": {
           "ling-3.1-flash:free": {},
           "agnes-3.0-flash:free": {},
           "minicpm5-2b:free": {},
           "k2-horizon:free": {},
           "qwen3.8-flash-next:free": {}
         }
       }
     }
   }

   API anahtarınızı otomatik doldurmak için giriş yapın

3. 3
   Modellerin yüklendiğini doğrula

   Dosyayı kaydet ve terminalde opencode models komutunu çalıştır. Listelediğin her kimlik, sağlayıcı anahtarın ön ekiyle görünmelidir.

   bash

   opencode models

   API anahtarınızı otomatik doldurmak için giriş yapın

4. 4
   Bir model seçin

   Model seçiciyi açın ve yeni modelinize geçin. Adaptör akış ve araç çağırma işlerini üstlenir.

Önerilen modeller

Burada çalışan ücretsiz modeller. Herhangi bir model id'sini istemciye yapıştırın.

Dikkat edilecekler

• !OpenCode, OpenAI uyumlu sağlayıcılar için canlı model keşfi sunmaz. İstediğin her model, tam kimliğiyle "models" bloğunda yer almalıdır.
• !Sağlayıcı anahtarına yalnızca "unorouter" adını verme. Bu kimlik models.dev kaydında zaten var ve OpenCode seninki yerine oradaki listeyi kullanır, böylece yeni modeller eksik kalır. Yukarıdaki "-live" soneki çakışmayı önler.
• !UnoRouter kataloğundaki tam model kimliklerini kullan. Kopyala yapıştır sırasında eklenen sağlayıcı ön ekini kaldır ve kimlikte varsa :free sonekini koru.
• !"models" bloğu olmayan özel bir sağlayıcı anahtarı sıfır model yükler, bu yüzden sağlayıcı seçiciden tamamen kaybolur.