Roo Code 是一个用于 VS Code 的开源自主编码代理——Cline 家族的一个分支,以其模式系统和按模式进行的模型路由为特色。它不自带模型,因此需要 API 密钥。本指南详细介绍如何使用一个 sk-kn- 密钥运行Roo Code 中的 Claude,主流模型的价格比 Anthropic 标价低约 30%;如何使用配置档案,只在值得的地方为强模型付费;一次会话的成本;以及与直接调用 Anthropic 相比的实际取舍。
Roo Code 为什么需要 API 密钥
Roo Code 执行的每一步——读取文件、写入差异、运行命令、读取结果——都是按 token 计费的模型调用。claude.ai Pro 或 Max 订阅不包含这些调用:聊天方案和 API 访问是独立产品,而 Roo Code 会与 API 通信。由于代理循环会在每一步重新发送不断增长的任务上下文,每 token 费率是会话成本中最大的调节因素——这也是使用网关的意义:从 $10 充值开始按量付费,一个密钥即可访问 GPT,余额永不过期。
配置——三个字段
打开 Settings → Providers,将 API provider 设置为 OpenAI Compatible。需要填写三个值:
API Provider OpenAI Compatible
Base URL https://api.kunavo.com/v1
API Key sk-kn-... # create at kunavo.com/app/keys
Model ID claude-sonnet-5 # or claude-opus-5 / claude-haiku-4-5在控制台完成注册并充值后创建密钥——密钥只显示一次,因此请立即保存;Claude API 密钥文档介绍密钥轮换和消费限额。如果 Roo Code 要求填写上下文窗口或输出上限等模型元数据,请从模型页面获取这些值——上下文窗口设置过小会让它比必要时更早截断。
在允许它编辑代码前,先用一个小任务进行测试。这里出现 401 几乎总是密钥问题;出现 404 几乎总是基础 URL 或不存在的模型 slug 问题——Kunavo 严格匹配 slug,不会为带日期后缀的名称创建别名,因此 claude-sonnet-4-5-20250929 会返回 404,而 claude-sonnet-4-6 可以正常解析。
模式与配置档案——成本调节手段
Roo Code 内置了多个模式——Code、Architect、Ask 和 Debug——此外还支持自定义模式。与成本相关的关键点是,Roo Code 会保存命名的 API 配置档案,并记住你在每种模式中最后使用的档案。因此,模型成为模式的属性,而不是你需要记住手动更改的设置:
# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.
Profile "strong" model claude-opus-5 -> bind to Architect and Debug
Profile "code-default" model claude-sonnet-5 -> bind to Code mode
Profile "ask-cheap" model claude-haiku-4-5 -> bind to Ask mode这种方式有效,是因为不同模式的 token 特征差异很大。Architect 是少量注重推理的回合,模型质量决定接下来的二十步是否高效——它只占总 token 的一小部分,因此强模型的绝对成本很低。Code 包含大量机械步骤,每一步都会重新发送上下文,这正是每 token 费率产生累积影响的地方。Ask 通常是一次性请求,根本不需要前沿模型。
下面是具体计算:在 Opus 5 上执行三步 Architect,再在 Sonnet 5 上执行十七步 Code,总成本约为 $1.06;全部使用 Sonnet 的运行成本为 $0.87——只需多花约 23%,就能获得明显更好的规划能力,而且远低于全部使用 Opus 的成本。
原生 Anthropic 路由(以及你可能需要它的原因)
Roo Code 还提供一个原生的 Anthropic provider,并带有自定义基础 URL 字段。将其指向 https://api.kunavo.com——只填写origin,不要添加 /v1,因为该客户端会自行追加 /v1/messages——即可通过原生 Messages API 路由。将 /v1 形式的 URL 粘贴到这里,会产生一个看起来像模型缺失的 404。
该路由带来的优势是提示词缓存:cache_control 会原样传递,缓存输入按输入费率的 10% 计费(工作原理)。对于每一步都会重新发送稳定前缀的循环,这是可获得的最大单项节省,甚至超过更换模型带来的节省。两种路由都可以使用;OpenAI Compatible 更容易开始,二者之间的切换只需修改设置。
不过,提示词缓存本身并不需要原生路由。对于较长的提示词,Kunavo 会在 OpenAI Compatible 路由上自行设置缓存断点:设在系统提示词、工具定义,以及对话中已有助手回合时的最后一条消息上;在代理循环中,这就是第一步之后的每一步。Roo Code 在该路由上设置的 cache_control 会被保留。在原生路由上,请求按 Roo Code 发送的原样转发,不会添加任何断点,因此缓存哪些内容取决于 Roo Code 设置的断点。
如何为不同模式绑定 Claude 模型
| 模式 | 模型 | Kunavo 输入 / 输出(每 100 万 Token) |
|---|---|---|
| Code(默认,使用量最高) | claude-sonnet-5 | $1.40 / $7.00 |
| Architect 和 Debug——规划、设计、困难的 bug | claude-opus-5 | $3.50 / $17.50 |
| Ask——一次性问题 | claude-haiku-4-5 | $0.70 / $3.50 |
所有这些模式使用的都是同一个密钥和同一个端点——只有模型 slug 不同,因此切换档案只需修改一个词。与 Anthropic 官方标价对比的完整模型费率见 Anthropic Claude API 价格表,实时目录见定价页面。
Kunavo 上的 Roo Code 与直接调用 Anthropic 的对比
以下是诚实的比较,也包括直接调用更合适的情况:
| Roo Code → Kunavo | Roo Code → Anthropic 直连 | |
|---|---|---|
| Sonnet 5 每 1M(输入 / 输出) | $1.40 / $7.00 | $2.00 / $10.00 |
| 开始使用 | 注册、充值 $10、创建密钥 | 已配置计费的 Anthropic Console 账户 |
| 一个密钥可使用的模型 | Claude 和 GPT,以及图像、视频和音频模型 | 仅 Claude |
| 按模式进行模型路由 | 可以——档案是 Roo Code 的功能,不受 provider 影响 | 是 |
| 提示缓存 | 可以,通过原生 Anthropic provider 路由(cache_control 会透传) | 可以,原生支持 |
| 失败的请求 | 不计费 | 不计费 |
| 容量与 SLA | 共享上游容量,没有合同 SLA 或保证配额 | 你所在组织自己的速率限制等级,以及 Anthropic 的支持条款 |
| 当天即可使用全新模型 | 上游渠道提供这些模型时 | 发布时 |
容量这一行才是真正的权衡,直截了当地说:如果你需要保证配额、合同 SLA 或与模型供应商建立采购关系,就应当直接调用——价格差异买到的正是这些保障。对于使用 Roo Code 的个人开发者或小团队来说,通常情况正好相反。
Roo Code 会话的实际成本
代理式工具的设计本身就很耗 Token:每一步都会重新发送系统提示、任务历史和新文件上下文。按 Kunavo 费率计算的现实数字如下:
| 单位 | token(输入 / 输出) | claude-sonnet-5 | 按 Anthropic 列表价 |
|---|---|---|---|
| 一次 Code 模式步骤 | 25,000 / 1,200 | $0.043 | $0.062 |
| 一个 20 步任务 | 约 500k / 约 24k | ~$0.87 | ~$1.24 |
| 同一任务,在 Opus 5 上使用 Architect | 约 500k / 约 24k | ~$1.06 | ~$1.52 |
| 高强度的一天(5 个此类任务) | — | ~$4.34 | ~$6.20 |
可运行的计算如下:
# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
"claude-haiku-4-5": (0.70, 3.50),
"claude-sonnet-5": (1.40, 7.00),
"claude-opus-5": (3.50, 17.50),
}
def step_cost(model, in_tokens, out_tokens):
i, o = RATES[model]
return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o
# One Code-mode step: Roo resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200)) # -> $0.0434
# A realistic 20-step task on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200)) # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
+ 17 * step_cost("claude-sonnet-5", 25_000, 1_200)) # -> ~$1.06控制账单
- 开始新任务,而不是无限延长一个任务。 Roo Code 会在每一步重新发送整个对话,因此一个长期运行的任务会使成本呈二次增长。新任务拥有全新且较小的上下文,这是这里收益最大的习惯。
- 为每种模式绑定一个档案。 上文已经介绍:它将模型路由变成配置,而不是你在任务中途必须记住的事情。
- 使用原生 Anthropic 路由进行缓存。 对于每一步都会重新发送稳定前缀的循环,按输入费率 10% 计费的缓存输入是最大的结构性节省。
- 为编辑器使用一个单独的限额密钥。 在控制台创建一个单独的密钥,并在实际使用一周后检查用量——这才是诚实估算成本的唯一方式。
常见问题
Roo Code 配合 Claude API 时应使用什么基础 URL?
在 Roo Code 中,前往 Settings → Providers,将 API Provider 设置为 'OpenAI Compatible',将 Base URL 设置为 https://api.kunavo.com/v1,粘贴 Kunavo 密钥(sk-kn-...),并将模型 ID 设置为类似 claude-sonnet-5 的 Claude slug。如果改用 Roo Code 原生的 'Anthropic' provider,则只需将基础 URL 设置为 origin——https://api.kunavo.com——因为该客户端会自行追加 /v1/messages。在此处添加 /v1 是此配置出现 404 的最常见原因。对于最困难的任务,将模型 ID 设置为 claude-opus-5。
可以在 Roo Code 中使用 Claude Pro 或 Max 订阅吗?
不可以。截至 2026 年 9 月,Roo Code 的提供商文档没有列出 Claude 订阅选项——其 Anthropic 提供商接受来自 Anthropic Console 的 API 密钥——而 claude.ai 聊天订阅不包含 API 访问权限。Roo Code 会直接调用 API,因此每次文件读取、差异比较和命令执行都是一次计费的模型调用,你需要一个按量付费的 API 密钥。在 Kunavo 上,最低充值金额为 $10,大多数 Claude 模型的价格比 Anthropic 的标价低 30%,余额永不过期。
Roo Code 可以为不同模式使用不同的 Claude 模型吗?
可以,而且这是该工具中最主要的成本调节手段。Roo Code 会保存命名的 API 配置档案,并记住你在每种模式中最后使用的档案,因此可以将强模型绑定到 Architect 和 Debug,将更便宜的模型绑定到 Code 和 Ask。一个实用的分配方式是:Architect 和 Debug 使用 claude-opus-5($3.50/$17.50 每 1M),Code 使用 claude-sonnet-5($1.40/$7.00)——它比 claude-sonnet-4-6($2.10/$10.50)更新,并且在 Kunavo 上每个 token 更便宜;Ask 使用 claude-haiku-4-5($0.70/$3.50)。三个档案使用同一个密钥,只有模型 slug 不同。
在 Roo Code 中运行 Claude 的成本是多少?
Roo Code 会在每一步重新发送任务上下文,因此成本取决于步骤数,而不是耗时。典型的一步约包含 25,000 个输入 token 和 1,200 个输出 token——按 Kunavo 费率使用 claude-sonnet-5 时约为 $0.043,因此一个 20 步任务的成本接近 $0.87,而 Anthropic 标价约为 $1.24。失败的请求永不计费。原生 Anthropic provider 路由支持提示词缓存,缓存输入按输入费率的 10% 计费,这是最大的结构性节省。
Cline 和 Kilo Code 也能使用相同的配置吗?
可以——三者使用的是同一个 provider model,因为 Roo Code 和 Kilo Code 都是 Cline 家族的分支。具体工具的细节有所不同:Cline 配合 Claude API介绍其 Plan/Act 分离,Kilo Code 配合 Claude API介绍其自身的配置。对于终端代理而非编辑器扩展,Claude Code 配置指南介绍环境变量约定,Claude Code 定价则通过订阅与 API 的盈亏平衡来说明成本。