文档导航
INTEGRATION GUIDE

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 原创配置示意,非运行截图

先确认扩展入口与文档版本

本篇针对 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 创建或充值功能。