Cline 与 Roo Code
Cline 和 Roo Code 都是 VS Code 中的 AI 编程代理，均支持 OpenAI Compatible 提供商。配置方式基本一致。
安装
在 VS Code 扩展市场搜索并安装：
ClineRoo Code
只安装你实际使用的插件，避免多个代理同时占用侧边栏和快捷键。
配置步骤
- 打开插件设置。
- API Provider 选择 OpenAI Compatible。
- Base URL 填写
https://coffeecatbox.cc/v1。 - API Key 粘贴控制台令牌。
- Model ID 填写控制台中的准确模型 ID。
- 根据模型实际能力填写 Context Window 和 Max Output Tokens。
- 保存后发起一个只读问题验证。
推荐配置
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://coffeecatbox.cc/v1 |
| API Key | 猫咖啡 API 令牌 |
| Model ID | 控制台中的工具调用模型 |
| Image Support | 仅视觉模型开启 |
| Context Window | 按模型实际上下文填写 |
Roo Code 必须支持原生工具调用
Roo Code 仅使用 OpenAI 原生 tools/function calling，没有 XML 回退。模型不支持工具调用时，聊天可能正常，但读写文件和执行命令会失败。
首次使用建议
- 打开一个已使用 Git 管理的测试项目。
- 先让工具解释目录结构，不允许修改。
- 再让它修改一个小文件，并逐项审查权限请求。
- 确认结果正确后再处理真实项目。
常见问题
Verify 失败
先用最小 curl 请求验证令牌和模型。curl 成功时，检查 Base URL 是否多写了 /chat/completions。
模型能回复但不能编辑文件
选择支持 OpenAI 工具调用的模型，并在模型配置中启用工具/Computer Use 能力。不要为不支持的模型手工宣称能力。
上下文溢出
把 Context Window 改成模型真实值，减少自动包含的文件，并开启插件的上下文压缩功能。
费用较高
编程代理会反复携带代码、工具定义和历史消息。为插件单独创建限额令牌，并在控制台按令牌查看用量。