# 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 又 fork 自 [Cline](/docs/ide/cline)——**代码同源，界面已经分叉**：Kilo 用的是 Providers 标签里的 Custom provider 对话框，Roo Code 与 Cline 仍是 API Provider 下拉。本页的步骤**不能**直接照搬到那两个工具，各自看自己的页面。

## 走哪条腿

| 你想用的模型 | Provider API | Base URL |
|---|---|---|
| Claude | `Anthropic Messages` | `https://api.qcode.cc/api` |
| GPT 系 / 国产四家族 | `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** 安装，或从 [官网](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`（亚洲节点，韩国 / 台湾 / 香港就近），Key 不变。
> 官方 Base URL 的示例一律写成带版本段的形态（如 `https://api.your-provider.com/v1`），并说 Kilo 会在有效地址上
> 自动抓取模型列表；对 Anthropic Messages 这条腿，我们建议填到 `/api` 为止，由扩展自己拼 `/v1/messages`。
> 末尾**不要带斜杠**。是否会因多余斜杠直接 404，我们**未实测**，按建议写法走即可。
> 界面上的设置会存进配置文件（官方文档两处分别写作 `kilo.json` 与 `kilo.jsonc`），也可以直接改文件。
## 配置 GPT 与国产模型（OpenAI Compatible）

同一个 **Custom provider** 对话框，只改两个字段：

1. **Provider API** 选 **OpenAI Compatible**
2. **Base URL** 填 `https://api.qcode.cc/openai/v1`
3. **API key** 同一把 `cr_` 密钥
4. **Models** 手填 `gpt-6-sol`、`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`），两条腿不能混用。
## 验证连通

先用 curl 确认端点与密钥没问题，再回扩展里排查界面配置：

```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 | 扩展的内置清单未收录 | 用「自定义模型 id」输入框手填 |

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — 协议 × 模型家族真源表
- [Roo Code 接入](/docs/ide/roo-code) — 上游项目，配置几乎相同
- [Cline 集成](/docs/ide/cline) — 更上游的项目
- [国产模型接入](/docs/usage/cn-models)