Kilo Code 自定义提供商通用教程：任何 OpenAI 兼容 API 四步接入

数码解码2026-11-052026-11-05

我在本站实测过的一批 AI 平台——B.AI、ATRIA、UniKey、Mercury、InferX 等等——接入 VS Code 的方法其实是同一套：它们都是 OpenAI 兼容接口，在 Kilo Code 里走「自定义提供商」就能连。之前每篇文章都把这四步完整写了一遍，既占篇幅又不好维护，这篇统一讲透，以后每篇平台实测只写各自的差异点，想看全流程的都回到这一篇。

一、准备工作

接入前手边要有两样东西，都在你要接入的平台那边：

API 密钥：在平台账号页创建并保存好（创建方法各平台文章里都有）；
接口地址（Base URL）：一般在平台的账号页、文档页或模型详情页可以复制，具体去哪复制见文末的差异速查表。

另外确认 VS Code 已装好 Kilo Code 插件。

二、四步配置

自定义提供商页面设置

打开 Kilo Code 插件 → 设置 →「提供商」→ 拉到最下方「自定义提供商」→ 点「连接」，依次填入：

提供商 ID：填平台的小写英文标识，一般在平台文档页能复制到。注意不要多带空格；如果提示 ID 冲突，在后面加 -1 之类的后缀即可；
显示名称：随手写个自己能认出来的备注就行，不影响功能；
Base URL：把从平台复制的接口地址粘贴进来。个别平台复制出来的地址尾巴上会多带一段路径，粘贴前注意清理多余后缀；
API 密钥：粘贴第一步保存的密钥。极少数社区免费节点不需要密钥，这一项留空（见 Qwen3.8 那篇）。

三、添加模型

添加想用的模型

四项填完后添加模型，两种情况：

插件能自动识别：会列出平台的模型清单。建议先「取消全选」，再单独勾选你要用的一两款——全勾上列表会很长，日常切换反而麻烦；
显示「无法识别」：从平台账号页把模型名称原样复制、手动粘贴到模型 ID 字段。注意如果网页开了翻译，模型名可能被译成中文，关掉翻译看原始英文名再复制。

确认后点「提交」，提示连接成功，顶部出现新建的模型条目，接入就完成了。随便发一条测试消息，能正常收到回复即确认可用。

四、常见报错排查（均为本站实测中真实遇到过的）

提交无反应：多半是模型只填了 ID 或只填了名称，两项缺一不可，补齐再提交；
提供商 ID 格式报错：重新复制平台标识，检查首尾有没有多余空格；
连接成功、但发消息一直「思考中」无返回：在 B.AI 实测中遇到过。大概率不是你步骤的问题，是插件与平台接口的兼容或稳定性问题——先用平台网页版顶着，评论区有相同情况的也欢迎补充；
偶发「访问被阻止」报错：在 Mercury 实测中遇到过一次，多重试几次后成功连接，属于平台侧偶发拦截，别急着改配置；
返回 429：触发频率限制。社区免费节点常见限额约为每分钟 30 次/IP，不要多线程并发高频调用；
某个模型怎么都调不通、换插件却正常：在 xKiro 实测中遇到过 Kilo Code 与个别模型的兼容问题。可以在 OpenCode 里用同样的四项信息（提供商名称、接口地址、API 密钥、模型名称）走「自定义提供商」接入，流程几乎一样。

五、各平台差异速查（详情点进各篇）

平台	接口地址去哪复制	模型	特别注意
B.AI	平台接口页	DeepSeek V4 Flash（勾选）	地址注意清理多余后缀；Kilo 里曾出现发送无返回，先用网页版
ATRIA	账号页	插件自动识别（实测 Atria-Dawn-Preview）	提供商 ID 在账号页左下角「API文档」里
UniKey	「文档 → API参考」页	DeepSeek V4 Flash、Kimi K3	模型共数十个，挑一两款即可
Mercury	账号仪表盘	Mercury 2.5（名从账号页复制）	无法识别时手动粘贴模型名
InferX	模型详情页（每个模型各自的地址）	DeepSeek V4 Flash	提供商 ID 填 `inferx`
Qwen3.8（社区节点）	Hugging Face Space 页面	Qwen3.8-27B（完整名称手填）	密钥留空；约 30 次/分钟限频
xKiro	账号页	DeepSeek V4 Pro	Kilo 兼容异常时改用 OpenCode