Kilo Code 配置 Claude / GPT / 国产模型 API 指南
截至 2026-10-07，Kilo Code 接 Claude API 的配法是：设置 → Providers 标签 → 拉到最底部点 Custom provider，Provider API 选 Anthropic Messages，Base URL 填 https://api.qcode.cc/api（末尾不带斜杠），API key 填 cr_ 密钥，模型 ID 手填。GPT 与国产模型改选 OpenAI Compatible、Base URL 填 https://api.qcode.cc/openai/v1。本页按 QCode 文档与 Kilo 官方文档整理步骤、模型 ID 与常见报错。
更新于 2026-10-07
配置前先记住四件事
Claude 选的 Provider API
Base URL 填 https://api.qcode.cc/api。QCode 文档建议填到 /api 为止，由扩展自己拼 /v1/messages。
GPT 与国产模型
Base URL 填 https://api.qcode.cc/openai/v1，同一把 cr_ 密钥，模型 ID 手填，如 gpt-6-sol、glm-5.2。
配置入口在哪
设置（齿轮）→ Providers 标签 → 拉到最底部 → Custom provider。QCode 文档写明新界面不再是 Roo Code 那种 API Provider 下拉。
最新正式版（2026-10-01）
截至 2026-10-07 GitHub 上最新的正式版，它在 Custom Provider 对话框里加了手动 Fetch Models 按钮；2026-10-07 又发了 v7.8.7 预发布版。
Kilo Code 接自定义 API 的思路
截至 2026-10-07，在 Kilo Code 里接 Claude，是在设置的 Providers 标签最底部添加一个 Custom provider：Provider API 选 Anthropic Messages，Base URL 填 https://api.qcode.cc/api，API key 填 cr_ 密钥，模型 ID 手填；GPT 与国产模型在同一个对话框里改选 OpenAI Compatible、填 https://api.qcode.cc/openai/v1。Kilo Code 官方 README 称它是面向 VS Code、JetBrains 与 CLI 的开源编程智能体。QCode 文档写明它是 Roo Code 的 fork，而 Roo Code 又 fork 自 Cline，但界面已经分叉，这两个工具的步骤不能直接照搬过来。
Kilo Code 还在维护吗（截至 2026-10-07）
截至 2026-10-07，Kilo Code 仍在持续更新：GitHub 仓库 Kilo-Org/kilocode 未归档、采用 MIT 许可，最近一次推送在 2026-10-07（UTC）。最新正式版是 v7.8.3，发布于 2026-10-01（UTC），发布说明写着 Add a manual Fetch Models button to the Custom Provider settings dialog.；2026-10-07 又发了 v7.8.7 预发布版，JetBrains 插件 7.1.9-rc.1 发布于 2026-09-28（UTC）。归属方面，Kilo 官方文档页面写着 Kilo has been acquired by Anaconda.。QCode 文档写明 Kilo 的自定义端点入口已经改版，本页步骤按新界面写。
版本与文档时间线
QCode 的 Kilo Code 接入文档与接入点文档更新，步骤按 Custom provider 新界面写（Kilo 接入页最后核实日期为 2026-09-18）。
Kilo Code v7.8.3 正式版发布（UTC），发布说明列出 Custom Provider 对话框加入手动 Fetch Models 按钮。
Kilo Code 发布 v7.8.7 预发布版（UTC），仓库同日仍有推送；截至当天最新正式版仍是 v7.8.3。
已确认 vs 文档没写的
已确认（文档原文逐字可核）
以下都能在 QCode 文档、Kilo 官方文档或 GitHub 上逐字核到：入口是设置 → Providers 标签 → 最底部的 Custom provider；对话框字段为 Provider ID、Display name、Provider API、Base URL、API key、Models 与可选的 Headers，点 Submit 后模型出现在 model picker 里；Kilo 官方写明 Anthropic 模型用 Anthropic Messages，OpenAI 与 xAI 用 OpenAI Responses；Claude 填 https://api.qcode.cc/api，GPT 与国产模型填 https://api.qcode.cc/openai/v1，两边同一把 cr_ 密钥；Claude 放进 OpenAI Compatible 会报 model_not_available_on_endpoint；v7.8.3 于 2026-10-01 发布。
文档没写或没核实的
四件事本页不下结论：① Anthropic Messages 下能否自动抓取模型列表：Kilo 官方写的是 Base URL 暴露 OpenAI 兼容的 models 端点时会自动抓取，本页未实测，按手填模型 ID 写。② 多余的末尾斜杠是否直接 404，QCode 的 Kilo 接入页写明未实测；接入点文档的通用说法是会拼成 //v1/messages 导致 404。③ JetBrains 插件的界面步骤，QCode 文档没写，本页只写 VS Code 扩展。④ 配置文件名在 Kilo 官方两处分别写作 kilo.json 与 kilo.jsonc，本页不给文件写法。
怎么选
Anthropic Messages 对 OpenAI Compatible
看模型家族：Claude 只能选 Anthropic Messages（https://api.qcode.cc/api），QCode 的 OpenAI 端点不接受 Claude 模型；GPT 选 OpenAI Compatible（https://api.qcode.cc/openai/v1）。国产的 GLM、Kimi、DeepSeek、Qwen 在 QCode 接入点文档里两种端点都能走，Kilo 接入页给的是 OpenAI Compatible 写法。
Kilo Code 对 Roo Code / Cline
代码同源，界面已分叉：Kilo 用 Providers 标签里的 Custom provider 对话框，Roo Code 与 Cline 仍是 API Provider 下拉。QCode 文档提醒步骤不能直接照搬，用哪个工具就看哪个工具的配置页。
六步接上 Claude（再加 GPT 与国产模型）
① 点开 Kilo Code 侧边栏的设置（齿轮图标），进 Providers 标签，拉到最底部点 Custom provider。② Provider ID 填一个唯一标识（名字可自定，文档示例用 qcode），Display name 随便起。③ Provider API 选 Anthropic Messages，Base URL 填 https://api.qcode.cc/api（末尾不带斜杠），API key 填 cr_ 开头的 QCode 密钥。④ Models 手填模型 ID，例如 claude-sonnet-5，claude-sonnet-5-5、claude-opus-5-5 也一样手填；Headers 可留空。⑤ 点 Submit 保存，模型出现在 model picker 里，在聊天框发一句话验证。⑥ 要接 GPT 与国产模型，再加一个 Custom provider：Provider API 选 OpenAI Compatible，Base URL 填 https://api.qcode.cc/openai/v1，同一把 cr_ 密钥，模型手填 gpt-6-sol、gpt-5.6-terra 或 glm-5.2。
在 QCode 上
在 QCode 上，一把 cr_ 密钥不区分协议，协议由请求路径决定：claude-sonnet-5、claude-sonnet-5-5、claude-opus-5-5 走 Anthropic Messages、https://api.qcode.cc/api；gpt-6-sol、gpt-5.6-terra 与 glm-5.2、deepseek-v4.1-flash、kimi-k3 走 OpenAI Compatible、https://api.qcode.cc/openai/v1。三个接入域同一把 key 都能用：北美与欧洲可用 us.qcode.cc，中国大陆网络文档建议把域名换成 asia.qcode.cc，Key 不变。按 token 计费，各模型单价见 /models；请求记录可在 probe.qcode.cc 输入 key 查看。
常见问题
Kilo Code 接 Claude 该选哪种 Provider API？
选 Anthropic Messages。在 Custom provider 对话框里，Base URL 填 https://api.qcode.cc/api，API key 填 cr_ 密钥，Models 手填 claude-sonnet-5 之类的模型 ID。Kilo 官方文档写明 Anthropic 模型用 Anthropic Messages；QCode 文档也提醒不要用 OpenAI Compatible 去调 Claude。
报 model_not_available_on_endpoint 是什么意思？
说明协议选错了，不是密钥有问题。把 Claude 放进 OpenAI Compatible，QCode 会返回 Model 'claude-sonnet-5' is not available on this endpoint. 这类错误；文档写明这个校验发生在鉴权之前，即使密钥无效也先报它。改成 Anthropic Messages、Base URL https://api.qcode.cc/api 即可。
Base URL 要不要带 /v1 或末尾斜杠？
Anthropic Messages 填到 /api 为止（https://api.qcode.cc/api），由扩展自己拼 /v1/messages；OpenAI Compatible 按 QCode 文档填 https://api.qcode.cc/openai/v1。末尾都不要带斜杠：QCode 的 Kilo 接入页写明多余斜杠是否直接 404 未实测，接入点文档的通用说法是会拼成 //v1/messages 导致 404。
模型下拉里没有 claude-sonnet-5-5 怎么办？
手填模型 ID。QCode 文档写明扩展的内置清单未收录时，用自定义模型 id 输入框手填；Kilo 官方也写明自动识别失败时仍可手动输入模型 ID。改好 Base URL 或 API key 后，可以点模型列表旁的 Fetch models 重新抓取。报 Model Not Found 时，先核对填的是不是有效的模型 ID。
填了 key 还是连不上怎么办？
先在终端用 curl 向 https://api.qcode.cc/api/v1/messages 发一个 POST 自测：返回含 content 的 JSON，说明端点侧没问题，问题在扩展的界面配置。报 Invalid API key 时，确认密钥以 cr_ 开头、没有前后空格。别用直接打开 https://api.qcode.cc/api 来判断，那样会拿到一个 HTML 介绍页（HTTP 200），既不是报错，也不能说明路径可用。
Kilo Code 现在还在维护吗？
在维护。截至 2026-10-07，GitHub 仓库 Kilo-Org/kilocode 未归档，最近一次推送在 2026-10-07（UTC）；最新正式版 v7.8.3 发布于 2026-10-01，2026-10-07 还发了 v7.8.7 预发布版。
信息来源
配置步骤、Provider API 类型与地址：QCode 文档的 Kilo Code 接入页（更新于 2026-09-25）与接入点与 API 格式页（更新于 2026-09-25，含哪些模型走哪个端点、报错原文与三个接入域），均于 2026-10-07 抓取。Kilo 侧的界面与字段：Kilo 官方文档（kilo.ai/docs）的 OpenAI Compatible 与 Anthropic 页，同日抓取。维护状态与版本：GitHub 仓库 Kilo-Org/kilocode 的 README、仓库信息与 Releases，同日抓取。
相关阅读
Cline 接 OpenAI 兼容 API 指南
在 Cline 里填三项配置接上 QCode。
Cherry Studio 配置 Claude API 指南
Claude 选 Anthropic 类型，GPT 与国产模型选 OpenAI 类型。
Claude Code 自定义端点配置
两个环境变量、settings.json 写法与 apiKeyHelper。
本页步骤与引语核对于 2026-10-07，以 QCode 文档、Kilo 官方文档与 GitHub 发布说明为准，上游调整不另行通知。扩展界面标签随版本变化，以你手上的版本为准；模型可用性以 /models 为准。