# Kilo CLI

出典: https://docs.aicentos.com/ja/clients/kilo-cli

Language: ja

> Kilo コマンドラインツールで設定ファイルを使って aicentos に接続する

Kilo CLI は JSON / JSONC の設定ファイルで Provider とモデルを宣言し、`@ai-sdk/openai-compatible` で任意の OpenAI 互換エンドポイントに接続できるため、aicentos に直接接続できます。

## 準備

まずコンソールの「API Key」ページで CLI 用の専用キーを作成します（名前は `kilo-cli` がおすすめです）。

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[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`                 | コンソールで作成したキー（`{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)