使用 Claude API 的 Kilo Code——base URL、模型与成本（也适用于 Cline 和 Roo Code）

Kilo Code、Cline 和 Roo Code 是 VS Code 中使用最广泛的开源代码代理，而且三者都接受自定义的 OpenAI 兼容端点。也就是说：只需一个 sk-kn- 密钥，就能在编辑器中运行 Claude，主要模型的价格比 Anthropic 官方价目表低约 30%。本指南介绍每个工具的三字段配置、按任务类型选择 Claude 模型的方法、一次 agentic 编码会话的实际成本，以及如何在巴西通过 Pix 支付，无需国际信用卡。

为什么这些工具需要 API 密钥

Kilo Code、Cline 和 Roo Code 本身不内置任何模型：每个操作（读取文件、提出修改、运行命令、检查结果）都是按 token 计费的 API 调用。Claude Pro 这类聊天订阅不包含这些调用——必须直接访问 API。Kunavo 正是为此而生：充值 $10 起的按需付费、一个密钥即可使用 Claude 和 GPT、余额永不过期，并支持在巴西通过 Pix 或银行卡支付（延迟、LGPD 和发票的完整说明见 巴西 Claude API 指南）。由于 agentic 循环会在每一步重新发送上下文，token 价格是会话成本的第一大杠杆。

三个字段（适用于这三个工具）

这三个扩展共享同一种 provider 模型——Kilo Code 和 Roo Code 都是 Cline 家族的 fork——因此配置完全相同：

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # criada em kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-5 / claude-haiku-4-5

在注册并充值 $10 后，在dashboard中创建密钥——密钥只显示一次，请立即保存。

配置 Kilo Code

1. 从 VS Code marketplace 安装 Kilo Code，然后打开侧边栏中的面板。
2. 打开扩展设置（齿轮图标），进入 Providers 部分。
3. 将 API Provider 保持为 OpenAI Compatible。
4. Base URL：https://api.kunavo.com/v1 · API 密钥：你的 sk-kn-… · 模型：claude-sonnet-5。
5. 保存后，先用一个简单请求（“解释这个文件”）进行测试，再让工具编辑代码。

Kilo Code 允许每种模式使用不同模型（Architect / Code / Debug）——可以将规划交给更强的模型，将执行交给更便宜的模型，非常实用。

配置 Cline

1. 安装 Cline 并打开其面板。
2. 点击设置齿轮，在 API Provider 中选择 OpenAI Compatible。
3. 填写相同的三个值：base URL https://api.kunavo.com/v1、你的密钥和 model ID claude-sonnet-5。
4. 如果 Cline 要求填写模型元数据（上下文窗口、output 上限），请使用模型页面中的数字。

配置 Roo Code

与另外两个工具相同：Settings → Providers → API Provider → OpenAI Compatible，然后填写 base URL https://api.kunavo.com/v1、密钥和 model ID。Roo Code 的模式系统（Code / Architect / Ask / Debug）也支持按模式设置模型。

这三个工具还提供原生的 Anthropic provider，并支持自定义 base URL。指向 https://api.kunavo.com 后，你会通过原生的 Messages API（/v1/messages）——这很有意思，因为 cache_control 会直接通过，且缓存输入按输入费率的 10% 计费（参见 prompt caching 文档）。两条路线都可用；OpenAI 兼容路线最适合入门。

不过，提示词缓存本身并不依赖原生路线。对于较长的提示词，Kunavo 会在 OpenAI 兼容路线上自行设置缓存断点：设在系统提示词、工具定义，以及对话中已有助手回合时的最后一条消息上；在智能体循环中，这就是第一步之后的每一步。扩展在该路线上设置的 cache_control 会被保留。在原生路线上，请求按扩展发送的原样转发，不会添加任何断点，因此缓存哪些内容取决于扩展设置的断点。

在巴西付款——Pix，无需国际信用卡

大多数巴西开发者遇到的障碍不是配置，而是付款：直接向 Anthropic 支付 API 费用，需要一张已启用境外消费的国际信用卡。在 Kunavo，付款由 Stripe 处理，Pix 会作为巴西付款用户的付款方式显示——金额以雷亚尔显示并立即到账，无需依赖国际银行卡。国际银行卡（Visa、Mastercard、American Express）、Apple Pay、Google Pay 和 Link 也都可以正常使用。

令牌价格以 USD 确定：使用 Pix（以及结账页面以雷亚尔显示时使用银行卡）时，Stripe 会在你确认前显示换算后的雷亚尔金额，且该汇率包含 2–4% 的换汇成本，由买家承担；如果选择使用美元支付银行卡账单，则不会产生这项成本，换算将按照发卡机构的汇率进行（请在银行应用中确认 IOF 和国际交易手续费）——Pix 充值的分步说明请参阅使用 Pix 支付 API 的指南。这是一个预付钱包：最低充值金额为 $10，无月费，且余额永不过期——因此，一个月不写代码不会产生任何费用，不同于订阅。

应该选择哪个 Claude 模型？

模型字段只是同一端点上的一个 slug：切换模型只需更改一个词——无需新密钥，也无需新 provider。完整价格见Claude API 价格指南和价格页面。

一次会话的实际成本

Agentic 工具从设计上就会消耗大量 token：每一步都会重新发送 system prompt、任务历史和文件上下文。按 Kunavo 价格计算的现实数字如下：

也就是说，在 Sonnet 5 中，$10 的 Pix 充值大约可以覆盖 11 个 20 步 agentic 任务。你可以自行这样计算：

# Tarifas Claude na Kunavo (USD por 1M de tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def custo_passo(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# Um passo do agente: a ferramenta reenvia o contexto + os arquivos lidos.
print(custo_passo("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Uma tarefa realista de 20 passos (editar, rodar, corrigir, repetir):
print(20 * custo_passo("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

在相同内容下，葡萄牙语消耗的 token 通常比英语多约 10–20%——当提示词和代码注释使用葡萄牙语时，值得考虑这一点。

如何降低账单

1. 开启新任务，而不是不断延长同一个任务。工具会在每一步重新发送完整对话：无休止的任务会产生平方级增长的成本。新任务 = 更短的上下文。
2. 按模式路由。 Kilo Code 和 Roo Code 支持按模式设置模型——Architect 使用 claude-opus-5，Code 使用 claude-sonnet-5，快速提问使用 claude-haiku-4-5。
3. 使用原生 Anthropic 路线进行缓存。缓存输入按输入费率的 10% 计费——在每一步都重新发送稳定前缀的循环中，这是可获得的最大节省（工作原理）。
4. 按密钥跟踪支出。为编辑器使用单独的密钥，在 dashboard 中设置支出上限，并在使用面板中查看一周 agentic 编码的真实成本。

常见问题