# Kilo CLI

> 在 Kilo CLI 中使用平台的模型：安装、kilo.json 中的服务商配置、上下文窗口与模型选择。

来源：https://www.scirouter.cn/docs/kilo-cli · 更新于 2026-10-24

Kilo CLI 是 Kilo Code 的命令行版本，通过 OpenAI Chat Completions 格式（`POST /v1/chat/completions`）调用平台的模型。配置前先完成[编程工具概览](https://www.scirouter.cn/docs/coding-tools)「准备」中的三步。

## 安装

```bash
npm install -g @kilocode/cli
kilo --version
```

输出版本号表示安装成功。

## 配置

在配置文件中添加 SciRouter 作为服务商：

| 范围 | 文件路径 |
|---|---|
| 全局（macOS / Linux） | `~/.config/kilo/kilo.json`（也可命名为 `kilo.jsonc`） |
| 全局（Windows） | `C:\Users\<用户名>\.config\kilo\kilo.json` |
| 单个项目 | 项目根目录的 `kilo.json` |

文件不存在时新建。写入以下内容，将 `YOUR_MODEL_ID` 换成平台的模型 id，`limit` 按该模型的上下文窗口与输出上限填写（见[模型中心](https://www.scirouter.cn/models)的详情页）：

```json
{
  "provider": {
    "scirouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SciRouter",
      "env": ["SCIROUTER_API_KEY"],
      "options": {
        "baseURL": "https://api.scirouter.cn/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID",
          "limit": { "context": 128000, "output": 16384 }
        }
      }
    }
  }
}
```

`limit` 中的数值为示例。

| 字段 | 取值 | 说明 |
|---|---|---|
| `provider` 下的键 | `scirouter` | 服务商 id，可自定义；`/models` 中按它分组 |
| `npm` | `@ai-sdk/openai-compatible` | 使用 Chat Completions 格式 |
| `env` | `["SCIROUTER_API_KEY"]` | 从该环境变量读取 Key，Key 不写入配置文件 |
| `options.baseURL` | `https://api.scirouter.cn/v1` | 带 `/v1` |
| `models` 下的键 | 平台的模型 id | 每个要用的模型一项，可写多项 |
| `models.*.limit.context` / `limit.output` | 整数 | 上下文窗口与输出上限。**不写时按 0 处理**，Kilo 无法管理上下文 |

## 使用

```bash
cd my-project
kilo
```

输入 `/models`，在 SciRouter 分组下选择模型，发送一条消息，收到回答即接入成功。修改配置文件后重新启动 Kilo CLI。