OpenCode 設定指南

概覽

OpenCode 從 JSON 設定檔讀取其提供者。使用相容 OpenAI 的轉接器將 UnoRouter 加入為自訂提供者，即可選擇任意 UnoRouter 模型作為目前模型。

快速設定

將這些值填入用戶端。登入後會自動填入你的金鑰。

基礎 URL: https://api.unorouter.com/v1
API 金鑰: YOUR_API_KEY

相容性

逐步設定

1. 1
   開啟 OpenCode 設定檔

   在 OpenCode 中按 Ctrl + O 並貼上路徑。在 Windows 上，將 YOUR_USER 換成你的 Windows 使用者名稱。

   text

   C:/Users/YOUR_USER/.config/opencode/opencode.json

   登入以自動填入 API 金鑰

2. 2
   取代檔案內容

   清空檔案並貼上 UnoRouter 提供者設定區塊。填入你的 UnoRouter API 金鑰，並從目錄中選擇任意模型。

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "discoverModels": true,
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         }
       }
     }
   }

   登入以自動填入 API 金鑰

3. 3
   儲存並重新載入

   按 Ctrl + S 儲存，然後按 Ctrl + Shift + P 執行 Developer: Reload Window。重新載入後 OpenCode 會辨識新的提供者。

4. 4
   選擇模型

   在 OpenCode 中開啟模型選擇器並切換到你加入的模型。相容 OpenAI 的轉接器會自動處理串流與工具呼叫。

推薦模型

在這裡表現良好的免費模型。把任意模型 ID 貼到用戶端即可。

注意事項

• !設定 "discoverModels": true 後，OpenCode 啟動時會自動從 /v1/models 拉取完整的 UnoRouter 目錄，因此無需手動列出，每個模型（包括新模型）都會出現在選擇器中。
• !如果 Developer: Reload Window 未顯示你的提供者，請再次檢查 JSON 在儲存時是否沒有多餘的尾端逗號。
• !請使用 UnoRouter 目錄中的精確模型 ID。如果複製貼上時加上了前導提供者前綴，請將其移除。
• !在沒有自動發現的舊版 OpenCode 上，新增 "models" 區塊並列出所需的準確 id（例如 {"gemini-3.1-flash-lite": {}}），然後重新啟動。