Kilo Code 接入 OpenRouter：配置、模型路由与免费模型

Kilo Code 负责运行编码会话：聊天、编辑、上下文、模式，以及编辑器或终端内的模型选择器。它本身不提供模型，而是需要你接入一个提供商。

OpenRouter 就是这一提供商层。接入它之后，Kilo 只需一个 API 密钥，即可使用 70+ 家提供商的 300+ 个模型，并在同一处获得路由规则、故障转移和计费。Kilo 还提供 Kilo Gateway，这是它自己的托管计费路径，我们在下文进行对比。整个设置只需三步，路由控制集中在一个配置文件中。同一个密钥在 Kilo 之外也能用，参见如何将 OpenRouter 与任何编码智能体配合使用。

三步将 OpenRouter 添加到 Kilo Code

首先，在API 密钥页面创建密钥。使用 Google 或 GitHub 登录。除非你只使用免费模型，否则请在定价页面充值额度。按量付费没有最低消费要求。

其次，在 Kilo Code 中点击齿轮图标打开设置，进入 Providers 标签页，点击 OpenRouter 上的 Connect，粘贴密钥并保存。

第三，打开模型选择器，输入名称或 slug 来切换模型。在 openrouter.ai/models 浏览实时列表，因为随着提供商发布新模型，目录会发生变化。

Kilo 会将提供商设置写入 kilo.json（或 ~/.config/kilo/kilo.json），因此 VS Code 扩展和 CLI 共享同一份配置。Providers 标签页会替你编辑该文件；CLI 用户可以直接编辑。已保存密钥但没有额度时，首次付费请求仍会失败，因此在测试付费模型前请先充值。

通过 kilo.json 控制路由和长提示词

Kilo 会将模型 options 下的任何内容原样转发给 OpenRouter 作为 providerOptions.openrouter，不做校验。正是这种透传让你能在 Kilo 内使用 OpenRouter 的提供商路由。将 provider 块放在 models.{modelId}.options 下：

{
  "provider": {
    "openrouter": {
      "models": {
        "anthropic/claude-sonnet-4.5": {
          "options": {
            "provider": {
              "sort": "price",
              "order": ["Anthropic", "Google"],
              "only": ["Anthropic"],
              "data_collection": "deny",
              "zdr": true
            }
          }
        }
      }
    }
  }
}

每个字段对应一个 OpenRouter 路由参数：sort 对应 price、throughput 或 latency；order 用于设置提供商偏好；only 用于在不在批准列表内时直接失败；data_collection 和 zdr 用于数据策略。嵌套必须完全准确。放在根级 provider.openrouter 下的 provider 块不会生效，而且由于 Kilo 会不经校验地透传字段，拼写错误的字段会被静默忽略，不会报错。请严格匹配上述路径。

对于超出模型上下文窗口的提示词，OpenRouter 的中间向外变换会从模型关注度最低的中间部分丢弃内容，而不是拒绝请求。在同一个 options 块中开启它：

{ "options": { "transforms": ["middle-out"] } }

在 Kilo 内运行免费模型

OpenRouter 有 20+ 个免费模型。在 Kilo 的模型选择器中输入 free 即可筛选。未充值时，免费模型每天可运行 50 次请求，每分钟 20 次。充值 $10 或更多后，每日上限提升至 1,000 次。

请分清两条免费路径。OpenRouter 免费模型使用你的 OpenRouter 账户和速率限制。Kilo 的 kilo-auto/free 通过 Kilo Gateway 提供，不会动用你的 OpenRouter 额度或路由规则。

对于私有代码有一点需要注意：免费端点可能会记录提示词，因此除非数据策略符合你的要求，否则它们不适合专有源代码。添加 data_collection: "deny" 以缩小可用提供商范围。

选择 OpenRouter 还是 Kilo Gateway

两者都能为 Kilo Code 提供模型，因此选择取决于你的团队已经在使用什么。

当你已在多个工具中使用 OpenRouter，或需要提供商路由控制，或希望用一个账户、一张账单覆盖你运行的所有 AI 工具时，就选 OpenRouter。它对购买额度收取 5.5% 的费用，且不对提供商加价；BYOK 允许你通过自己的提供商密钥进行路由，在按套餐提供的免费额度之后，按等效 OpenRouter 成本的 5% 收费；当前详情请见定价页面。

Kilo Gateway 是原生路径：Kilo 将其宣传为零加价，账单计入你的 Kilo 账户，路由由 Kilo 管理。如果 Kilo Code 是你唯一的 AI 使用界面，并且它提供你所需的确切模型，那么在承担 OpenRouter 费用之前，先在 Kilo Gateway 中比较该模型。这主要取决于账户归属。如果 OpenRouter 已经存在于你的技术栈中，就把它添加到 Kilo 并保持一套路由策略。

常见问题

OpenRouter 与 Kilo Code 一起使用是免费的吗？

部分免费。OpenRouter 有 20 多个免费模型，可在 Kilo Code 内使用，在未充值额度的情况下限制为每天 50 次请求、每分钟 20 次。充值 10 美元或更多额度后，免费模型的上限会提高到每天 1,000 次请求。Kilo 自有的 kilo-auto/free 选项是独立的，通过 Kilo Gateway 运行。

Kilo Code 和 OpenRouter 有什么区别？

Kilo Code 是在你的编辑器或终端中运行的编码代理。OpenRouter 是你在 Kilo Code 内添加的提供商，可通过一个 API 密钥访问来自 70 多家提供商的 300 多个模型。你将它们一起使用。

如何在 Kilo Code 中设置 OpenRouter 提供商顺序？

在 kilo.json 中的 models.{modelId}.options.provider 下添加一个 order 数组，按偏好顺序列出提供商名称，例如 ["Anthropic", "Google"]。添加 only 可将请求限制在已批准的列表中。Kilo 会将这些字段转发给 OpenRouter，而不对其进行验证。

OpenRouter 比 Kilo 自己的网关更贵吗？

OpenRouter 对购买额度收取 5.5% 的费用，且不对提供商价格加价。Kilo 将 Kilo Gateway 宣传为零加价。当你已在多个工具中使用 OpenRouter 或需要提供商路由控制时，OpenRouter 通常是更好的运营选择。

我可以在 Kilo CLI 中使用 OpenRouter 吗？

可以。CLI 读取相同的 kilo.json 配置，因此你可以直接添加 OpenRouter 提供商块和路由选项。VS Code 的 Providers 标签页会写入同一个文件。