Roo Code 已关停：把 Router One 配置迁到 Cline、Zoo Code 或 Kilo Code

迁到 Cline：官方推荐的继任者

Roo Code 的停服公告推荐 Cline，也就是 Roo Code 当初分支出来的项目，两者的供应商配置几乎一样。从 VS Code Marketplace 安装 Cline（它也支持 Cursor、Windsurf、VSCodium、Antigravity、JetBrains IDE，并提供 CLI），打开面板，点齿轮图标，在 API Provider 中选择 OpenAI Compatible。填入你在 Roo Code 里用过的三个值：Base URL https://api.router.one/v1、API Key 和模型 ID。保存 Key 后，Cline 会从网关的 /models 列表填充 Model ID 下拉框，Use custom model ID… 则可以手动填入精确的目录 ID。迁移后有两项设置要留意：和 Roo Code 一样，在你于 Model Configuration 里设置之前，Cline 对所有 OpenAI Compatible 模型都假定 128,000 tokens 的上下文窗口并开启图像支持。Cline 接入指南对这两项、CLI 以及 Plan/Act 分模型都有说明。

迁到 Zoo Code：导入 Roo Code 的设置

Zoo Code 是 Roo Code README 指向的社区分支，可以导入 Roo Code 的设置。在 Roo Code 中打开设置，点 Export 并保存文件；在 Zoo Code 中点 Import Settings，选择这个文件。Zoo Code 的迁移文档提醒：导出的文件可能包含敏感设置，其中就有 API Key，请妥善保管、不要分享，导入成功后删除。如果这个文件曾被复制到你无法掌控的地方，请新建一把 Router One Key，在 Zoo Code 中换上，再吊销旧 Key。Zoo Code 的 OpenAI Compatible provider 字段相同——Base URL、API Key、Model 和 Model Configuration——并且和 Roo Code 一样只支持原生工具调用，所以请选择 /models 详情页标明支持工具调用的模型 ID。本页按 Zoo Code 3.84.0（2026 年 9 月 26 日发布）核对，并按 3.86.0（2026 年 10 月 3 日发布）复核；Zoo Code 的稳定版在 GitHub 上发布。

迁到 Kilo Code：在自定义 provider 里填同样的值

Kilo Code 同样是从 Roo Code、Cline 一路发展而来的，费用走你配置的供应商。打开它的设置（齿轮图标）→ Providers，点 Custom provider，把 Provider API 设为 OpenAI Compatible，填入 https://api.router.one/v1 和你的 Key；之后 Kilo Code 会从网关拉取模型列表，也可以手动填入 /models 上的精确 ID。Kilo Code 还为每个 Agent 各保留一个默认模型（如 code、debug，以及相当于旧版 Architect 模式的 plan），Roo Code 里按模式配置的模型在这里有直接的对应。完整步骤见 Kilo Code 接入指南，Kilo 官方也发布了从 Roo Code 迁移的文章。

还在用 Roo Code 3.54.0？原有配置保留如下

最终版 3.54.0 仍可从 VS Code Marketplace 安装，但不会再有任何更新、修复或新模型支持，所以下面的内容只适合作为已有安装的参考，不建议新装。在 Roo Code 中打开设置（齿轮图标），在 API Provider 中选择 OpenAI Compatible。Base URL 填 https://api.router.one/v1，Key 填进 API Key 字段。Model 下拉框由带 Key 的 GET {Base URL}/models 填充，所以保存 Key 之后才会出现，并且会列出目录中的全部 ID，包括图像生成模型；请选择详情页标明支持工具调用的聊天模型。在 Model Configuration 中，Roo Code 对任何自定义模型都默认 128,000 tokens 的 Context Window Size，并开启 Image Support。请按模型详情页填写窗口，换算成整数并往小取（1.05M 填 1000000，200K 填 200000）；对 deepseek-v4-flash 这类只支持文本的 ID，取消勾选 Image Support：

Base URL

https://api.router.one/v1

# Roo Code 3.54.0 (final release) → Settings → API Provider: OpenAI Compatible
# The same three values work in Cline, Zoo Code and Kilo Code
Base URL:             https://api.router.one/v1
API Key:              sk-your-router-one-key
Model:                anthropic/claude-sonnet-5   (any chat ID from /models that lists tool calling)
# Model Configuration
Context Window Size:  1000000   (the model page's window as a whole number; default 128000)
Image Support:        off for text-only IDs such as deepseek-v4-flash

Roo Code 3.54.0 发给网关的请求

每一轮模型调用都是一次 POST /v1/chat/completions：stream 为 true 并请求流式 usage，附带 Roo Code 的原生工具定义并允许并行工具调用；没有设置自定义温度时，temperature 为 0。只有 Include max output tokens 保存为开启时，Roo Code 才会发送输出上限（max_completion_tokens）；无论哪种情况，花费上限都由 Key 的 maxSpend 控制。请求默认 600 秒超时（roo-cline.apiRequestTimeout 设置项）。Roo Code 只使用原生工具调用，没有 XML 格式工具的回退方案，因此模型必须接受工具定义。如果网关返回 HTTP 400，错误信息含 "has no chat candidate that supports requested capabilities: tool_calling"，请换成详情页标明支持工具调用的 ID；粘贴截图后出现 "…: vision"，说明给只支持文本的模型勾选了 Image Support。Roo Code 的 Anthropic provider 也不是替代方案：它会把不认识的模型 ID（例如 anthropic/claude-sonnet-5）替换成自己的默认模型。

不同的 Roo Code 用户适合哪个继任者

Roo Code 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Roo Code 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

Roo Code 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在请求日志里核对 Roo Code 的调用

先在 Roo Code 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，要么请求没到达网关（客户端配置或网络问题），要么网关在调用模型之前就拒绝了它——Key 问题的 401、余额不足或 Key 达到 maxSpend 上限的 402、Key 或账户自身限额触发的 429，或模型 ID、端点不对的 400 / 404；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

常见问题