Kilo Code 接入
在 VS Code 的 Kilo Code 扩展里用 QCode.cc:选 Anthropic provider + 勾选自定义 base URL,即可用 Claude
Kilo Code 接入¶
Kilo Code 是 VS Code 的开源 AI 编程扩展。它是 Roo Code 的 fork,而 Roo Code 又 fork 自 Cline——三者的设置界面高度相似,本页的做法在它们之间基本通用。
走哪条腿¶
| 你想用的模型 | API Provider | Base URL |
|---|---|---|
| Claude | Anthropic |
https://api.qcode.cc/api |
| GPT 系 / 国产四家族 | OpenAI Compatible |
https://api.qcode.cc/openai/v1 |
🔴 不要用 OpenAI Compatible 去调 Claude——QCode 的 OpenAI 端点不接受 Claude 模型,会返回
model_not_available_on_endpoint。详见 接入点与 API 格式。
安装¶
在 VS Code 扩展市场搜索 Kilo Code 安装,或从 官网 按指引安装。
配置 Claude(Anthropic provider)¶
- 点开 Kilo Code 侧边栏的设置(齿轮图标)
- API Provider 下拉选 Anthropic
- API Key 填你的 QCode 密钥(
cr_开头) - 勾选 Use custom base URL,填
https://api.qcode.cc/api - 在模型下拉里选
claude-sonnet-5(或其它在售 id) - 保存后在聊天框发一句话验证
中国大陆把域名换成
https://asia.qcode.cc/api(香港节点),Key 不变。 base URL 末尾不要带斜杠——扩展会自己拼/v1/messages,多一个斜杠会 404。
配置 GPT 与国产模型(OpenAI Compatible)¶
- API Provider 选 OpenAI Compatible
- Base URL 填
https://api.qcode.cc/openai/v1 - API Key 同一把
cr_密钥 - Model ID 填
gpt-5.5、gpt-5.6-terra,或 国产 id 如glm-5.2
验证连通¶
先用 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 说明端点侧没问题;此时若扩展仍失败,问题在界面配置。
常见问题¶
| 现象 | 原因 | 处理 |
|---|---|---|
model_not_available_on_endpoint |
用 OpenAI Compatible 调 Claude | 改用 Anthropic provider + /api |
Invalid API key |
密钥错或带空格 | 确认 cr_ 开头、无前后空格 |
| 404 | base URL 末尾带了斜杠或路径写错 | 对照上文表格 |
| 模型下拉里没有想要的 id | 扩展的内置清单未收录 | 用「自定义模型 id」输入框手填 |
相关文档¶
- 接入点与 API 格式 — 协议 × 模型家族真源表
- Roo Code 接入 — 上游项目,配置几乎相同
- Cline 集成 — 更上游的项目
- 国产模型接入