文档
Kilo Code
Kilo Code 的自定义 Provider 只需填写四项。填写后,扩展程序便可通过一个密钥调用 Claude 和 GPT——它不会获知端点背后的供应商。
Providers → Custom provider → OpenAI Compatible,基础 URL 保留 /v1,并填入 Claude 模型 ID — Kilo Code 不会知道背后的厂商。
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/v1 后缀——Kilo Code 只会追加路由路径,其官方文档示例也以 /v1 结尾。这与 Anthropic 风格的客户端正好相反,后者需要的是不带路径的源站地址。OpenAI Compatible 后填写 Claude 模型 ID,正是预期的组合:ID 会在端点处解析,而不是在扩展程序内解析。kilo.jsonc 中为每个 Kunavo 模型设置 limit.context 和 limit.output,位置是 provider.<id>.models.<model>;每个模型页面都列出了这两个值。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Kilo Code 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 打开 Kilo Code 设置(齿轮图标),进入 Providers 标签页,滚动到底部并点击 Custom provider。
- 按上文填写 Provider ID、Display name、Provider API =
OpenAI Compatible、Base URL 和 API key。 - 在 Models 下,手动添加 ID,或从自动获取的列表中选择——Kunavo 会响应
GET /v1/models,因此列表会自动填充。 - 在聊天模式选择器中选中该 Provider 并发送消息。将低价模型指定给频繁运行的模式,将高价模型指定给负责规划的模式。
已于 2026年9月6日对照 Kilo Code 的 OpenAI Compatible Provider 页面检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。
调试客户端前先验证
一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 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 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 Kilo Code 中的位置 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | Code 和 Architect 模式——默认工作模型 |
claude-opus-5 | $3.50 / $17.50 | 大型重构时使用 Architect 模式,此时规划出错代价高昂 |
claude-haiku-4-5 | $0.70 / $3.50 | Ask 模式和快速文件分类,此时请求量是主要因素 |
gpt-5-6-sol | $2.00 / $12.00 | 来自不同模型系列的第二意见,共用同一密钥 |
常见问题
如何向 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 有误。也可以随时手动输入模型。