Roo Code 接入
在 VS Code 的 Roo Code 扩展里用 QCode.cc:选 Anthropic provider + 勾选自定义 base URL,即可用 Claude
需要 API Key? 前往注册 →端点与 Base URL →
本页目录
⚠️ 项目已归档:GitHub 仓库 RooCodeInc/Roo-Code 自 2026-05-15 起归档(只读),官方不再提供更新与修复。下方配置方式对已有安装仍然可用、可作参考;需要活跃维护的同类工具,建议迁移到 Kilo Code 或 Cline。
最后核实:2026-10-15 · 📄 依据官方文档(仓库归档状态经 GitHub API 核实;Roo Code 不再发版)
接入速览¶
| 项目 | 说明 |
|---|---|
| 可用模型 | Claude ✅(Anthropic provider + 自定义 base URL)· GPT ✅ · 国产 ✅(OpenAI Compatible)· Gemini ❌ |
| 协议与 Base URL | Anthropic:https://api.qcode.cc/api · OpenAI:https://api.qcode.cc/openai/v1 |
| 配置位置 | VS Code 扩展设置面板(API Provider / Base URL 勾选框) |
| 官方文档 | Roo Code 仓库 |
Roo Code 是 VS Code 的开源 AI 编程扩展,fork 自 Cline;Kilo Code 又 fork 自它——三者的设置界面高度相似,本页的做法在它们之间基本通用。
走哪个协议¶
| 你想用的模型 | API Provider | Base URL |
|---|---|---|
| Claude | Anthropic |
https://api.qcode.cc/api |
| GPT 系 / 国产四家族 | OpenAI Compatible |
https://api.qcode.cc/openai/v1 |
🔴 不要用 OpenAI Compatible 去调 Claude——QCode 的 OpenAI 端点不接受 Claude 模型,会返回
model_not_available_on_endpoint。详见 接入点与 API 格式。
安装¶
在 VS Code 扩展市场搜索 Roo Code 安装,或从 项目仓库 按指引安装。
配置 Claude(Anthropic provider)¶
- 点开 Roo Code 侧边栏的设置(齿轮图标)
- API Provider 下拉选 Anthropic
- API Key 填你的 QCode 密钥(
cr_开头) - 勾选 Use custom base URL,填
https://api.qcode.cc/api - 在模型下拉里选
claude-sonnet-5(或其它在售 id) - 保存后在聊天框发一句话验证
中国大陆把域名换成
https://asia.qcode.cc/api(亚洲节点,韩国 / 台湾 / 香港就近),Key 不变。 base URL 末尾不要带斜杠——扩展会自己拼/v1/messages,多一个斜杠会 404。
配置 GPT 与国产模型(OpenAI Compatible)¶
- API Provider 选 OpenAI Compatible
- Base URL 填
https://api.qcode.cc/openai/v1 - API Key 同一把
cr_密钥 - Model ID 填
gpt-6-sol、gpt-5.6-terra,或 国产 id 如glm-5.2
验证连通¶
先用 curl 确认端点与密钥没问题,再回扩展里排查界面配置:
KEY="cr_你的QCode密钥"
curl -X POST https://api.qcode.cc/api/v1/messages \
-H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
返回含 content 的 JSON 说明端点侧没问题;此时若扩展仍失败,问题在界面配置。
常见报错速查¶
| 现象 | 原因 | 处理 |
|---|---|---|
model_not_available_on_endpoint |
用 OpenAI Compatible 调 Claude | 改用 Anthropic provider + /api |
Invalid API key |
密钥错或带空格 | 确认 cr_ 开头、无前后空格 |
| 404 | base URL 末尾带了斜杠或路径写错 | 对照上文表格 |
| 模型下拉里没有想要的 id | 扩展的内置清单未收录 | 用「自定义模型 id」输入框手填 |
配置项说明¶
| 设置项(Roo Code 界面) | 填什么 | 说明 |
|---|---|---|
| API Provider | Anthropic(Claude)或 OpenAI Compatible(GPT、国产) |
决定走哪种协议,选错会直接被拒 |
| API Key | cr_ 开头的 QCode 密钥 |
同一把 Key 两种 provider 通用 |
| Use custom base URL | 勾选后填 https://api.qcode.cc/api |
仅 Anthropic provider 需要;大陆可换 asia.qcode.cc |
| Base URL(OpenAI Compatible) | https://api.qcode.cc/openai/v1 |
末尾不带斜杠 |
| Model / Model ID | 如 claude-sonnet-5、gpt-6-sol、glm-5.2 |
内置下拉里没有时用自定义输入框手填 |
排查补充¶
先区分问题出在「端点侧」还是「界面配置」:用上面「验证连通」一节的 curl 能返回内容,就说明 QCode 这边没问题。接下来按顺序看:
- 先排除小问题:Key 前后带空格、Base URL 末尾带斜杠是最常见的两种,改完保存后再发一句话验证。
- Anthropic 与 OpenAI Compatible 两套设置混了:切换 provider 后,Base URL 和 Key 要重新确认。
- 想调的模型被拒:Claude 只能走 Anthropic provider,GPT 和国产模型只能走 OpenAI Compatible;对照 接入点与 API 格式 的真源表。
- 请求在 QCode 一侧查不到:到 probe.qcode.cc 输入 Key,看请求是否到达;没有记录就是请求没发出来,回头查扩展里的 Base URL。
常见问题¶
Roo Code 已经归档,还能继续用吗?¶
可以用,但不会再有更新和修复。截至 2026-10-15,GitHub API 显示 RooCodeInc/Roo-Code 仓库为归档(只读)状态,最后一次推送是 2026-05-15。已有安装按本页配置仍可连接 QCode;需要持续维护的工具,建议迁移到 Kilo Code 或 Cline,配置方式几乎一致。
在 Roo Code 里能用 GPT 吗?¶
能。API Provider 选 OpenAI Compatible,Base URL 填 https://api.qcode.cc/openai/v1,Model ID 填 gpt-6-sol 或 gpt-5.6-terra。
为什么 Claude 不能选 OpenAI Compatible?¶
QCode 的 OpenAI 端点不接受 Claude 模型,会返回 model_not_available_on_endpoint,这个检查发生在鉴权之前,所以它说明的是协议选错,而不是密钥有问题。Claude 请用 Anthropic provider。
在中国大陆用哪个域名?¶
推荐 asia.qcode.cc(Anthropic 方式填 https://asia.qcode.cc/api),不稳时换回 api.qcode.cc。三个域名使用同一把 Key。
Roo Code 和 Cline、Kilo Code 的配置有什么区别?¶
界面高度相似:Roo Code 派生自 Cline,Kilo Code 又派生自 Roo Code。协议、Base URL 和 Key 的填法一致,只是菜单文字略有差别。
相关文档¶
- 接入点与 API 格式 — 协议 × 模型家族真源表
- Kilo Code 接入 — 下游 fork,配置几乎相同
- Cline 集成 — Roo Code 所源自的项目
- 国产模型接入
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models