工具整合
OpenCode
OpenCode 是開源的終端機程式設計 Agent,可以在同一個設定裡串接多個模型並隨時切換。透過 OpenAI 相容協定串接 FlyRouter,Claude、GPT 等模型都能使用。
安裝
按 OpenCode 官網 的說明安裝,安裝後在終端機執行 opencode 啟動。
設定 FlyRouter
設定 API Key
終端機
export FLYROUTER_API_KEY="sk-..."新增供應商
編輯全域設定 ~/.config/opencode/opencode.json(也可以放在專案根目錄的 opencode.json,專案設定優先):
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "flyrouter/claude-sonnet-5-5",
"provider": {
"flyrouter": {
"npm": "@ai-sdk/openai-compatible",
"name": "FlyRouter",
"options": {
"baseURL": "https://api.flyrouter.ai/v1",
"apiKey": "{env:FLYROUTER_API_KEY}"
},
"models": {
"claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
"claude-opus-5-5": { "name": "Claude Opus 5.5" },
"gpt-6.1-sol": { "name": "GPT-6.1 Sol" }
}
}
}
}models 裡的鍵是模型 ID,按需增減;name 是介面上顯示的名字。
選擇模型
啟動 opencode,輸入 /models 就能看到 FlyRouter 下的模型。頂部 model 欄位決定預設模型,格式為 供應商/模型ID。
用指令設定 Key
不想在設定檔裡引用環境變數,也可以在 OpenCode 裡執行 /connect,選擇 Other,供應商 ID 填 flyrouter,再貼上 Key。Key 會儲存在 OpenCode 的本機憑證裡,設定檔中的 apiKey 那一行就可以刪掉。
常見問題
- 模型列表為空:檢查
opencode.json是否是合法 JSON(不能有多餘的逗號)。 - 401:
FLYROUTER_API_KEY沒有生效,或{env:...}裡的變數名稱寫錯。變數不存在時會被當作空字串。 - 404:
baseURL需要帶/v1。