在 Kilo Code 中使用自定义提供商:DeepSeek、Claude 或任何 OpenAI 兼容模型

Kilo Code 是一款开源编程 agent,支持 VS Code、JetBrains 和终端。它可以把任何 OpenAI 兼容 API 作为自定义提供商接入。我们在 Kilo CLI 中配置了 Zurelay(它与编辑器扩展读取同一个设置文件),在 DeepSeek V4.1 Flash 和 Claude Sonnet 5.5 上运行了任务,并记录了过程中遇到的每个错误。

· Zurelay 指南 · 价格实时更新

在 VS Code 中

  1. 打开 Kilo Code 的设置(齿轮图标),进入 Providers 标签页。在底部点击 Custom provider。
  2. 将 Provider ID 设为 zurelay,填写显示名称,并将 Provider API 设为 OpenAI Compatible。
  3. 填入基础 URL https://api.zurelay.com/v1 和你的密钥。用 Fetch models 加载模型列表,添加你需要的模型,然后提交。
  4. 在聊天的模型菜单中选择一个 Zurelay 模型。

以下步骤参照 Kilo 的提供商文档。我们是在 Kilo CLI 中完成配置的。Kilo 文档说明,CLI、VS Code 和 JetBrains 读取的是同一套配置文件,因此在其中一处配置好的提供商,在其他两处也会显示。

在 Kilo CLI 中,或直接编辑文件

Kilo 的设置保存在 ~/.config/kilo/kilo.jsonc,Windows 上是 %USERPROFILE%\.config\kilo\kilo.jsonc。这是我们测试用的文件,其中是 Zurelay 当前每 1M token 的价格:

~/.config/kilo/kilo.jsonc
{
"$schema": "https://app.kilo.ai/config.json",
"model": "zurelay/deepseek-v4.1-flash",
"small_model": "zurelay/deepseek-v4.1-flash",
"provider": {
"zurelay": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zurelay",
"options": {
"baseURL": "https://api.zurelay.com/v1",
"apiKey": "{env:ZURELAY_API_KEY}"
},
"models": {
"deepseek-v4.1-flash": {
"name": "DeepSeek V4.1 Flash",
"cost": { "input": 0.03, "output": 0.12, "cache_read": 0.00074 }
},
"claude-sonnet-5-5": {
"name": "Claude Sonnet 5.5",
"cost": { "input": 0.79, "output": 3.95, "cache_read": 0.079 }
}
}
}
}
}

然后安装 CLI、设置密钥并运行任务:

terminal
npm install -g @kilocode/cli
export ZURELAY_API_KEY="zr_live_..."
kilo models zurelay
kilo run -m zurelay/claude-sonnet-5-5 "Add a README for this project"
kilo # or the full terminal UI

我们遇到的三个错误

  1. Provider not found: zurelay. 我们最初的配置里有基础 URL 和密钥,但没有 models,以为 Kilo 会通过 API 自动加载。CLI 不会:没有列出任何模型的提供商,对它来说就不存在。请列出你要用的每个模型。
  2. environment references are not allowed in project config. 把配置移到项目里的 .kilo/kilo.jsonc 后,同一个文件因 {env:ZURELAY_API_KEY} 被拒绝,所有模型随后都返回 Model not found。Kilo 不会从项目自己的配置里读取密钥,所以请把提供商放在全局文件里。
  3. 每个任务都显示 $0.00,位置在 kilo stats。Kilo 只统计带有 cost 的模型的花费,单位是美元每 1M token。加上之后,kilo export 中每条消息的费用与我们的账单一致:$0.0000406 对 $0.000041。统计表仍然四舍五入到分,所以小任务在那里显示 $0.00。

我们的测试花了多少钱

在一个全新的 git 仓库里,Kilo 的默认 agent 先用 DeepSeek V4.1 Flash 写了一个小的 Python 文件,再用 Claude Sonnet 5.5 编辑它,然后又用 DeepSeek 添加了一行。每次它都正确使用了文件工具。Zurelay 的计费如下:

模型任务请求提示词 token (已缓存)费用
DeepSeek V4.1 Flash创建 hello.py231,842 (0)$0.00097
Claude Sonnet 5.5编辑 hello.py490,282 (44,721)$0.041
DeepSeek V4.1 Flash添加一行注释348,267 (15,360)$0.001

在你的代码之前,每个请求都会带上 Kilo 的指令和工具定义:DeepSeek 上约 16,000 token,Claude 上约 22,000 token。所以模型的价格比任务大小更重要,缓存也因此有用:在 Claude 任务中,一半的提示 token 来自缓存。

注意事项

  • 即使是 GPT 和 Grok 模型,也请选择 OpenAI Compatible。Kilo 的 OpenAI Responses 选项调用的是 OpenAI 的 Responses API,Zurelay 不提供该接口。
  • 选择支持工具调用的模型。Kilo 的 agent 通过工具读取和编辑文件,没有工具调用的模型只能聊天。
  • small_model 负责生成标题等快速的小任务。用 DeepSeek V4.1 Flash 这样的低价模型就够了。
  • npm 11 在我们这里跳过了 CLI 的安装脚本(install scripts not yet covered by allowScripts)。不依赖脚本时,kilo 命令可以正常运行。

你会用到的模型的价格

各模型厂商与 Zurelay 的每 1M token 价格:

模型输入输出Zurelay 价格(输入 / 输出)
DeepSeek V4.1 Flash$0.30$1.20$0.03 / $0.12
Claude Sonnet 5.5$2.00$10.00$0.79 / $3.95
Claude Opus 5.5$4.00$20.00$1.40 / $7.00
GPT-6.1 Terra$1.00$5.00$0.25 / $1.25
Gemini 3.8 Flash$0.75$3.75$0.22 / $1.10
Kimi K3.1 Pro$2.00$10.00$0.80 / $4.00
GLM-5.3$1.40$4.40$0.38 / $1.21

2026年11月3日 测试,环境为 Windows 上的 Kilo CLI 7.8.18,对接 Zurelay 的 API。简要设置步骤见 文档中的 Kilo Code。Kilo 自己的文档:OpenAI 兼容提供商和自定义模型。

一个兼容 OpenAI 的 API 密钥即可调用所有模型,价格低于官方定价。$10 起充值,无需订阅。获取你的 API 密钥

常见问题

常见问题

还有其他问题?联系我们的团队,我们会通过邮件回复。

如何在 Kilo Code 中添加自定义提供商?

打开 Kilo Code 的设置,进入 Providers 标签页,点击底部的 Custom provider。填写提供商 ID,将提供商 API 选为 OpenAI Compatible,输入基础 URL 和 API 密钥,添加你需要的模型,然后提交。

Kilo Code 的配置文件在哪里?

全局配置文件位于 ~/.config/kilo/kilo.jsonc(Windows 上为 %USERPROFILE%\.config\kilo\kilo.jsonc);项目级配置位于项目根目录下的 kilo.jsonc 或 .kilo/kilo.jsonc。CLI、VS Code 和 JetBrains 读取的是同一组文件。

为什么 Kilo 提示 Provider not found?

我们测试时,该 provider 下没有列出任何模型。Kilo CLI 只会提供 kilo.jsonc 中 models 下列出的自定义 provider 模型,所以请把每个要用的模型 ID 都添加到那里。

为什么 Kilo 提示项目配置中不允许使用环境变量引用?

Kilo 不会解析项目自身配置文件中的 {env:VAR},因此那里的密钥引用会被拒绝。请改为把带有 {env:...} 密钥的 provider 放到全局的 ~/.config/kilo/kilo.jsonc 中。

为什么 Kilo Code 显示我的用量是 $0.00?

只有当自定义 provider 的模型带有 cost 条目时,Kilo 才会为其计价:input、output 和 cache_read,单位为每 1M token 的美元价格。请在 kilo.jsonc 中为每个模型添加。另外,kilo stats 会按美分四舍五入,所以小任务在那里会显示 $0.00。

Kilo CLI 和 VS Code 扩展使用相同的设置吗?

是的。Kilo 的文档说明,CLI、VS Code 和 JetBrains 读取同一组 JSONC 配置文件,所以在其中一处添加的 provider 会同步出现在其他几处。

更多指南

告别原价.
今天就开始省钱.

几秒钟即可创建密钥,将你正在使用的 SDK 指向 Zurelay,从第一个 token 起,每次请求的费用最高可省 90%。