Cline / Roo Code 串接教學
VS Code 裡的開源程式設計智慧體，選「OpenAI Compatible」填三項就能用
- 介面：OpenAI Chat Completions
- 網址寫法：寫到 /v1（https://gpt.cherrychat.org/v1）
- 推薦模型：claude-sonnet-5-5、gpt-6.1-sol
- 平台：VS Code
串接步驟
安裝擴充功能
在 VS Code 左側「擴充功能」裡搜尋「Cline」或「Roo Code」安裝。兩者是不同的擴充功能，設定各自獨立，用哪個就設哪個。
開啟設定
Cline：點左側欄的 Cline 圖示，再點面板右上角的齒輪 ⚙️。Roo Code：點左側欄的 Roo Code 圖示，再點齒輪進入設定中的服務商設定。
選擇 OpenAI Compatible 並填寫
「API Provider」選「OpenAI Compatible」，然後填寫下列三項。
- Base URL：https://gpt.cherrychat.org/v1（寫到 /v1，不要寫 /chat/completions）
- API Key：sk-你的金鑰
- Model ID：claude-sonnet-5-5
調整 Model Configuration
展開「Model Configuration」：Context Window 依「模型價格」頁的上下文長度填，Max Output Tokens 可填 8192；「Image Support」只給能看圖的模型開啟。「Use Azure Identity Authentication」（Cline）或 Azure 相關選項不要勾。Cline 設定裡有「Verify」按鈕的話點一下確認連通。
試一下
在對話框裡傳一句「列出目前資料夾裡的檔案」，看到它開始呼叫工具就代表接通了。
容易踩的坑
- Base URL 寫到 /v1（https://gpt.cherrychat.org/v1）；不要寫成 https://gpt.cherrychat.org/v1/chat/completions，也不要留著 https://api.openai.com/v1。
- Roo Code 只用原生工具呼叫，必須選支援工具呼叫的模型（Claude、GPT 系列都支援）。
- Model ID 必須和模型價格頁一致（全小寫），多一個空格都會出現模型不存在。
- 程式設計智慧體一次任務會發很多請求，token 用量大，建議先在「我的金鑰」替這把 key 設定額度上限。
錯誤訊息 → 原因 → 怎麼辦
| 看到的錯誤 | 原因 | 怎麼辦 |
|---|---|---|
| 提示 Invalid API Key / 401 | API Key 複製錯了、帶了空格，或這把 key 已停用 | 到 API 頁「我的金鑰」重新複製後貼上 |
| 出現 404 / Connection Error | Base URL 少了 /v1，或多寫了 /chat/completions | 改成 https://gpt.cherrychat.org/v1 |
| 提示 Model Not Found | Model ID 寫錯（大小寫、多空格） | 依模型價格頁逐字填寫，例如 claude-sonnet-5-5 |
| 能聊天但呼叫工具時報錯 | 選的模型不支援工具呼叫 | 換成 claude-sonnet-5-5 或 gpt-6.1-sol |
| 出現 402 或「餘額不足」（Claude 格式顯示 billing_error） | 帳戶點數不足以支付這次呼叫。API 呼叫只扣點數，會員卡與無限卡都不抵扣 | 到櫻桃茶·智域GPT 的「商店」儲值任意金額，幾秒後重試即可 |
| 出現 429 Too Many Requests | 請求太快：預設每把 key 每分鐘最多 120 次，每個帳號同時最多 8 個請求 | 調低工具裡的並行數或每秒請求數，依提示的 Retry-After 秒數稍等再試；多數工具會自動重試 |
教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別
