Kilo CLI 接入 NixAPI：自定义模型与全局配置教程

Kilo 提供终端 CLI 和编辑器扩展。本文使用 Kilo CLI 1.0 及之后版本的自定义模型配置方式，按 2026 年 10 月 30 日的官方 CLI 文档整理。配置基于官方兼容接口说明，实际调用需要用你的 NixAPI Key 与模型验证。

1. 安装 CLI

准备 Node.js 与 npm 后，执行官方安装命令：

npm install -g @kilocode/cli

创建 NixAPI API Key，并从官网模型定价页复制支持工具调用的聊天模型 ID。

2. 设置密钥环境变量

macOS / Linux：

export NIXAPI_API_KEY='YOUR_NIXAPI_API_KEY'

Windows PowerShell：

$env:NIXAPI_API_KEY = 'YOUR_NIXAPI_API_KEY'

替换占位 Key，再从当前终端启动 Kilo。

3. 写入全局 kilo.json

编辑用户级 ~/.config/kilo/kilo.json，文件已存在时合并下面的 Provider 配置。使用全局配置是因为当前 {env:VAR} 插值要求受信任配置；普通仓库内的 kilo.json 不能照搬此密钥读取方式。官方自定义模型说明记录了这个区别。

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "nixapi/NIXAPI_MODEL_ID",
  "provider": {
    "nixapi": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.nixapi.com/v1",
        "apiKey": "{env:NIXAPI_API_KEY}"
      },
      "models": {
        "NIXAPI_MODEL_ID": {
          "name": "NixAPI coding model",
          "tool_call": true,
          "limit": { "context": 32768, "output": 4096 }
        }
      }
    }
  }
}

同时替换两处 NIXAPI_MODEL_ID。32768 与 4096 是配置结构示例，必须调整为真实上下文与最大输出限制；tool_call: true 是能力声明，不能让不支持工具调用的模型获得这项能力。

Kilo 的字段是 baseURL，与 Pi 的 baseUrl 大小写不同；密钥插值也是 {env:NIXAPI_API_KEY}，不是 ${NIXAPI_API_KEY}。Provider 配置依据官方 OpenAI Compatible 文档。

4. 确认模型并试运行

先查看配置后的模型列表，再启动：

kilo models
kilo

在一个含 package.json 的测试项目中，先要求只返回一句确认文字，再发送：

读取当前项目的 package.json，概括 scripts 中可用的命令。暂时不要修改文件或执行命令。

检查实际的文件读取与工具返回，不要只看助手是否输出了“配置成功”。随后再尝试一次可撤销的小修改，并检查 diff。

5. 编辑器版与常见问题

如果更习惯 VS Code，可以使用 Kilo 官方扩展中的自定义提供商：选 OpenAI Compatible，填相同的 Base URL、Key 和模型 ID。扩展设置与 CLI 配置分别核对，不要假定一个界面的设置会自动写入另一个。

• 模型列表没有 NixAPI：检查全局配置路径、JSON 格式和 provider.nixapi.models。
• 401：检查当前终端的变量以及配置是否位于受信任的全局位置。
• 上下文或输出限制异常：核对 limit.context 和 limit.output，不要将示例数字当成模型规格。
• 文字回复正常但工具失败：核对模型的工具调用、流式输出与 Chat Completions 支持；保留错误信息后再按官方说明调整兼容选项。