Kilo Code 自定义供应商接入：协议与模型发现

Kilo Code 的官方自定义供应商流程包含协议、地址、认证和模型清单，不能照搬其他 VS Code 扩展的旧面板操作。本文按核验时的官方页面说明配置能力，没有运行扩展或验证本站服务。

Kilo Code 自定义供应商与模型发现原创示意图，非运行截图

使用 Providers 中的自定义入口

在设置中打开 Providers，滚动到末尾点击 Custom provider。官方对话框要求供应商 ID、显示名称、Provider API 和 Base URL，模型可以手工添加，也可从自动获取的清单选择，完成后点击 Submit 保存。

供应商 ID 是本地配置标识，显示名称用于辨认路由，都不能代替远端模型 ID。为测试连接选择一个不与现有服务混淆的名称，保留原配置方便退出评估。

官方将 OpenAI Compatible 用于 Chat Completions 兼容端点，另外提供 OpenAI Responses 和 Anthropic Messages。先询问服务实际实现的协议，再选择相应适配器，不凭模型厂商名称猜测。

Provider ID: guide
Display name: 示例供应商
Provider API: OpenAI Compatible
Base URL: https://80321.cn/v1
API key: YOUR_API_KEY
Models: YOUR_MODEL_ID

这些值仅为占位，本站没有提供真实接口。需要附加请求头时也先确认服务要求，不同时写入多个互相冲突的认证来源。

官方说明自定义兼容供应商可以通过模型列表端点获取模型。如果服务没有实现该端点，仍可以手工输入已经确认的 ID，所以空列表本身并不证明聊天服务不可用。

不过，手工填入名称也不会使模型自动存在。正式测试前，应确认服务许可、模型 ID 和权限，再在模型选择器中检查该模型确实属于刚创建的供应商。

官方兼容入口支持 API 根地址，也支持完整聊天补全端点；两种格式必须按服务实际路径使用，不应无依据反复追加版本号或路由后缀。本文示例采用根地址，真实值请由服务方确认。

先在无敏感代码的工作区做一次短文本问答，然后经人工批准读取一个测试文件。检查回答、工具结果及实际请求错误，分别记录普通响应与 Agent 任务的结果。模型出现在菜单或自动发现成功，都不能代替这两项验证。

官方特别提醒 Azure OpenAI GPT-5 部署不能使用通用兼容供应商，因为其输出参数要求不同，应选择原生 azure 供应商。这是协议适配限制，不该通过轮换 Key 反复重试。

其他失败也应分层检查：鉴权查凭证，模型错误查 ID，连接错误查地址，工具异常查服务能力。若现有入口无法表达服务要求，暂停方案评估，不修改未公开配置键。初次接入保留审批，不把凭证、私有请求头或整个配置文件上传到项目仓库。