# Kilo Code 接続

> **最終確認**：2026-09-18 · 📄 公式ドキュメント準拠（Kilo Code 拡張、ドキュメントは kilo.ai）

> **⚠️ 帰属と画面が変わりました**：2026-07-15 に [Anaconda による Kilo Code の買収が発表され](https://www.anaconda.com/press/anaconda-acquires-kilo-code)、以降 Kilo のカスタムエンドポイント設定は**刷新されています**。Roo Code 式の「API Provider ドロップダウン + Use custom base URL のチェック」ではなく、Settings → **Providers** タブ → **Custom provider** ダイアログになりました（公式の [anthropic](https://kilo.ai/docs/ai-providers/anthropic) ページと [openai-compatible](https://kilo.ai/docs/ai-providers/openai-compatible) ページに逐語で記載）。以下は新しい画面に沿った手順です。

## 概要

| 項目 | 内容 |
|---|---|
| 利用できるモデル | Claude ✅（**Provider API = Anthropic Messages**）· GPT ✅ · 中国系モデル ✅（**Provider API = OpenAI Compatible**）· Gemini ❌（本ページは Gemini 接続を扱わない） |
| プロトコルと Base URL | Anthropic：`https://api.qcode.cc/api` · OpenAI：`https://api.qcode.cc/openai/v1` |
| 設定場所 | 拡張の設定（ギアアイコン）→ **Providers** タブ → 一番下の **Custom provider** ダイアログ |
| 公式ドキュメント | [kilo.ai](https://kilo.ai) |

[Kilo Code](https://kilo.ai) は VS Code 向けのオープンソース AI コーディング拡張です。[Roo Code](/docs/ide/roo-code) の fork で、Roo Code は [Cline](/docs/ide/cline) の fork です。**出自は同じでも画面は別物**になりました：Kilo は Providers タブの Custom provider ダイアログ方式、Roo Code と Cline は今も API Provider ドロップダウン方式です。本ページの手順をあの 2 つにそのまま持ち込まないでください。

## どのプロトコルを使うか

| 使いたいモデル | Provider API | Base URL |
|---|---|---|
| Claude | `Anthropic Messages` | `https://api.qcode.cc/api` |
| GPT 系・中国系 4 ファミリー | `OpenAI Compatible` | `https://api.qcode.cc/openai/v1` |
| GPT / xAI を Responses 方式で | `OpenAI Responses` | [接続点と API 形式](/docs/getting-started/endpoints-and-api-paths) を参照 |

🔴 **OpenAI Compatible で Claude を呼ばないでください** —— QCode の OpenAI エンドポイントは Claude を
`model_not_available_on_endpoint` で拒否します。公式文書でも Anthropic と MiniMax は
**Anthropic Messages** の側に置かれています。
## インストール

VS Code のマーケットプレイスで **Kilo Code** を検索するか、[kilo.ai](https://kilo.ai) の案内に従ってください。

## Claude の設定（Custom provider）

1. Kilo Code のサイドバーで**設定**（ギアアイコン）を開き、**Providers** タブへ進む
2. 一番下までスクロールして **Custom provider** をクリック
3. ダイアログに各項目を入力する：

   | 項目 | 入力内容 |
   |---|---|
   | **Provider ID** | 一意の識別子、例 `qcode` |
   | **Display name** | 画面に表示される名前、自由に付けてよい |
   | **Provider API** | Claude なら **Anthropic Messages** |
   | **Base URL** | `https://api.qcode.cc/api` |
   | **API key** | あなたの QCode キー（`cr_` 始まり）|
   | **Models** | 直接入力、または自動取得された一覧から選択（例 `claude-sonnet-5`）|
   | **Headers** | 省略可、カスタム HTTP ヘッダーを鍵と値で追加 |

4. **Submit** を押すと保存され、model picker にモデルが現れます
5. チャットでひとこと送信して確認します

> **中国本土**ではホストを `https://asia.qcode.cc/api`（アジアノード、韓国 / 台湾 / 香港付近）に置き換えてください。キーは共通。
> 公式の Base URL 例はバージョン段付きの形（`https://api.your-provider.com/v1` のような表記）で統一されており、
> Kilo は有効なアドレスからモデル一覧を自動取得します。Anthropic Messages の経路では `/api` までにして、
> 拡張に `/v1/messages` を補完させる形を推奨します。末尾に**スラッシュを付けない**でください。
> 余分なスラッシュが実際に 404 を返すかどうかは当社で**未検証**なので、推奨する形に従ってください。
> 画面の設定は設定ファイル（公式文書では一方が `kilo.json`、もう一方が `kilo.jsonc` と表記）に保存され、直接編集もできます。
## GPT と中国系モデルの設定（OpenAI Compatible）

同じ **Custom provider** ダイアログで、変わる項目は 2 つだけです：

1. **Provider API** を **OpenAI Compatible** にする
2. **Base URL** に `https://api.qcode.cc/openai/v1` を入力
3. **API key** は同じ `cr_` キー
4. **Models** に `gpt-6-sol`、`gpt-6-luna`、`gpt-5.6-terra`、または[中国系 id](/docs/usage/cn-models) の `glm-5.2` などを入力

GPT / xAI を Responses 方式で使う場合の公式の取值は **OpenAI Responses** です。Anthropic モデルは引き続き
Anthropic Messages（Base URL `https://api.qcode.cc/api`）のみで、2 つの経路は混用できません。
## 疎通確認

まず curl でエンドポイントとキーを確認し、拡張の UI を疑うべきか切り分けます：

```bash
KEY="cr_あなたのQCodeキー"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

`content` を含む JSON が返ればエンドポイント側は正常です。それでも拡張が失敗するなら設定側の問題です。

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

| 症状 | 原因 | 対処 |
|------|------|------|
| `model_not_available_on_endpoint` | OpenAI Compatible で Claude を呼んでいる | Anthropic provider + `/api` に変更 |
| `Invalid API key` | キー誤りまたは空白混入 | `cr_` 始まりで前後に空白がないか確認 |
| 404 | base URL 末尾のスラッシュ、パス誤り | 上表と照合 |
| 目的の id がモデル選択に無い | 拡張の内蔵リストに未収録 | カスタム model id 欄に直接入力 |

## 関連ドキュメント

- [エンドポイントと API パス](/docs/getting-started/endpoints-and-api-paths) — プロトコル × モデルファミリー対応表
- [Roo Code 接続](/docs/ide/roo-code) — 上流プロジェクト。設定はほぼ同じ
- [Cline 連携](/docs/ide/cline) — さらに上流
- [中国系モデル連携](/docs/usage/cn-models)