> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aisonar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Kilo Code

> 将 Kilo Code 和 Kilo CLI 连接到 AI Sonar

## 概述

<Note>
  **类型**：IDE 与 CLI 编码 Agent

  **主要路径**：OpenAI 兼容 Chat Completions

  **支持级别**：官方自定义提供商路径
</Note>

[Kilo Code](https://kilo.ai/docs/ai-providers/openai-compatible) 的 VS Code 扩展和 Kilo CLI 都支持自定义 OpenAI 兼容提供商。

## 安装

在 VS Code 扩展市场安装 **Kilo Code** 的预发布通道，或安装 CLI：

```bash theme={null}
npm install -g @kilocode/cli
kilo --version
```

## 在界面中配置

打开 **Settings → Providers → Custom provider**：

| 字段           | 值                            |
| ------------ | ---------------------------- |
| Provider ID  | `aisonar`                    |
| Display name | `AI Sonar`                   |
| Provider API | **OpenAI Compatible**        |
| Base URL     | `https://api.aisonar.dev/v1` |
| API key      | 你的 AI Sonar API Key          |
| Model        | `kimi-k3`                    |

Kilo 会从 AI Sonar 的 `/v1/models` 自动发现模型。保存后选择 `aisonar/kimi-k3`。

## 配置 CLI

先设置环境变量，再把配置写入受信任的全局文件 `~/.config/kilo/kilo.jsonc`：

```bash theme={null}
export API_KEY="sk-your-api-key"
```

```jsonc theme={null}
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/kimi-k3",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:API_KEY}",
        "baseURL": "https://api.aisonar.dev/v1"
      },
      "models": {
        "kimi-k3": {
          "name": "Kimi K3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 131072 }
        }
      }
    }
  }
}
```

重启后运行 `kilo models` 验证。`{env:...}` 仅在受信任的全局或托管配置中解析，不要把真实 Key 写入可能提交到 Git 的项目配置。