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 換成你的使用者名稱。

   text

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

   登入以自動填入 API 金鑰

2. 2
   取代檔案內容

   清空檔案並貼上 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。

4. 4
   選擇模型

   開啟模型選擇器並切換到新模型。轉接器會處理串流與工具呼叫。

推薦模型

在這裡可用的免費模型。把任意模型 id 貼進用戶端即可。

注意事項

• !設定 "discoverModels": true 後，OpenCode 啟動時會從 /v1/models 抓取 UnoRouter 的完整目錄，因此不必逐一列出，所有模型都會出現在選擇器中。
• !如果執行 Developer: Reload Window 之後仍看不到你的供應商，請檢查儲存的 JSON 是否有多餘的結尾逗號。
• !請使用 UnoRouter 目錄中的精確模型 id。複製貼上時帶上的供應商前綴請刪掉。
• !沒有自動探索時，較舊的 OpenCode 需要一個列出精確 id 的 "models" 設定區塊（例如 {"gemini-3.1-flash-lite": {}}）並重新啟動。