Roo Code 接入

在 VS Code 的 Roo Code 扩展里用 QCode.cc:选 Anthropic provider + 勾选自定义 base URL,即可用 Claude

更新于 2026-10-15

需要 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)

  1. 点开 Roo Code 侧边栏的设置(齿轮图标)
  2. API Provider 下拉选 Anthropic
  3. API Key 填你的 QCode 密钥(cr_ 开头)
  4. 勾选 Use custom base URL,填 https://api.qcode.cc/api
  5. 在模型下拉里选 claude-sonnet-5(或其它在售 id)
  6. 保存后在聊天框发一句话验证

中国大陆把域名换成 https://asia.qcode.cc/api(亚洲节点,韩国 / 台湾 / 香港就近),Key 不变。 base URL 末尾不要带斜杠——扩展会自己拼 /v1/messages,多一个斜杠会 404。

配置 GPT 与国产模型(OpenAI Compatible)

  1. API Provider 选 OpenAI Compatible
  2. Base URL 填 https://api.qcode.cc/openai/v1
  3. API Key 同一把 cr_ 密钥
  4. 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 这边没问题。接下来按顺序看:

  1. 先排除小问题:Key 前后带空格、Base URL 末尾带斜杠是最常见的两种,改完保存后再发一句话验证。
  2. Anthropic 与 OpenAI Compatible 两套设置混了:切换 provider 后,Base URL 和 Key 要重新确认。
  3. 想调的模型被拒:Claude 只能走 Anthropic provider,GPT 和国产模型只能走 OpenAI Compatible;对照 接入点与 API 格式 的真源表。
  4. 请求在 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 的填法一致,只是菜单文字略有差别。

相关文档

开始使用 QCode

一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models

企业团队版 →