Skip to content

OpenCode

OpenCode 是一款開源的終端 AI 程式設計智慧體,支援 TUI / CLI 雙模式,相容 75+ 種 AI 供應商。內建 @ai-sdk/anthropic@ai-sdk/openai-compatible 介面卡,WRouter 的 Anthropic 與 OpenAI 端點都開箱即用。

前置要求

要求
OpenCode已安裝
WRouter一把可用 sk- Token

方式 A:互動式配置(推薦新手)

  1. 啟動 OpenCode TUI
  2. 輸入 /connect
  3. Other(自定義端點)
  4. 填寫:
    • Base URLhttps://wrouter.ai/v1
    • API Keysk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  5. 儲存後用 /models 切換模型

方式 B:配置檔案(推薦長期 / 多專案)

配置檔案位置(專案級優先順序更高):

  • 全域性:~/.config/opencode/opencode.json
  • 專案級:專案根目錄 opencode.json
json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "wrouter-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "wrouter (Anthropic)",
      "options": {
        "baseURL": "https://wrouter.ai/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "limit": { "context": 200000, "output": 8192 }
        },
        "haiku": {
          "id": "claude-haiku-4-5",
          "name": "Claude Haiku 4.5 (fast)",
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    },
    "wrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "wrouter",
      "options": {
        "baseURL": "https://wrouter.ai/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5",
          "limit": { "context": 128000, "output": 32768 }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": { "context": 1000000, "output": 32768 }
        }
      }
    }
  }
}

雙 Provider 技巧:為 Claude 模型宣告 Anthropic 介面卡(支援 thinking + cache_control 等專屬特性),其餘模型走 OpenAI 相容介面卡。

驗證

bash
opencode
# TUI 中:
/models  # 選 WRouter 模型

傳送測試 prompt。

已知限制

  • OpenAI 相容介面卡不會傳遞 Anthropic 專屬欄位。Claude 高階特性請走 wrouter-anthropic provider。
  • OpenCode 自帶的 75+ 直連 provider 多數指向上游官方端點;要走 WRouter 必須按上面方式手動宣告。