跳转到主要内容
Kilo Code 是一个开源 AI 编码 agent，可在 VS Code、JetBrains、CLI、Slack 和 Cloud 中使用。它通过自己的 Custom provider（自定义提供方）（一个 OpenAI 兼容端点）连接到 OrcaRouter。本指南同时介绍 VS Code 扩展（使用 Kilo Code 最常见的方式）和 CLI （@kilocode/cli，用于无界面场景）。
协议：OpenAI 兼容
  • Base URL： https://api.orcarouter.ai/v1（保留 /v1）
  • 模型 ID 使用 vendor/model 格式——最简单的是 orcarouter/auto

​
VS Code 扩展

  1. 从 VS Code Marketplace 安装 Kilo Code（打开扩展面板 并搜索 “Kilo Code”），然后从 Activity Bar（活动栏）中的 Kilo Code 图标 （左侧的图标栏）打开它。在面板中，点击右上角的 ⚙ 齿轮打开设置。
高亮显示设置齿轮的 Kilo Code 面板
  1. 进入 Providers（提供方）。在 **Popular providers（常用提供方）**下，找到 Custom provider（自定义提供方） （“Add an OpenAI-compatible provider by base URL”），点击 + Connect。
Kilo Code 的 Providers 设置中的 Custom provider 条目
  1. 填写 provider 字段：
    • Provider ID：orcarouter（仅限小写字母、数字、连字符或 下划线——不能有斜杠；orcarouter/auto 在此处会被拒绝）。
    • Display name：OrcaRouter（任意填写）。
    • Base URL：https://api.orcarouter.ai/v1
    • API key：你的 OrcaRouter 密钥（sk-orca-...）。
Kilo Code 中的 OrcaRouter provider ID、base URL 和 API key
  1. 选择你的模型。密钥和 base URL 有效后，Kilo Code 会从 OrcaRouter 拉取实时模型列表——勾选你想要的（或点击 Select all）， 然后点击 Submit。要使用自动路由，还需通过 + Add model 添加 模型 ID orcarouter/auto（它是一个路由别名，因此不会出现在 拉取到的列表中）。
显示从 OrcaRouter 拉取的模型的 Kilo Code 模型选择器
  1. 该 provider 现在会显示在 **Connected providers（已连接提供方）**下，名为 OrcaRouter (CUSTOM)。
在 Kilo Code 的 Connected providers 下列出的 OrcaRouter
  1. 在聊天面板的模型选择器中选择 OrcaRouter 模型，发送一条 测试消息——收到回复即确认连接成功。
Kilo Code 通过 OrcaRouter 回复
在大型仓库中，Kilo Code 可能会先询问是否等待其快照 系统初始化——选择 Disable for this project（为此项目禁用）即可跳过它（git 仍会 跟踪一切），让请求顺利通过。
JetBrains 插件使用相同的 Custom provider（自定义提供方），且 base URL / 密钥 / 模型值 完全一致。

​
CLI

对于无界面 / 脚本化场景，请安装 CLI。

​
安装

npm install -g @kilocode/cli
命令为 kilo。

​
配置

配置文件：~/.config/kilo/kilo.jsonc（也接受 kilo.json；项目级 ./kilo.jsonc 会覆盖它）。 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
如果你愿意，也可以换成某个具体模型，例如 anthropic/claude-opus-4.8 或 google/gemini-2.5-flash。模型 ID 使用 vendor/model 格式。

​
运行

echo "Reply with exactly: OK" | kilo run --auto --format json
预期结果：一个带有 "type":"text" 和 "text":"OK" 的 JSON 事件。

​
注意事项

  • base_url 保留 /v1。
  • 模型引用使用 provider/model。由于该 provider 名为 orcarouter 且模型 ID 本身也带有 vendor 前缀，因此该引用是三段式：orcarouter/orcarouter/auto（或 orcarouter/anthropic/claude-opus-4.8）。
  • 无界面模式为 kilo run "<prompt>" --auto（或通过 stdin 管道传入 prompt）。--format json 提供机器可读的事件流。
  • 推理 / 思考： 用 --variant <name> 标志设置特定 provider 的推理 effort（例如 high、max、minimal），用 --thinking 显示思考块。
已知问题： --auto 有在完成后 / 缺少密钥时挂起的报告案例 （kilocode issues）。在 CI 中用 timeout 包裹，并确保已加载密钥。