# Roo Code 集成

> Roo Code(已停止维护)的 OpenAI Compatible / Anthropic 提供商指向本平台

来源：https://qd.zsopc.com/docs/integrations/roo-code

> **Roo Code 已停止维护**:官方于 2026-05-15 关停扩展并把 [GitHub 仓库](https://github.com/RooCodeInc/Roo-Code) 设为只读,最后一个版本是 3.54.0。官方 README 推荐迁移到 [Cline](./cline.md)(Roo Code 的上游项目)或社区分支 ZooCode。下面的步骤按 3.54.0 与官方文档核对,供仍在用这个版本的用户参考。

## 准备 API Key

在 [qd.zsopc.com/dashboard/keys](https://qd.zsopc.com/dashboard/keys) 创建 API Key(`sk-gpushare-` + 64 位十六进制,创建后可在 Key 详情页随时重新查看)。建议给 Roo Code 单独建一把,方便在 [用量页](https://qd.zsopc.com/dashboard/usage) 按 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)改成该模型的实际窗口,数值见 [模型列表](../reference/models.md)

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_key` | Key 是否复制完整(共 76 字符);可在 [Key 详情页](https://qd.zsopc.com/dashboard/keys) 重新查看 |
| 400 `model_not_found` | 模型 ID 拼写,须与 [模型列表](../reference/models.md) 一致 |
| 402 `quota_exceeded` | 余额不足,到 [充值页](https://qd.zsopc.com/dashboard/billing) 充值 |

错误码完整说明见 [错误码](../reference/errors.md)。

## 其他客户端

- [Cline](./cline.md) — 官方推荐的替代,同样是 VS Code 编程插件
- [Continue.dev](./continue.md) — VS Code / JetBrains
- [Codex CLI](./codex-cli.md) — 命令行编程助手
