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 生成，请仔细甄别
