Kilo Code 接入

在 VS Code 的 Kilo Code 扩展里接 QCode.cc：Settings → Providers → Custom provider，Provider API 选 Anthropic Messages 就能用 Claude

最后核实：2026-09-18 · 📄 依据官方文档（Kilo Code 扩展；文档见 kilo.ai）

⚠️ 归属与界面变化：2026-07-15，Anaconda 宣布收购 Kilo Code。此后 Kilo 的自定义端点入口已经改版：不再是 Roo Code 那种「API Provider 下拉 + 勾选 Use custom base URL」，而是 Settings → Providers 标签 → Custom provider 对话框（官方 anthropic 与 openai-compatible 两页逐字写明）。本页步骤按新界面写。

接入速览¶

Kilo Code 是 VS Code 的开源 AI 编程扩展。它是 Roo Code 的 fork，而 Roo Code 又 fork 自 Cline——代码同源，界面已经分叉：Kilo 用的是 Providers 标签里的 Custom provider 对话框，Roo Code 与 Cline 仍是 API Provider 下拉。本页的步骤不能直接照搬到那两个工具，各自看自己的页面。

走哪条腿¶

🔴 不要用 OpenAI Compatible 去调 Claude——QCode 的 OpenAI 端点不接受 Claude 模型，会返回 model_not_available_on_endpoint。官方文档也把 Anthropic 与 MiniMax 归到 Anthropic Messages 这一档。

安装¶

在 VS Code 扩展市场搜索 Kilo Code 安装，或从 官网 按指引安装。

配置 Claude（Custom provider）¶

1. 点开 Kilo Code 侧边栏的设置（齿轮图标），进 Providers 标签
2. 拉到最底部，点 Custom provider
3. 在弹出的对话框里按字段填：

1. 点 Submit 保存，模型即出现在 model picker 里
2. 在聊天框发一句话验证

中国大陆把域名换成 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 如 glm-5.2

想用 GPT / xAI 的 Responses 风格接口时，官方给的取值是 OpenAI Responses；Anthropic 模型仍然只能用 Anthropic Messages（Base URL https://api.qcode.cc/api），两条腿不能混用。

验证连通¶

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

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 说明端点侧没问题；此时若扩展仍失败，问题在界面配置。

常见问题¶

相关文档¶

• 接入点与 API 格式 — 协议 × 模型家族真源表
• Roo Code 接入 — 上游项目，配置几乎相同
• Cline 集成 — 更上游的项目
• 国产模型接入