# Kilo Code

Source: https://docs.aiand.com/ja/integrations/kilo-code/

[Kilo Code](https://kilo.ai) は、VS Code、JetBrains、ターミナルで利用できるオープンソースのコーディングエージェントです。ai& を custom OpenAI-compatible provider として登録すると、すべての環境で同じモデルと設定を使えます。

<Aside type="note">
  リポジトリ全体を扱う agent task には `zai-org/glm-5.3`、低コストで高速な反復には
  `deepseek-ai/deepseek-v4-flash` を推奨します。どちらも tool calling に対応しています。
</Aside>

## 前提条件

- [VS Code](https://marketplace.visualstudio.com/items?itemName=kilocode.Kilo-Code)、[JetBrains](https://plugins.jetbrains.com/plugin/28350-kilo-code)、または CLI 版の Kilo Code
- [ai& API キー](https://console.aiand.com/api-keys)

## VS Code と JetBrains

1. Kilo Code の設定を開きます:
   - **VS Code:** Kilo Code sidebar の gear icon をクリックする。
   - **JetBrains:** **Settings → Tools → Kilo Code** を開く。
2. **Providers** を開き、一番下の **Custom provider** を選びます。
3. 次の値を入力します:

   | 設定         | 値                         |
   | ------------ | -------------------------- |
   | Provider ID  | `aiand`                    |
   | Display name | `ai&`                      |
   | Provider API | **OpenAI Compatible**      |
   | Base URL     | `https://api.aiand.com/v1` |
   | API key      | ai& API キー               |

4. 取得された一覧からモデルを選ぶか、[モデルカタログ](/ja/models/catalog/) の ID を入力します。
5. provider を保存し、Kilo の model picker で `aiand/<model-id>` を選びます。

<Aside type="caution">
  `/v1` を省略しないでください。Kilo はこの URL に `/chat/completions` を追加し、 `/models`
  からモデルを取得します。
</Aside>

## CLI

Kilo をインストールします:

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

API キーを設定します:

<Tabs syncKey="os">
<TabItem label="macOS / Linux">

```bash
export AIAND_API_KEY="sk-your-aiand-api-key"
```

</TabItem>
<TabItem label="Windows (PowerShell)">

```powershell
$env:AIAND_API_KEY = "sk-your-aiand-api-key"
```

</TabItem>
</Tabs>

global config `~/.config/kilo/kilo.jsonc` を作成します:

```jsonc
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/zai-org/glm-5.3",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:AIAND_API_KEY}",
        "baseURL": "https://api.aiand.com/v1",
      },
      "models": {
        "zai-org/glm-5.3": {
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": {
            "context": 1048576,
            "output": 131072,
          },
        },
        "deepseek-ai/deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash",
          "tool_call": true,
          "reasoning": true,
          "limit": {
            "context": 1048576,
            "output": 384000,
          },
        },
      },
    },
  },
}
```

<Aside type="caution">
  `{env:AIAND_API_KEY}` は global config に記述してください。Kilo は、悪意ある
  repository が任意の endpoint に secret を送信できないように、project-level
  `kilo.jsonc` 内の環境変数参照を無効にします。
</Aside>

対話型の terminal UI を起動します:

```bash
kilo
```

one-shot task も実行できます:

```bash
kilo run --auto -m openai-compatible/zai-org/glm-5.3 "このリポジトリを確認して、失敗しているテストを修正してください"
```

## 動作確認

設定した provider とモデルが Kilo から見えるか確認します:

```bash
kilo models openai-compatible
kilo run --auto -m openai-compatible/zai-org/glm-5.3 "reply with only: ok"
```

## トラブルシューティング

- **モデルが読み込まれない** — Base URL が `https://api.aiand.com/v1` と完全に一致しているか確認し、API キーを再入力してください。
- **Unauthorized request** — [ai& console](https://console.aiand.com/api-keys) で新しいキーを作成し、provider または `AIAND_API_KEY` を更新してください。
- **CLI が `AIAND_API_KEY` を認識しない** — `{env:AIAND_API_KEY}` は project config ではなく global config に記述してください。
- **応答は返るが file を編集できない** — [カタログ](/ja/models/catalog/) で `tool_calling` 対応モデルを選び、Kilo の確認画面で file tool を許可してください。
- **context usage が表示されない、または compaction が動かない** — [カタログ](/ja/models/catalog/) の `limit.context` と `limit.output` を `kilo.jsonc` のモデル設定に追加してください。