Kilo Code 是 VS Code 中使用最广泛的开源 AI 编码代理之一,与 Cline 家族的同类工具一样,它允许你使用自己的兼容 OpenAI 的 API 端点。这意味着你可以使用一个 sk-kn- 密钥,在编辑器中运行 Claude,主流模型的价格约比 Anthropic 列表价低 30%。本指南介绍三字段设置、如何按任务选择 Claude 模型,以及一次代理式编码会话的实际成本。
Kilo Code 为什么需要 API 密钥
Kilo Code 不捆绑模型——每项操作(读取文件、提出编辑、运行命令、检查结果)都是一次 API 调用,并按 Token 计费。Claude Pro 这样的聊天订阅不涵盖这一点;扩展需要直接 API 访问权限。这正是 Kunavo 提供的形式:从 10 美元充值起按需付费,一个密钥即可用于 Claude 和 GPT,余额永不过期。由于代理循环会在每一步重新发送不断增长的任务上下文,每 Token 费率是决定会话成本的最大杠杆——这也是 claude-sonnet-5 上约 30% 的折扣会快速叠加的原因。
三个字段
Kilo Code 将提供商公开为三个设置字段:
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注册并充值 $10 后,从控制台获取密钥——密钥仅显示一次,请立即妥善保存。完整的密钥管理说明请参阅 Claude API 密钥文档。
Kilo Code 设置
- 从 VS Code Marketplace 安装 Kilo Code,然后从侧边栏打开它。
- 打开扩展设置(齿轮图标),转到 Providers 部分。
- 将 API Provider 设置为 OpenAI Compatible。
- Base URL:
https://api.kunavo.com/v1· API key:你的sk-kn-…密钥 · Model:claude-sonnet-5。 - 保存,然后先询问一个小问题(“解释这个文件”),确认连接正常后再让它编辑代码。
Kilo Code 支持按模式覆盖模型(Architect / Code / Debug)——可以将规划路由到更强的模型(claude-opus-5),将执行路由到更便宜的模型(claude-sonnet-5)。
Cline 和 Roo Code
Kilo Code 和 Roo Code 都是 Cline 家族的分支,因此上述三个字段在三种工具中完全相同——提供商 OpenAI Compatible、Base URL https://api.kunavo.com/v1、密钥和模型 ID。不同之处在于每个工具提供的模型路由功能,而成本节省就来自这里,因此各自都有专门指南:Cline 与 Claude API介绍其 Plan/Act 拆分,Roo Code 与 Claude API介绍其命名配置文件和按模式绑定模型。
三种工具还都提供原生 Anthropic 提供商以及自定义 Base URL 选项。将其指向 https://api.kunavo.com 后,会改用原生 Messages API(/v1/messages)——这很有用,因为 cache_control 会原样传递,缓存输入按输入费率的 10% 计费(参见提示缓存文档)。两条路线都可用;兼容 OpenAI 的路线最容易开始。
不过,提示缓存本身并不需要原生路线。对于较长的提示,Kunavo 会在兼容 OpenAI 的路线上自行设置缓存断点:设在系统提示、工具定义,以及对话中已有助手回合时的最后一条消息上;在代理循环中,这就是第一步之后的每一步。扩展在该路线上设置的 cache_control 会被保留。在原生路线上,请求按扩展发送的原样转发,不会添加任何断点,因此缓存哪些内容取决于扩展设置的断点。
如何选择 Claude 模型
| 任务 | 模型 | Kunavo 输入 / 输出(每 100 万 Token) |
|---|---|---|
| 日常代理式编码(默认) | claude-sonnet-5 | $1.40 / $7.00 |
| 上一代 Sonnet,适用于已针对其调优的提示 | claude-sonnet-4-6 | $2.10 / $10.50 |
| 最困难的重构和调试 | claude-opus-5 | $3.50 / $17.50 |
| 快速编辑、提交消息、问答 | claude-haiku-4-5 | $0.70 / $3.50 |
claude-opus-5 是这里的强推理选择:它是 Anthropic 最新的 Opus,并以与上一代 claude-opus-4-7 相同的 $3.50 / $17.50 费率计费($3.50 / $17.50);如果你已固定使用上一代版本,该版本仍然可用。由于模型字段只是同一端点上的 slug,切换只需改一个词——无需新密钥,也无需新的提供商配置。每个模型的完整费率请参阅 Claude API 定价指南和定价页面。
一次会话的实际成本
代理式工具的设计本身就很耗 Token:每一步都会重新发送系统提示、任务历史和新文件上下文。按 Kunavo 费率计算的现实数字如下:
| 单位 | token(输入 / 输出) | claude-sonnet-5 | 按 Anthropic 列表价 |
|---|---|---|---|
| 一次代理式步骤 | 25,000 / 1,200 | $0.043 | $0.062 |
| 一个 20 步任务 | 约 500k / 约 24k | ~$0.87 | ~$1.24 |
| 高强度的一天(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),
}
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 agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200)) # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200)) # -> ~$0.87控制账单
- 开始新任务,而不是无限延长一个任务。 工具会在每一步重新发送整个对话,因此长期运行的任务成本呈平方级增长。新任务 = 全新的小型上下文。
- 按模式路由。 Kilo Code 支持为每种模式指定模型——Architect 使用
claude-opus-5,Code 使用claude-sonnet-5,快速问题使用claude-haiku-4-5。规划只占 Token 的一小部分,因此在那里使用更强的模型成本很低。 - 使用原生 Anthropic 路线进行缓存。 缓存输入按输入费率的 10% 计费——对于每一步都重新发送稳定前缀的循环,这是可获得的最大节省(工作原理)。
- 关注每个密钥的支出。 为编辑器使用独立密钥,并在控制面板中设置支出限额;检查使用量,了解一周代理式编码的实际成本。
常见问题
在 Kilo Code 中使用 Claude API 时应使用什么 Base URL?
将 API 提供商设置为 'OpenAI Compatible',将 Base URL 设置为 https://api.kunavo.com/v1,并使用 Kunavo API 密钥(sk-kn-...)和类似 claude-sonnet-5 的 Claude 模型 slug。如果改用原生 Anthropic 提供商,请仅将 Base URL 设置为源站(https://api.kunavo.com)——该客户端会自行追加 /v1/messages。
我可以在 Kilo Code 中使用 Claude Pro 或 Max 订阅吗?
不可以——聊天订阅不包含 API 访问权限。Kilo Code 直接调用 API,并按 Token 计费。按需付费密钥适合这种场景:在 Kunavo 上可从 10 美元起充值,Claude 的价格比 Anthropic 列表价低 30%,余额永不过期。
哪个 Claude 模型最适合 Kilo Code?
claude-sonnet-5(Kunavo 上每 100 万 Token 为 $1.40/$7.00)是日常代理式编码的默认选择:编码质量接近 Opus,而且在这里每 Token 的成本低于 claude-sonnet-4-6($2.10/$10.50)。对于最困难的重构和调试,可升级到 claude-opus-5($3.50/$17.50)——它是更新一代的 Opus,费率与 claude-opus-4-7 相同,因此升级不会增加任何费用。将快速、简单的请求路由到 claude-haiku-4-5,可进一步降低成本。 claude-opus-5 的费率和规格见其模型页面;模型之间的比较定位请参阅 Claude、GPT 与 Gemini 对比。
使用 Claude 和 Kilo Code 的成本是多少?
代理式工具会在每一步重新发送上下文,因此 Token 会不断累积:典型步骤约为 2.5 万输入 / 1,200 输出,在 Kunavo 费率下使用 claude-sonnet-5 约为 $0.043——20 步任务约为 $0.87,而按 Anthropic 列表价约为 ~$1.24。失败的请求不收费。
Cline 和 Roo Code 也使用相同的设置吗?
是的。Kilo Code 和 Roo Code 是 Cline 家族的分支,共享相同的提供商模型:选择 'OpenAI Compatible',将 Base URL 设置为 https://api.kunavo.com/v1,粘贴密钥,并设置模型 ID。不同之处在于每个工具如何路由模型——Cline 将 Plan 和 Act 模式分开,Roo Code 将命名配置文件绑定到模式——成本节省就来自这里,因此各自都有专门指南。三者也都提供带自定义 Base URL 选项的原生 Anthropic 提供商;将其指向源站 https://api.kunavo.com,以传递 cache_control。
这与使用 OpenAI SDK 有什么不同?
机制相同:任何兼容 OpenAI 的客户端都可以通过更改 base_url 来工作——编辑器扩展只是将其作为设置字段公开。通用模式请参阅 OpenAI 兼容 API 指南。
那 Claude Code,这个终端代理呢?
Claude Code 的配置方式不同——它从环境中读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,而不是读取设置字段,并且使用原生 Messages API,而不是兼容 OpenAI 的 API。有关变量、导致大多数 401 错误的凭据陷阱以及网关会带来的变化,请参阅 Claude Code 设置指南。