Panduan Pengaturan OpenCode

Ikhtisar

OpenCode membaca penyedia dari konfigurasi JSON. Tambahkan UnoRouter dengan adapter kompatibel OpenAI untuk memakai model UnoRouter apa pun.

Konfigurasi cepat

Tempel nilai ini ke klien. Kunci Anda terisi otomatis saat Anda masuk.

URL dasar: https://api.unorouter.com/v1
Kunci API: YOUR_API_KEY

Kompatibilitas

Penyiapan langkah demi langkah

1. 1
   Buka file konfigurasi OpenCode

   Buka konfigurasi OpenCode Anda di editor teks. Buat berkasnya jika belum ada.

   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

   Masuk untuk mengisi otomatis kunci API Anda

2. 2
   Ganti isi file

   Tambahkan blok penyedia UnoRouter ke konfigurasi Anda. Gabungkan ke berkas yang sudah ada dan pertahankan blok mcp atau agent yang Anda miliki.

   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": {}
         }
       }
     }
   }

   Masuk untuk mengisi otomatis kunci API Anda

3. 3
   Verifikasi model termuat

   Simpan berkas lalu jalankan opencode models di terminal. Setiap id yang Anda daftarkan harus muncul dengan awalan kunci penyedia Anda.

   bash

   opencode models

   Masuk untuk mengisi otomatis kunci API Anda

4. 4
   Pilih model

   Buka pemilih model lalu beralih ke model baru Anda. Adapter menangani streaming dan pemanggilan alat.

Model yang direkomendasikan

Model gratis yang berfungsi di sini. Tempel id model apa pun ke klien.

Hal yang perlu diperhatikan

• !OpenCode tidak memiliki penemuan model langsung untuk penyedia yang kompatibel dengan OpenAI. Setiap model yang Anda inginkan harus dicantumkan di blok "models" dengan id persis.
• !Jangan menamai kunci penyedia hanya "unorouter". Id itu sudah ada di registri models.dev, dan OpenCode akan memakai daftar mereka alih-alih daftar Anda sehingga model terbaru hilang. Akhiran "-live" di atas menghindari benturan itu.
• !Gunakan id model yang persis dari katalog UnoRouter. Hapus awalan penyedia yang ikut tersalin, dan pertahankan akhiran :free bila id memilikinya.
• !Kunci penyedia khusus tanpa blok "models" memuat nol model, sehingga penyedia hilang sepenuhnya dari pemilih.