# Kilo CLI

來源: https://docs.aicentos.com/zh-TW/clients/kilo-cli

Language: zh-TW

> 在 Kilo 命令列工具中透過設定檔接入 aicentos

Kilo CLI 透過一份 JSON / JSONC 設定檔宣告 Provider 與模型，支援用 `@ai-sdk/openai-compatible` 指向任意 OpenAI 相容端點，因此可以直接接入 aicentos。

## 準備工作

先在控制台「API Key」頁面為命令列建立一個專用 Key（建議命名 `kilo-cli`）。

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

同時確認已全域安裝 Kilo CLI：

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

## 需要填寫的設定

| 欄位                               | 值                                      |
| -------------------------------- | -------------------------------------- |
| Provider 套件（`npm`）               | `@ai-sdk/openai-compatible`            |
| `options.baseURL`                | `https://aicentos.com/v1`              |
| `options.apiKey`                 | 控制台建立的 Key（可用 `{env:VAR}` 引用）          |
| 模型引用（頂層 `model`）                 | `provider/model` 形式，如 `aicentos/gpt-5` |
| `limit.context` / `limit.output` | 按所選模型填寫                                |

## 設定步驟

* 新建或編輯全域設定檔：
  * `~/.config/kilo/kilo.json`（或 `kilo.jsonc`）；設定了 `XDG_CONFIG_HOME` 時以該目錄為準。
  * 專案級 `./kilo.jsonc` 會覆蓋全域設定的同名項。
* 寫入以下內容：

```json
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicentos/gpt-5",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:AICENTOS_API_KEY}"
      },
      "models": {
        "gpt-5": {
          "name": "GPT-5",
          "limit": { "context": 128000, "output": 16384 }
        }
      }
    }
  }
}
```

* 匯出環境變數：

```bash
export AICENTOS_API_KEY="sk-你的aicentos密钥"
```

* 在專案目錄下執行 `kilo`，或在互動介面裡用 `/model` 切換模型。

## 測試

啟動後先用一句簡單提示詞輕量測試，確認能正常回傳結果再正式使用。

## 注意事項

* `options.baseURL` 只填到 `https://aicentos.com/v1`，不要補成完整的 `/v1/chat/completions`。
* `{env:VAR}` 這套環境變數替換語法**只在全域設定檔中生效**；專案級 `kilo.jsonc` 出於安全考慮不會解析 `{env:...}`。
* 自訂模型必須顯式宣告 `limit.context` 與 `limit.output`，否則上下文長度按 0 處理，自動壓縮會失效。
* 如果閘道不提供 `/v1/models` 清單介面，自動探測模型會失敗，按上面的寫法手動宣告即可。
* 更多說明見文件站：[https://docs.aicentos.com](https://docs.aicentos.com)