Roo Code 接入

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

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-5.5、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」输入框手填