Kilo CLI

Kilo CLI 是终端 AI 编程 Agent。它支持自定义 OpenAI 兼容 Provider；由于 ModelGo CLI 尚未提供官方自动配置，本文采用 Kilo 的 /connect 与配置文件方式。

接入前准备

• 已安装 Node.js 18+。
• 已在 ModelGo 控制台创建 API Key。
• 已在模型广场确认逻辑模型名。

1. 安装 Kilo CLI

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

进入项目目录后运行 kilo，首次启动可使用 /connect 添加 Provider。

2. 添加 ModelGo Provider

在项目根目录创建 kilo.jsonc（或编辑全局配置），加入 OpenAI 兼容 Provider：

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "modelgo/你的模型名",
  "provider": {
    "modelgo": {
      "options": {
        "apiKey": "{env:MODELGO_API_KEY}",
        "baseURL": "https://api.modelgo.com/v1"
      },
      "models": {
        "你的模型名": {
          "name": "ModelGo / 你的模型名",
          "tool_call": true
        }
      }
    }
  }
}

export MODELGO_API_KEY="sk-你的token"

也可以在 TUI 中选择 /connect → OpenAI Compatible，填写同样的 Base URL、API Key 和模型 ID。

3. 验证配置

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"
kilo

在模型选择器中选中 ModelGo 模型，发送一条只读任务确认连接。

常见问题

Provider 没有出现在选择器

检查 kilo.jsonc 的 JSONC 格式、Provider ID 和 model 路径，并重新启动 Kilo。

401 或 404

确认 MODELGO_API_KEY 已导出，baseURL 为 https://api.modelgo.com/v1，不要填写完整接口路径。

相关文档

• 首次调用：创建 API Key、查询模型并验证 ModelGo 接口。
• Kilo CLI 官方文档：查看安装、/connect 和 CLI 命令。
• Kilo 自定义模型：查看 OpenAI Compatible Provider 字段和模型格式。