Kilo 接入指南:在新版扩展中配置自定义模型
核对 Kilo 新版 VS Code 扩展的自定义 Provider、协议选择和模型标识,区分账号登录与外部 API 凭证,并处理上下文、工具调用及数据权限。
内容复核中 官方配置已核对;本站接入未实测。 图解为本站原创示意,不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例,不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
先确认扩展入口与文档版本
本篇针对 Kilo 的当前 VS Code 扩展。官方安装页说明,新扩展基于 Kilo CLI 构建;自定义模型文档也明确适用于当前扩展与 CLI。 因此,旧版截图里的字段名不能直接当作新版操作步骤。记录扩展版本、所用发行渠道和工作区,再核对设置页面是否包含 Providers。
账号登录与外部 Provider 是两件事。先决定使用 Kilo 托管服务,还是经单位批准的独立模型端点,不要把网页登录令牌复制到外部 API Key 栏。
从 Providers 添加端点
打开扩展的设置,在 Providers 页选择 Custom provider。按官方表单填写 Provider ID、显示名、Provider API、Base URL 和模型 ID;没有自动发现结果时,可以手动登记模型。 显示名称只方便辨认,服务端实际接收的模型标识仍须准确。
下面是原创字段示意。地址、Key、模型均为占位,并无真实接口,也不代表本站提供模型调用:
| 字段 | 占位值 |
|---|---|
| Provider ID | gateway |
| Provider API | OpenAI Compatible |
| Base URL | https://80321.cn/v1 |
| API key | YOUR_API_KEY |
| 模型 ID | YOUR_MODEL_ID |
官方还列出 OpenAI Responses 和 Anthropic Messages;必须按照服务商实际实现选协议,不能只凭模型名称推断。
用小工作区分开验证能力
保存后,在模型选择器选中新增模型,先让它解释一份无敏感内容的小文件,再提出只生成补丁、不执行命令的要求。文本回答正常后,才单独核对工具调用、流式输出和图片输入。某个选项出现在表单里,不等于该模型真的支持它。
自定义模型需要按实际规格填写上下文与输出上限。官方说明,未知模型未设置这些限制时,自动上下文管理可能失效。 不要照抄别人的窗口大小,更不要用无限增大的输出限制掩盖截断。
按请求阶段排错
没有模型列表时,先核对是否只有模型发现失败;不要因此认定对话接口不可用。请求报错时依次检查协议、最终路径、模型 ID 与凭证所属服务。权限错误应由管理员处理,不能改用来历不明的账号。出现工具循环时,缩小任务并检查模型能力,而不是开启全部自动审批。
检查凭证与文件访问
Kilo 的配置可在全局与项目间共享,官方提醒项目配置不得提交真实密钥。 排查时只保留脱敏状态码和请求路径,隐藏鉴权头、代码内容与日志中的个人信息。首次使用保留编辑和终端操作确认;端点切换会改变代码上下文的接收方,须重新核对数据保存政策。
如沟通材料出现 https://80321.cn/keys 或 https://80321.cn/wallet,它们也只是教程示例,不代表已提供 Key 创建或充值功能。