返回指南
集成·2026年8月8日·更新于 2026年11月14日·阅读约 9 分钟

使用 Claude API 的 Roo Code——提供商设置与按模式指定模型

Roo Code 提供模式,但不提供模型。下面介绍三字段提供商设置、其原生 Anthropic 路由中的基础 URL 陷阱,以及如何通过配置文件让 Architect 使用 Opus 思考,让 Code 使用 Sonnet 执行。

最后审核于 。

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。需要填写三个值:

Roo Code → Settings → Providers
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 配置档案,并记住你在每种模式中最后使用的档案。因此,模型成为模式的属性,而不是你需要记住手动更改的设置:

profile-per-mode
# 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——规划、设计、困难的 bugclaude-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 → KunavoRoo 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

可运行的计算如下:

roo_session_cost.py
# 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

控制账单

  1. 开始新任务,而不是无限延长一个任务。 Roo Code 会在每一步重新发送整个对话,因此一个长期运行的任务会使成本呈二次增长。新任务拥有全新且较小的上下文,这是这里收益最大的习惯。
  2. 为每种模式绑定一个档案。 上文已经介绍:它将模型路由变成配置,而不是你在任务中途必须记住的事情。
  3. 使用原生 Anthropic 路由进行缓存。 对于每一步都会重新发送稳定前缀的循环,按输入费率 10% 计费的缓存输入是最大的结构性节省。
  4. 为编辑器使用一个单独的限额密钥。 在控制台创建一个单独的密钥,并在实际使用一周后检查用量——这才是诚实估算成本的唯一方式。

常见问题

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 的盈亏平衡来说明成本。