Roo Code
- 官方主页：roocode.com
- 安装文档：docs.roocode.com/getting-started/installing
- 网关配置：Anthropic provider / OpenAI Compatible provider
- 协议类型：OpenAI 兼容（推荐，可直接填 TokenBay 的模型 ID）/ Anthropic Messages（走 Claude，支持 prompt caching）
安装
Roo Code 是 VS Code 扩展，需要 VS Code 1.84.0 或更高版本；VSCodium、Windsurf 等兼容编辑器可通过 Open VSX 安装。其余写法以官方安装文档为准。
VS Code Marketplace（推荐）
按 Ctrl/Cmd + Shift + X 打开扩展面板，搜索 Roo Code（发布者 RooVeterinaryInc）并安装，提示时重载窗口。也可直接按 Marketplace ID 安装：
code --install-extension RooVeterinaryInc.roo-clineOpen VSX（VSCodium / Windsurf 等）
在编辑器的扩展视图搜索 Roo Code 安装；或从 Open VSX Registry 页面安装。
手动安装 VSIX
从 GitHub Releases 下载最新 .vsix，在扩展视图的 … 菜单选择 Install from VSIX… 安装。
安装完成后，VS Code 左侧活动栏会出现 Roo Code 图标；在扩展面板中可查看当前已安装的版本号，遇到问题时建议先更新到最新版。
对接 TokenBay
对接机制
Roo Code 不通过环境变量配置网关，而是在扩展的设置面板里选择 provider 并填写端点与凭证。接 TokenBay 有两种 provider：
- OpenAI Compatible provider（推荐）：Model ID 是自由输入框，可直接填 TokenBay 的任意模型 ID（如
claude-sonnet-4.6、gpt-5.5）。它走标准的/chat/completions，Base URL 需带/v1。 - Anthropic provider：走 TokenBay 的原生 Anthropic 端点，支持 prompt caching 等特性。勾选 Use custom base URL 后，Roo Code 会在 Base URL 后自动追加
/v1/messages，因此 Custom Base URL 只填裸网关地址，不要带路径。
Base URL 不要带错路径：
- OpenAI Compatible provider 的 Base URL 填
https://api.tokenbay.com/v1（带/v1）。- Anthropic provider 的 Custom Base URL 填
https://api.tokenbay.com（裸地址，无/v1、无结尾斜杠）。
关于 Anthropic provider 的模型选择：Roo Code 的 Anthropic provider 用预设下拉框选 Claude 模型，下拉项是 Anthropic 官方命名，可能不含 TokenBay 的小数点版本号（如
claude-sonnet-4.6）。若下拉里找不到对应 TokenBay 模型 ID，请改用 OpenAI Compatible provider 手填 Model ID。（具体下拉是否支持自定义输入随版本变化，以你本地扩展实际界面为准。）
1. 获取 API Key
登录 TokenBay 控制台 → API 密钥 → 创建密钥。复制以 sk- 开头的完整字符串。明文仅显示一次，离开页面后无法再查看。
2. 配置 OpenAI Compatible Provider（推荐）
点击左侧 Roo Code 图标 → 设置图标（⚙️），在 provider 配置里按下表填写：
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.tokenbay.com/v1 |
| API Key | 你的 TokenBay API Key（sk-...） |
| Model | claude-sonnet-4.6（直接输入 TokenBay 模型 ID） |
保存后立即生效，无需重启。
3. 备选：配置 Anthropic Provider（用 prompt caching）
需要走原生 Anthropic 协议以使用 prompt caching 时，新增一个 provider 配置：
| 字段 | 值 |
|---|---|
| API Provider | Anthropic |
| Anthropic API Key | 你的 TokenBay API Key（sk-...） |
| Use custom base URL | 勾选 |
| Custom Base URL | https://api.tokenbay.com |
| Model | 在下拉中选 Claude 模型（受预设列表限制，见上文说明） |
4. 多套配置与 Mode 绑定
Roo Code 支持把多份 provider 设置保存为 API Configuration Profiles，并允许每个 Mode 单独绑定不同 Profile——例如 Architect 模式用 Opus、Code 模式用 Sonnet、Ask 模式用 Haiku，按任务复杂度自动升降档、节省成本。
进入 Modes 标签，为每个 Mode 选择对应的 Profile：
| Mode | 推荐 Profile / 模型 |
|---|---|
| Code | claude-sonnet-4.6 |
| Architect | claude-opus-4.8 |
| Ask | claude-haiku-4.5 |
| Debug | claude-sonnet-4.6 |
Mode 与 Profile 是两层概念：Profile 是一份 provider 配置集，Mode 决定「用哪份 Profile」。改了 Mode 绑定才会换模型。
5. 推荐模型
| 用途 | 模型 ID | Provider |
|---|---|---|
| 主力编码 | claude-sonnet-4.6 | OpenAI Compatible / Anthropic |
| 复杂重构 / 长上下文 | claude-opus-4.8 | OpenAI Compatible / Anthropic |
| 轻量 / 快速响应 | claude-haiku-4.5 | OpenAI Compatible / Anthropic |
| GPT 编码替代 | gpt-5.3-codex | OpenAI Compatible |
| GPT 通用旗舰 | gpt-5.5 | OpenAI Compatible |
模型 ID 直接透传上游，无前缀。完整可用列表见 模型清单。
模型名格式：TokenBay 的模型名称中版本号仅接受小数点形式（如
claude-sonnet-4.6、gpt-5.5），不要写成连字符形式（claude-sonnet-4-6、gpt-5-5）。上表为示例，准确的 Model ID 与端点以 控制台 Models 页面（或 模型清单）为准；接入前请核对，并确认 API Key 所属分组已授权该模型。
6. 进阶配置（长任务 / 代理）
- 请求超时：复杂推理或长上下文任务耗时较长，默认超时可能导致请求中断。Roo Code 设置面板里提供请求超时项（不同版本名称可能为 API Request Timeout 或位于高级设置中，以本地界面为准），可适当调大。
- 网络与代理：VS Code 版 Roo Code 复用 VS Code 自身的网络/代理设置。处于公司网络或防火墙后时，在 VS Code 设置中配置
http.proxy，并确保代理允许访问api.tokenbay.com。 - 自动批准上限：Roo Code 的工具调用默认有自动批准轮数上限，复杂任务可在设置面板调高，减少频繁人工确认。