---
url: https://limapi.com/docs/agents/kilo-cli.md
---
# Kilo CLI

Kilo CLI 是 Kilo Code 的命令行客户端，在终端中提供 AI 编程、代码审查与 Agent 能力，通过 OpenAI 兼容端点接入 LimAPI。

## 安装 Kilo CLI

1. 安装 Node.js（v18.0 或更高版本）。
2. 在终端中执行以下命令安装 Kilo CLI：

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

3. 验证安装，输出版本号即表示安装成功：

```bash
kilo --version
```

## 配置接入凭证

使用文本编辑器打开（或新建）配置文件 `~/.config/kilo/config.json`，写入以下配置。将 `YOUR_API_KEY` 替换为 [Portal](https://limapi.com/) 创建的 API Key：

```json
{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "limapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LimAPI",
      "options": {
        "baseURL": "https://limapi.com/api/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "qwen3.8-max": {
          "name": "Qwen3.8 Max",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        }
      }
    }
  }
}
```

::: tip 添加更多模型
如需使用其他模型，在 `models` 中以相同格式追加即可。完整模型列表见 [模型列表](/guide/models)。
:::

## 验证配置

保存配置后，重启 Kilo CLI，输入 `/models`，搜索 **LimAPI**，选择需要使用的模型即可开始对话。

更多使用技巧及常见命令请参考 Kilo Code 官方文档。

## 常见问题

### 报错 401 / 认证失败

* 确认 `apiKey` 为 Portal 创建的 `sk-` 开头密钥；
* 确认 `baseURL` 为 `https://limapi.com/api/v1`，末尾 `/v1` 不可省略。

### 模型不在 /models 列表中

检查 `config.json` 是否为合法 JSON（可用 `cat ~/.config/kilo/config.json | python3 -m json.tool` 校验），修改后需重启 Kilo CLI。