使用 Claude API 的 Kilo Code——基础 URL 配置（也适用于 Cline 和 Roo Code）

Kilo Code、Cline 和 Roo Code 是 VS Code 中使用最广泛的开源 AI 编程代理，而三者都接受自定义的 OpenAI 兼容 endpoint。因此，您可以使用一把密钥 sk-kn- 在编辑器中运行 Claude，主要模型的价格约比 Anthropic 官方费率低 约 30%。本指南介绍每种工具的三个字段配置、根据任务选择 Claude 模型的方法，以及一次代理式编程会话的实际成本。

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

Kilo Code、Cline 和 Roo Code 不内置模型：每项操作（读取文件、提出修改、运行命令、检查结果）都是一次 API 调用，并按 token 计费。Claude Pro 这类聊天订阅不涵盖这些调用——您需要直接访问 API。这正是 Kunavo 提供的服务：从 10 美元充值起按需付费，一把密钥访问 Claude 和 GPT，余额永不过期，并支持在法国使用银行卡付款（增值税和 GDPR 详情见 Claude API 法国指南）。由于代理循环会在每一步重新发送上下文，每 token 费率是一次会话成本的首要影响因素。

三个字段（所有工具通用）

三个扩展共享同一种 provider 模式——Kilo Code 和 Roo Code 是 Cline 家族的分支，因此配置完全相同：

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # à créer sur kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-4-7 / claude-haiku-4-5

完成注册并充值 $10 后，在控制面板中创建密钥——密钥仅显示一次，请立即妥善保存。

配置 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 要求提供模型元数据（上下文窗口、输出上限），请使用模型页面中的数字。

配置 Roo Code

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

这三个工具也都提供原生 Anthropic 提供商，并支持自定义基础 URL。将其指向 https://api.kunavo.com 后，您会使用原生 Messages API（/v1/messages）——这一点很有用，因为 cache_control 会原样传递，缓存输入按输入费率的 10% 计费（参见提示词缓存文档）。两条路径都可用；兼容 OpenAI 的路径是最简单的入门方式。

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

应选择哪个 Claude 模型？

模型字段只是同一 endpoint 上的一个 slug：切换模型只需修改一个单词——无需新 key，也无需新 provider。所有价格都列在 Claude API 价格指南和价格页面中。

一次会话的实际成本

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

可执行的计算方式：

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

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

# Une étape agentique : l'outil renvoie le contexte + les fichiers lus.
print(cout_etape("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Une tâche réaliste de 20 étapes (éditer, lancer, corriger, répéter) :
print(20 * cout_etape("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

控制账单金额

1. 开启新任务，而不是不断延长同一个任务。 该工具在每一步都会重新发送完整对话：没完没了的任务会产生二次方级别的高昂成本。新任务 = 更短的上下文。
2. 按模式路由。 Kilo Code 和 Roo Code 支持为每种模式指定一个模型——Architect 使用 claude-opus-4-7，Code 使用 claude-sonnet-5，快速问题使用 claude-haiku-4-5。
3. 使用原生 Anthropic 路径进行缓存。 缓存输入按费率的 10% 计费——在每一步都重新发送稳定前缀的循环中，这是可获得的最大节省（了解其工作原理）。
4. 按 key 监控支出。 为编辑器提供专用 key，并在控制面板中设置支出上限；然后在用量中检查一周 agentic coding 的实际成本。

常见问题