Kilo Code 接入 OpenRouter 实操：一把密钥调度 300+ 模型，kilo.json 路由配置与免费模型额度全解

一句话结论

Kilo Code 是自带编辑器和终端的编程智能体，负责会话、编辑、上下文、模式与模型选择，但不自带模型，需要用户自备 provider。接入 OpenRouter 后，一把 API 密钥即可调度 70+ 供应商的 300+ 模型，路由规则、故障转移与账单集中在一处。本文覆盖三步接入、kilo.json 路由控制、免费模型额度规则，以及 OpenRouter 与 Kilo Gateway 两条付费路径的选型依据。

三步接入 OpenRouter

Kilo Code 运行编程会话：聊天、编辑、上下文、模式、模型选择器都在编辑器或终端里。它不自带模型，期望用户带入 provider。

OpenRouter 就是这个 provider 层。加上它，Kilo 获得一把密钥访问 70+ 供应商的 300+ 模型，外加路由规则、故障转移和统一账单。Kilo 也提供自家托管计费路径 Kilo Gateway，后文对比。整个配置三步，路由控制都在一个配置文件里。

第一步，在 API Keys 页面创建密钥。用 Google 或 GitHub 登录。除非只用免费模型，先到定价页充值，按量付费无最低消费。

第二步，在 Kilo Code 里点齿轮图标打开 Settings，进 Providers 标签页，点 OpenRouter 的 Connect，粘贴密钥保存。

第三步，打开模型选择器，输入名称或 slug 切换模型。目录随供应商上新不断变化，实时列表浏览 openrouter.ai/models。

Kilo 把 provider 配置写入 kilo.json（或 ~/.config/kilo/kilo.json），VS Code 扩展和 CLI 共享同一配置。Providers 标签页会代你编辑该文件；CLI 用户可直接编辑。注意：存了密钥但没充值，第一个付费请求就会失败，测试付费模型前先充值。

用 kilo.json 控制路由与超长提示词

Kilo 把模型 options 下的任何内容原样转发给 OpenRouter（作为 providerOptions.openrouter），不做校验。正是这个透传机制，让 OpenRouter 的供应商路由在 Kilo 内可用。把 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 按价格、吞吐或延迟排序；order 设定供应商偏好顺序；only 限定白名单，宁可不发也不落到未批准供应商；data_collection 控制数据采集；zdr 开启零数据保留。

提示词超出模型上下文窗口时，OpenRouter 的 middle-out 变换从中间丢弃内容——模型注意力最低的位置——而不是拒绝请求。在同一个 options 块里开启：

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

在 Kilo 里跑免费模型

OpenRouter 有 20+ 免费模型。在 Kilo 的模型选择器里输入 free 即可筛选。未充值时，免费模型限每日 50 次请求、每分钟 20 次。充值 10 美元及以上，每日上限升至 1000 次。

两条免费路径要分清。OpenRouter 免费模型用你的 OpenRouter 账户和速率限制。Kilo 的 kilo-auto/free 走 Kilo Gateway，不占用 OpenRouter 额度也不受其路由规则约束。

私有代码有个注意事项：免费端点可能记录提示词，除非数据政策符合你的要求，否则不适合专有源代码。加 data_collection: “deny” 可收窄合格供应商范围。

OpenRouter 还是 Kilo Gateway

两者都把模型送到 Kilo Code 面前，选择取决于团队现有架构。

以下情况选 OpenRouter：已在多个工具间使用它、需要供应商路由控制、或想让一个账户一张账单覆盖所有 AI 工具。充值收 5.5% 手续费，无供应商加价；BYOK 让你用自己的供应商密钥路由，按 OpenRouter 等效成本收 5% 费用（有按套餐定的免费额度），当前细节见定价页。

Kilo Gateway 是原生路径：Kilo 宣传零加价，账单落在 Kilo 账户，路由由 Kilo 管理。如果 Kilo Code 是你唯一的 AI 界面且它正好有你需要的模型，先在 Kilo Gateway 比价再考虑 OpenRouter 的手续费。核心是账户引力：OpenRouter 已在你的技术栈里，就加到 Kilo 保持一个路由平面。

常见问题

OpenRouter 对 Kilo Code 免费吗？ 部分免费。OpenRouter 有 20+ 免费模型可在 Kilo Code 内使用，未充值时限每日 50 次、每分钟 20 次。充值 10 美元及以上，免费模型上限升至每日 1000 次。Kilo 自家的 kilo-auto/free 是独立路径，走 Kilo Gateway。

Kilo Code 和 OpenRouter 有什么区别？ Kilo Code 是跑在编辑器或终端里的编程智能体，OpenRouter 是加在 Kilo Code 内的 provider，用一把 API 密钥访问 70+ 供应商的 300+ 模型。两者配合使用。

如何在 Kilo Code 里设 OpenRouter 供应商顺序？ 在 kilo.json 的 models.{modelId}.options.provider 下加 order 数组，按偏好列出供应商名，如 [“Anthropic”, “Google”]。加 only 限定批准清单。Kilo 原样转发这些字段，不做校验。

OpenRouter 比 Kilo 自家网关贵吗？ OpenRouter 充值收 5.5% 费用，不加价供应商价格。Kilo 宣传 Kilo Gateway 零加价。已在多工具间用 OpenRouter 或需要供应商路由控制时，OpenRouter 通常是更好的运营选择。

Kilo CLI 能用 OpenRouter 吗？ 能。CLI 读同一个 kilo.json 配置，直接加 OpenRouter provider 块和路由选项即可。VS Code 的 Providers 标签页写的就是这个文件。

原文信息

• 作者：OpenRouter
• 发布时间：2026-06-17 原文地址：