Kilo Code 配置 Claude 和 GPT：自定义 API 提供方教程

简短回答

在 Kilo Code 中使用 APIVAI：打开 Kilo Code 的 Settings，进入 Providers 标签页，点击 Custom provider，把 Provider API 设为 OpenAI Compatible，Base URL 填 https://api.apivai.com/v1，把 APIVAI 密钥粘贴到 API key，再添加模型 ID，例如 claude-sonnet-4-6 或 gpt-5.5。如果只用 Claude，也可以把 Provider API 选为 Anthropic Messages；在 Kilo Code 里这个选项同样填带 /v1 的 https://api.apivai.com/v1，因为 Kilo Code 只会在 Base URL 后面加 /messages。截至 2026-10-10，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.15 / $5.74，官方价为 $3.00 / $15.00。费用按 token 从预付余额扣除，无需订阅。

Kilo Code 是什么？为什么要接入自己的 API 密钥？

Kilo Code 是一个开源的 AI 编程 Agent，有 VS Code 扩展、JetBrains 插件和命令行工具三种形态。它会规划改动、跨项目修改文件，并在你批准后运行命令。Kilo Code 需要接入模型提供方，任务中的每一步都是一次由该提供方计费的请求。

本文依据 Kilo Code 当前官方文档和 VS Code 扩展 7.8 版（2026 年 10 月）编写，这个版本通过 Custom provider 对话框添加第三方 API。如果你的设置页里没有 Custom provider 按钮，请先更新扩展。

APIVAI 提供一个可调用 Claude 和 GPT 模型的密钥，按 token 计费，大多数模型低于官方标价，从你自己充值的余额中扣除。同一个密钥同时支持 OpenAI 格式和 Anthropic 格式，因此适用于 Kilo Code 提供的每一种 Provider API。

在 Kilo Code 中应该选哪种 Provider API？

Custom provider 对话框提供三种协议。接入 APIVAI 时，三种都用同一个 Base URL：

Provider API	Base URL	模型	模型列表
OpenAI Compatible	`https://api.apivai.com/v1`	Claude 和 GPT	可用 Fetch models
Anthropic Messages	`https://api.apivai.com/v1`	仅 Claude	需手动填写 ID
OpenAI Responses	`https://api.apivai.com/v1`	GPT	可用 Fetch models

选 OpenAI Compatible：想用一个提供方同时覆盖 Claude 和 GPT。再加一个 Anthropic Messages 提供方：主要用 Claude 时，Kilo Code 会发送带 cache_control 标记的原生 Anthropic 请求，重复的上下文按缓存读取价计费，Claude Sonnet 4.6 为每百万 token $0.12，而不是完整的输入价。缓存写入为每百万 $1.44。OpenAI Responses 可选：GPT 模型通过 OpenAI Compatible 已经可以使用。

如何一步步把 Kilo Code 接入 APIVAI？

第 1 步：创建 APIVAI 密钥

在 apivai.com 用邮箱注册。
充值 $10 起，支持银行卡、加密货币、支付宝和微信支付。没有免费试用，也没有订阅。
在控制台创建密钥并复制。如果想严格限制 Kilo Code 的花费，可以给密钥设置预算上限。

第 2 步：把 APIVAI 添加为自定义提供方

在 VS Code 中打开 Kilo Code 面板，点击齿轮图标打开 Settings，进入 Providers 标签页。
滚动到底部，点击 Custom provider。
按下表填写对话框，然后点击 Submit。

字段	值
Provider ID	`apivai`（小写字母、数字、连字符或下划线）
Display name	APIVAI
Provider API	OpenAI Compatible
Base URL	`https://api.apivai.com/v1`
API key	你的 APIVAI 密钥
Models	点击 Fetch models，选择例如 `claude-sonnet-4-6` 和 `gpt-5.5`

填好 Base URL 和密钥后，Kilo Code 会用你的密钥请求 GET /v1/models，并显示一个可搜索的列表，这样你添加的都是 APIVAI 实际提供的 ID。如果获取失败，检查密钥和地址，或者点击 Add model 手动填写准确的 ID。Base URL 中 /v1 只出现一次；Kilo Code 会自动加上 /chat/completions。点击 Submit 后，在 Kilo Code 的模型选择器中选择模型。

也可以在终端里查看同一个列表：

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

模型会随时间上新或下线，请从这个列表或价格页复制 ID。

第 3 步（可选）：用 Anthropic Messages 添加 Claude 提供方

再次点击 Custom provider。
Provider ID 填 apivai-claude，Display name 填“APIVAI Claude”。
Provider API 选择 Anthropic Messages。
Base URL 填 https://api.apivai.com/v1，API key 粘贴同一个密钥。
在 Models 下点击 Add model，逐个填写 Claude 的 ID，例如 claude-sonnet-4-6 和 claude-opus-5-5。这种 Provider API 不支持 Fetch models。
点击 Submit。

这里要保留 /v1。Kilo Code 的 Anthropic Messages 客户端把 Base URL 当作带版本号的 API 前缀（它自己的默认值是 https://api.anthropic.com/v1），只在后面加 /messages，所以请求会发到 https://api.apivai.com/v1/messages。这和 Claude Code、Roo Code 正好相反，它们的 Anthropic 基础地址填不带 /v1 的 https://api.apivai.com。Anthropic 格式的说明见 Claude API 代理页面。

第 4 步：在配置文件中设置 token 上限

对话框不会设置上下文和输出上限。Kilo Code 文档建议为自定义模型设置 limit.context 和 limit.output：两者都不填时会被当作 0，自动上下文压缩随之关闭。编辑该提供方（对话框中有 Edit advanced settings in the JSON config file 链接），或打开全局配置文件 ~/.config/kilo/kilo.json，在提供方下加上上限：

{
  "provider": {
    "apivai": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.apivai.com/v1"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "tool_call": true,
          "limit": { "context": 200000, "output": 16384 }
        }
      }
    }
  },
  "model": "apivai/claude-sonnet-4-6"
}

limit.context 填模型页面上标注的上下文窗口，limit.output 保持 16384（至少 4096）。在对话框中填写的密钥仍保存在 Kilo Code 原来存放的位置；如果想改为从环境变量读取，在 options 中加入 "apiKey": "{env:APIVAI_API_KEY}"（只在全局配置中有效，项目级的 kilo.json 不行）。Kilo CLI 读取的也是这个文件。

在 Kilo Code 中该选哪个模型？

每百万输入 / 输出 token 价格，截至 2026-10-10：

模型 ID	价格（输入 / 输出）	适合
`claude-sonnet-4-6`	$1.15 / $5.74	日常编程：默认选择
`claude-sonnet-5-5`	$0.77 / $3.82	用更新的 Sonnet 写代码
`claude-opus-5-5`	$1.54 / $7.65	规划、最难的 bug
`claude-haiku-4-5`	$0.38 / $1.92	快速便宜的提问和小改动
`gpt-6-sol`	$0.30 / $1.52	编程或代码审查的 GPT 方案
`gpt-6-luna`	$0.0144 / $0.0768	非常便宜的提问

Kilo Code 的 Agent 几乎每一步都会调用工具，所以要选支持 function calling 的模型；上表中的模型都支持。如果某个任务在 Sonnet 上反复兜圈子，就把这个任务切到 Opus，而不是把 Opus 设为默认。

Kilo Code 配合 APIVAI 要花多少钱？

Agent 任务的每一步都会重新发送对话和已读取的文件，所以输入 token 占大头。两个计算示例：

一个编程任务，使用 Claude Sonnet 4.6：约 25 次请求，每次约 35,000 输入和 2,000 输出 token。费用：APIVAI $1.29，官方价 $3.38。
一个工作月，每天三个这样的任务，共 22 天（1,650 次请求）：APIVAI $85.35，官方价 $223。如果每天 20 个快速提问交给 Claude Haiku 4.5（每次 8,000 输入、800 输出 token，每月 440 次），增加 $2.01。

以上数字未计入提示缓存；使用 Anthropic Messages 提供方时，缓存会降低重复上下文的费用。思考 token 按输出 token 计费。每次请求的真实数据都在控制台里。更全面的对比见 2026 年 Claude API 价格对比。

Kilo Code 常见报错怎么解决？

获取模型时提示“Authentication failed”或返回 401： 密钥不完整、已删除或超出预算上限。请在控制台检查，并重新粘贴密钥，注意不要带空格。
404 Not Found： /v1 写错了。在 Kilo Code 中，每种 Provider API 都填 https://api.apivai.com/v1。少了 /v1，Anthropic Messages 会请求错误路径下的 /messages，OpenAI Compatible 会请求错误路径下的 /chat/completions。
Anthropic Messages 获取不到模型： 这是正常的，这种 Provider API 不支持获取列表。用 Add model 添加 Claude 的 ID。
找不到模型： 使用准确的 ID，例如 claude-sonnet-4-6，而不是显示名称。用 GET /v1/models 核对。
回复为空或被截断： 思考默认开启并消耗输出 token。把 limit.output 设为 16384（至少 4096）。
长任务中上下文始终不压缩： 按第 4 步设置 limit.context 和 limit.output。
429 Too Many Requests： 每个密钥默认每分钟 60 次请求。稍等片刻，或联系客服提高限额。

请求格式的更多说明见文档和 OpenAI 兼容 API 页面。

常见问题

在 Kilo Code 中能用一个密钥同时使用 Claude 和 GPT 吗？

可以。一个 APIVAI 密钥适用于所有模型。一个 OpenAI Compatible 提供方里可以同时列出 Claude 和 GPT 的 ID。

选 OpenAI Compatible 还是 Anthropic Messages？

GPT 模型，或者想用一个提供方搞定所有模型，选 OpenAI Compatible。主要用 Claude 时再加一个 Anthropic Messages，Kilo Code 会使用提示缓存；它的 Base URL 同样是 https://api.apivai.com/v1。

为什么 Kilo Code 的 Anthropic 要带 /v1，而 Claude Code 不用？

Claude Code 的客户端会在基础地址后加 /v1/messages，而 Kilo Code 的 Anthropic Messages 客户端只加 /messages。两者最终都请求 https://api.apivai.com/v1/messages。

同样的配置能用在 Kilo CLI 里吗？

可以。CLI 从 kilo.json 读取提供方，第 4 步的配置块同样适用。

APIVAI 会保存我的代码吗？

不会。请求和响应的内容不会被记录，只保留模型、token 数和费用等用于计费的使用数据。

和 Roo Code、Cline 的配置有什么不同？

模型和密钥相同，但设置界面不同。请看 Roo Code 配置教程和 Cline 配置教程。

注册账号，充值 $10 起，把密钥粘贴到 Kilo Code 即可。