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,推荐)#

  1. 打开 Roo Code 的设置面板(齿轮图标)
  2. API Provider 选 OpenAI Compatible
  3. 填:
    • Base URL: https://qd.zsopc.com/v1
    • API Key: 你的 sk-gpushare-...
    • Model: 从下拉列表里选(它请求 GET /v1/models),或直接输入模型 ID,如 claude-sonnet-4-6
  4. 在模型配置里把 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 原生协议,可选)#

  1. API Provider 选 Anthropic
  2. Anthropic API Key 填你的 Key
  3. 勾选 Use custom base URL,填 https://qd.zsopc.com(不带 /v1)
  4. 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_keyKey 是否复制完整(共 76 字符);可在 Key 详情页 重新查看
400 model_not_found模型 ID 拼写,须与 模型列表 一致
402 quota_exceeded余额不足,到 充值页 充值

错误码完整说明见 错误码。

其他客户端#

  • Cline — 官方推荐的替代,同样是 VS Code 编程插件
  • Continue.dev — VS Code / JetBrains
  • Codex CLI — 命令行编程助手