文档

文档

Kilo Code

Kilo Code 的自定义 Provider 只需填写四项。填写后,扩展程序便可通过一个密钥调用 Claude 和 GPT——它不会获知端点背后的供应商。

Providers → Custom provider → OpenAI Compatible,基础 URL 保留 /v1,并填入 Claude 模型 ID — Kilo Code 不会知道背后的厂商。

Settings → Providers → Custom provider
Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5
此处的 base URL 需要保留 /v1 后缀——Kilo Code 只会追加路由路径,其官方文档示例也以 /v1 结尾。这与 Anthropic 风格的客户端正好相反,后者需要的是不带路径的源站地址。
Provider API 是协议选择器,而不是供应商选择器。选择 OpenAI Compatible 后填写 Claude 模型 ID,正是预期的组合:ID 会在端点处解析,而不是在扩展程序内解析。
Kilo 获取模型的上下文和输出上限时,先看你的配置,再看它自带并每小时刷新的 models.dev 快照,都没有就用 0(见其自定义模型文档,读取于 2026-10-23)。Kunavo 还没有收录在 models.dev 上:申请收录在 2026-10-22 仍未合并。Custom provider 对话框里没有上限字段,所以请在 kilo.jsonc 中为每个 Kunavo 模型设置 limit.context 和 limit.output,位置是 provider.<id>.models.<model>;每个模型页面都列出了这两个值。
还没有密钥?创建 Kunavo 账户,创建一个密钥(以 sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Kilo Code 设置页面。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 打开 Kilo Code 设置(齿轮图标),进入 Providers 标签页,滚动到底部并点击 Custom provider。
  3. 按上文填写 Provider ID、Display name、Provider API = OpenAI Compatible、Base URL 和 API key。
  4. 在 Models 下,手动添加 ID,或从自动获取的列表中选择——Kunavo 会响应 GET /v1/models,因此列表会自动填充。
  5. 在聊天模式选择器中选中该 Provider 并发送消息。将低价模型指定给频繁运行的模式,将高价模型指定给负责规划的模式。

已于 2026年9月6日对照 Kilo Code 的 OpenAI Compatible Provider 页面检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。

这是简要版本。完整教程——包括模型选择、真实会话成本和失败模式——见 Kilo Code + Claude 操作指南。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Kilo Code 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。

模型 IDKunavo 输入 / 输出它在 Kilo Code 中的位置
claude-sonnet-5$1.40 / $7.00Code 和 Architect 模式——默认工作模型
claude-opus-5$3.50 / $17.50大型重构时使用 Architect 模式,此时规划出错代价高昂
claude-haiku-4-5$0.70 / $3.50Ask 模式和快速文件分类,此时请求量是主要因素
gpt-5-6-sol$2.00 / $12.00来自不同模型系列的第二意见,共用同一密钥
计费方式是从预付余额中按 token 扣费,无月费——参见 计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

常见问题

如何向 Kilo Code 添加自定义 Provider?

点击齿轮图标打开 Kilo Code 设置,进入 Providers 标签页,滚动到列表底部并点击“Custom provider”。填写 Provider ID 和 Display name,将 Provider API 设为“OpenAI Compatible”,粘贴端点的 base URL 和 API key,然后手动添加模型 ID,或从自动获取的列表中选择。之后,该 Provider 会像内置 Provider 一样显示在模式选择器中。

没有 Anthropic 账户,Kilo Code 也能使用 Claude 模型吗?

可以。Kilo Code 的“OpenAI Compatible”Provider API 指的是线路协议,而不是供应商;它会将模型 ID 原样传递给你配置的 base URL。因此,Claude ID 会在该端点处解析,而不是在扩展程序内解析,所以你持有的是该端点的凭据,而非 Anthropic 的凭据。

Kilo Code 的基础 URL 末尾需要加 /v1 吗?

对于兼容 OpenAI 的端点,需要。Kilo Code 只会追加路由,例如 /chat/completions、/models,因此基础 URL 必须是 /v1 根路径,例如 https://api.kunavo.com/v1。其文档中的示例也使用了相同后缀。缺少 /v1 会导致 404,而不是身份验证错误。

为什么添加提供方后,Kilo Code 中没有显示模型?

模型列表会使用你输入的密钥从端点的 /v1/models 路由获取,因此列表为空通常意味着密钥或基础 URL 有误,而不是该提供方没有模型。使用相同的密钥和 URL,通过普通 curl 请求 /v1/models 进行测试:如果返回 JSON,问题出在扩展的配置中;401 表示密钥有误;404 表示 URL 有误。也可以随时手动输入模型。