Roo Code 集成
Roo Code(已停止维护)的 OpenAI Compatible / Anthropic 提供商指向本平台
Roo Code 已停止维护:官方于 2026-05-15 关停扩展并把 GitHub 仓库 设为只读,最后一个版本是 3.54.0。官方 README 推荐迁移到 Cline(Roo Code 的上游项目)或社区分支 ZooCode。下面的步骤按 3.54.0 与官方文档核对,供仍在用这个版本的用户参考。
准备 API Key#
在 qd.zsopc.com/dashboard/keys 创建 API Key(sk-gpushare- + 64 位十六进制,创建后可在 Key 详情页随时重新查看)。建议给 Roo Code 单独建一把,方便在 用量页 按 Key 查看花费。
配置(OpenAI Compatible,推荐)#
- 打开 Roo Code 的设置面板(齿轮图标)
- API Provider 选 OpenAI Compatible
- 填:
- Base URL:
https://qd.zsopc.com/v1 - API Key: 你的
sk-gpushare-... - Model: 从下拉列表里选(它请求
GET /v1/models),或直接输入模型 ID,如claude-sonnet-4-6
- Base URL:
- 在模型配置里把 Context Window Size(默认 128000)改成该模型的实际窗口,数值见 模型列表
Roo Code 只能用支持原生工具调用的模型;本平台的文本模型都支持,下拉列表里的图像、视频模型不要选。
| 用途 | 推荐模型 |
|---|---|
| 复杂重构 / 多文件编辑 | claude-opus-4-8、gpt-6.1-sol |
| 日常编码 | claude-sonnet-4-6、gpt-6-luna |
| 省钱 | deepseek-v4.1-flash、glm-5.3 |
配置(Anthropic 原生协议,可选)#
- API Provider 选 Anthropic
- Anthropic API Key 填你的 Key
- 勾选 Use custom base URL,填
https://qd.zsopc.com(不带/v1) - Model 选 Claude 模型
下面那个 Pass Anthropic API Key as Authorization header instead of X-Api-Key 勾不勾都行,本平台两种鉴权头都接受。
注意事项#
- Roo Code 的一次任务会多次调用模型,费用累积得快。所有 Key 共享同一账户余额,单建一把 Key 不能给花费封顶。
- 不同用途可以建多个配置档(设置里的 Providers 页,配置档选择框旁的 +),每个配置档各填一套地址与模型。
常见问题#
| 现象 | 排查 |
|---|---|
| 模型下拉列表为空 | Base URL 是否为 https://qd.zsopc.com/v1;Key 是否正确(列表请求失败时不提示错误) |
401 invalid_api_key | Key 是否复制完整(共 76 字符);可在 Key 详情页 重新查看 |
400 model_not_found | 模型 ID 拼写,须与 模型列表 一致 |
402 quota_exceeded | 余额不足,到 充值页 充值 |
错误码完整说明见 错误码。
其他客户端#
- Cline — 官方推荐的替代,同样是 VS Code 编程插件
- Continue.dev — VS Code / JetBrains
- Codex CLI — 命令行编程助手