OpenCode 串接教學

開源的終端機程式設計助手，在 opencode.json 裡加一個自訂服務商即可

• 介面：OpenAI Chat Completions
• 網址寫法：寫到 /v1（https://gpt.cherrychat.org/v1）
• 推薦模型：claude-sonnet-5-5、gpt-6.1-sol
• 平台：macOS、Windows、Linux

串接步驟

1. 安裝 OpenCode（裝過可略過）

   macOS / Linux 用官方腳本或 npm 安裝；Windows 官方建議在 WSL 中使用，也可以直接用 npm 安裝。裝好後執行 opencode --version 能看到版本號。

   macOS / Linux

   curl -fsSL https://opencode.ai/install | bash

   Windows

   npm install -g opencode-ai

2. 把 key 存進環境變數

   設定檔裡用 {env:CHERRYCHAT_API_KEY} 引用 key，key 本身放在環境變數裡。設好後要關掉終端機重新開啟。

   • CHERRYCHAT_API_KEY（API Key）：sk-你的金鑰

   macOS / Linux（寫入 ~/.zshrc）

   echo 'export CHERRYCHAT_API_KEY="sk-你的金鑰"' >> ~/.zshrc
   source ~/.zshrc

   Windows（設好後重開 PowerShell）

   setx CHERRYCHAT_API_KEY "sk-你的金鑰"

3. 寫 opencode.json

   全域設定放在 ~/.config/opencode/opencode.json（用下方指令開啟）；原生 Windows 可以把 opencode.json 放在專案根目錄，只對這個專案生效。貼上下方內容並儲存。想加更多模型，照 models 裡的格式再加一行。

   • options.baseURL（API 網址）：https://gpt.cherrychat.org/v1（寫到 /v1 為止）
   • 模型名稱：claude-sonnet-5-5

   開啟檔案（macOS）

   mkdir -p ~/.config/opencode && touch ~/.config/opencode/opencode.json && open -e ~/.config/opencode/opencode.json

   opencode.json 內容

   {
     "$schema": "https://opencode.ai/config.json",
     "model": "cherrychat/claude-sonnet-5-5",
     "provider": {
       "cherrychat": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "CherryChat",
         "options": {
           "baseURL": "https://gpt.cherrychat.org/v1",
           "apiKey": "{env:CHERRYCHAT_API_KEY}"
         },
         "models": {
           "claude-sonnet-5-5": { "name": "claude-sonnet-5-5" }
         }
       }
     }
   }

4. 啟動並驗證

   開新的終端機，進入專案資料夾執行下方指令，能看到回覆就成功了。互動使用時執行 opencode，輸入 /models 可以看到並切換 CherryChat 底下的模型。

   opencode run "用一句話介紹你自己"

容易踩的坑

• baseURL 寫到 /v1（https://gpt.cherrychat.org/v1）；npm 用 @ai-sdk/openai-compatible，它走 Chat 介面。
• 頂層 "model" 的寫法是「provider 名稱/模型名稱」，即 cherrychat/claude-sonnet-5-5；這個模型名稱還必須出現在 models 清單裡。
• {env:…} 是 OpenCode 自己的寫法（單層大括號）。也可以在 OpenCode 裡執行 /connect → 選「Other」→ 填 cherrychat → 貼上 key，這樣 options 裡就不用寫 apiKey。
• OpenCode 2 仍然認得這種寫法；同一個 provider 裡不要混用 2 代的 providers / package / settings 欄位。
• 專案根目錄的 opencode.json 優先於全域設定；兩處都寫了時以專案裡的為準。

錯誤訊息 → 原因 → 怎麼辦

教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。

API 串接 · API 模型價格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別