Kilo Code 配置教程

更新于 2026-09-27

适用范围：当前 Kilo Code VS Code 扩展的 Custom provider 界面；本文使用 OpenAI Compatible（Chat Completions）协议。

版本与验证：2026-09-28 更新 apizt 专用配置示意图；所有接入地址使用 https://api.apizt.com/v1，模型示例使用 gpt-6-sol。按官方文档核对字段，界面文字可能随版本变化。未使用真实 API Key 验证付费调用。

配置速查

配置项	填写内容	注意事项
Provider ID	`apizt`	自定义提供商的唯一标识。
Display name	`apizt`	显示名称，可自行修改。
Provider API	`OpenAI Compatible`	本文使用 Chat Completions 兼容协议。
Base URL	`https://api.apizt.com/v1`	建议填写以 /v1 结尾的基础地址。
API key	`apizt API Key`	填写 apizt 令牌。
Models	`gpt-6-sol`	示例模型，替换为当前令牌可用 ID。

还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key

为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。

本教程按当前 Kilo Code 自定义提供商界面配置 apizt。选择 OpenAI Compatible 协议，先完成聊天验证，再测试项目代码问答和 Agent 工具调用。

一、安装 Kilo Code 扩展

打开 VS Code 扩展市场，搜索 Kilo Code，核对官方发布者后安装。
按当前官方安装说明，使用安装按钮下拉菜单中的 Install Pre-Release Version 获取新版界面；已有旧版用户可按官方迁移说明升级。
打开项目，从侧栏进入 Kilo Code；扩展已包含运行组件，无需为本文另外安装 CLI。

二、添加 Custom provider

打开 Kilo 设置齿轮，进入 Providers 标签，向下找到 Custom provider 并点击。

Kilo Code 官方 Providers 页面中的 Custom provider 添加入口 — 图 1：官方 Custom provider 入口原图。点击图片可在页内放大；支持关闭按钮、点击图片外区域和 Esc 关闭。

Kilo Code · Custom provider，API 地址 https://api.apizt.com/v1，模型 gpt-6-sol；配置示意图 — 图 2：apizt 自定义提供商配置示意图。选择 OpenAI Compatible 协议。图中的 sk-demo-not-a-real-key 为无效演示密钥；gpt-6-sol 为模型示例，以令牌实际权限为准。点击图片可在页内放大；支持关闭按钮、点击图片外区域和 Esc 关闭。

三、填写 apizt 参数

字段	填写内容	说明
Provider ID	`apizt`	自定义提供商的唯一标识。
Display name	`apizt`	显示名称，可自行修改。
Provider API	`OpenAI Compatible`	本文使用 Chat Completions 兼容协议。
Base URL	`https://api.apizt.com/v1`	建议填写以 /v1 结尾的基础地址。
API key	`apizt API Key`	填写 apizt 令牌。
Models	`gpt-6-sol`	示例模型，替换为当前令牌可用 ID。

Kilo Code 参数示意：提供商 apizt、OpenAI Compatible 协议、apizt 地址密钥与模型 — 图 3：apizt 自定义提供商字段对照示意图。点击图片可在页内放大；支持关闭按钮、点击图片外区域和 Esc 关闭。

下面的内容用于逐项复制到界面，不是可直接导入的配置文件：

Provider ID: apizt
Display name: apizt
Provider API: OpenAI Compatible
Base URL: https://api.apizt.com/v1
API key: 填入你的apizt令牌
Model ID: gpt-6-sol

地址和密钥填写后，Kilo 可以从模型接口读取列表。若没有读取到，手动添加完整模型 ID 和显示名称。先保持额外 Headers 为空，点击 Submit 保存。

四、选择模型并发送测试消息

回到聊天面板，从模型选择器中找到 apizt 提供商下刚添加的模型。
发送「请只回复：连接成功」，确认收到正文。
在 apizt 控制台检查对应调用日志，核对模型 ID 和分组。
更换模型时，编辑提供商配置并添加新的可用模型，再在聊天面板切换。

五、验证代码问答与 Agent

在一个小型项目中，先让 Kilo 解释一段选中的代码，再尝试「读取 README 并总结项目结构」。当工具调用正常后，再提出小范围修改任务，并检查生成的差异。

如果需要填写 token 限制、工具调用或图片能力，按官方 kilo.jsonc 说明和模型实际限制配置。不要照搬其他模型的上下文数值；代码问答成功不等于所有 Agent 能力已验证。

六、什么时候更换 Provider API

本文针对支持 OpenAI 兼容 Chat Completions 的模型。如果某个模型要求 Responses 或 Anthropic Messages，应按 apizt 对应接口说明另外建立匹配的提供商配置。仅修改模型名不足以切换请求协议。

旧版 Kilo 界面可能仍显示 API Provider 下拉框；升级后按本页流程操作，或参照所装版本的官方文档。

常见问题

Kilo 的 API key 可以留空吗？

接入 apizt 时需要认证。本文直接填写 apizt API Key；不要因为界面显示 Optional 就省略密钥。

模型能聊天，为什么 Agent 仍报错？

检查模型与所选协议是否支持工具调用，保留具体错误体。先测试简单问答，再测试工具任务，避免一次加入过多功能。

连接失败时按这几步排查

自定义 Provider 的 Base URL 为 https://api.apizt.com/v1。Provider API 按实际通道选择 OpenAI Compatible、OpenAI Responses 或 Anthropic Messages；最终路径分别核对 /chat/completions、/responses、/messages。

在 Settings → Providers 添加 Custom provider；旧版界面从 API Provider 进入，先记录版本以便对照。
填写 Provider ID、名称、对应的 Provider API、Base URL 与 apizt Key。虽然界面可能允许留空 Key，apizt 调用仍需认证。
发现或手动添加真实模型 ID，提交保存，并在当前会话选中该 provider 下的模型。

容易混淆的情况

不要按品牌名称推断协议；同一模型名经不同通道可能只支持某一种端点。
模型出现但 Agent 无法执行时，检查工具调用与流式事件；配置中的能力开关不等于服务端已支持。

怎样确认修复成功

先短文本验证，再在测试目录授权读取一个文件；记录实际请求端点，确认最终回答包含工具返回的信息。

记录所装客户端版本、模型 ID、请求时间、最终路径与脱敏状态。本节为配置核对指南，未新增客户端付费调用实测；保留原文已有验证记录的适用范围。

打开 Kilo Code 交互排错并下载检查记录 · 官方配置参考

怎样确认配置已生效

模型选择器能看到 apizt 提供商及配置的模型。
短消息有正常回复，apizt 日志记录对应请求。
代码问答成功后，再单独核对 Agent 工具调用与修改差异。

接入失败时逐项检查

现象	检查与处理
401 / Unauthorized	重新复制 apizt 令牌，检查是否完整、是否已过期；不要填写工具平台自己的密钥。
403 / 模型无权限	检查令牌允许的模型和所选分组，以响应中的具体错误为准。
404 / 路径错误	本文 Base URL 填 https://api.apizt.com/v1，检查重复的 /v1 或错误的接口路径。
model not found	从价格页复制完整模型 ID，确认当前令牌分组提供该模型。
429 / 额度或速率限制	按错误体区分余额、令牌额度、并发和速率限制；减少并发并稍后重试。
无法找到 Custom provider	检查所装版本是否为当前官方推荐界面；旧版入口不同，按对应版本说明配置。
模型自动发现失败	手动填写可用模型 ID，继续用短消息测试；列表失败不一定等于聊天不可用。
Agent 参数或工具格式错误	核对 Provider API 与模型协议，检查工具调用支持和请求错误体。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。