Roo Code 接入

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

⚠️ 项目已归档：GitHub 仓库 RooCodeInc/Roo-Code 自 2026-05-15 起归档（只读），官方不再提供更新与修复。下方配置方式对已有安装仍然可用、可作参考；需要活跃维护的同类工具，建议迁移到 Kilo Code 或 Cline。

最后核实：2026-09-18 · 📄 依据官方文档（仓库归档状态经 GitHub API 核实；Roo Code 不再发版）

接入速览¶

Roo Code 是 VS Code 的开源 AI 编程扩展，fork 自 Cline；Kilo Code 又 fork 自它——三者的设置界面高度相似，本页的做法在它们之间基本通用。

走哪条腿¶

🔴 不要用 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 说明端点侧没问题；此时若扩展仍失败，问题在界面配置。

常见问题¶

相关文档¶

• 接入点与 API 格式 — 协议 × 模型家族真源表
• Kilo Code 接入 — 下游 fork，配置几乎相同
• Cline 集成 — 上游项目
• 国产模型接入