# Roo Code 接入

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

> **最后核实**：2026-09-18 · 📄 依据官方文档（仓库归档状态经 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 仓库](https://github.com/RooCodeInc/Roo-Code) |

[Roo Code](https://github.com/RooCodeInc/Roo-Code) 是 VS Code 的开源 AI 编程扩展，fork 自 [Cline](/docs/ide/cline)；[Kilo Code](/docs/ide/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 格式](/docs/getting-started/endpoints-and-api-paths)。

## 安装

在 VS Code 扩展市场搜索 **Roo Code** 安装，或从 [项目仓库](https://github.com/RooCodeInc/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](/docs/usage/cn-models) 如 `glm-5.2`

## 验证连通

先用 curl 确认端点与密钥没问题，再回扩展里排查界面配置：

```bash
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」输入框手填 |

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — 协议 × 模型家族真源表
- [Kilo Code 接入](/docs/ide/kilo-code) — 下游 fork，配置几乎相同
- [Cline 集成](/docs/ide/cline) — 上游项目
- [国产模型接入](/docs/usage/cn-models)