Kilo Code是什么？
Kilo AI 的 Kilo Code 是一款开源 AI 编码代理，可在 VS Code、JetBrains 和 CLI 中使用，并具有可配置的模型提供程序。
本 Kilo Code 设置指南使用其 OpenAI-compatible 提供程序控件来连接 TokenHub。从只读任务开始，然后使用支持工具的模型验证编辑和命令。 Kilo Code 在 VS Code、JetBrains 和 CLI 中公开相关工作流程，但这些客户端之间的配置范围可能有所不同。确认您实际使用的客户端中的活动配置文件和提供程序，然后 comp 是代表性存储库任务的模型质量、工具可靠性、延迟、上下文长度和成本。
Kilo Code 是开源 VS Code 编程智能体。你可以参考 Kilo Code OpenAI Compatible 官方文档 安装扩展并添加 TokenHub，用于 IDE 内聊天和代码修改工作流。
适合场景
Kilo Code 更适合 IDE 内轻量工作流：解释当前文件、生成测试建议、写注释、辅助补全。它不像终端 Agent 那样默认执行命令，因此适合想先把 TokenHub 接入编辑器问答的团队。
安装 Kilo Code
常见方式：
- 打开 VS Code 或 JetBrains IDE。
- 在插件市场搜索
Kilo Code。 - 安装扩展并重新加载 IDE。
- 打开 Kilo Code 面板，进入模型设置。
如果你使用的是团队固定版本，以团队文档或锁定版本为准。
准备 TokenHub 凭证
export TOKENHUB_API_KEY="sk-..."选择一个聊天模型；如果还要做自动补全，再选择一个响应更快、成本更低的模型。
持久化设置位置
Kilo Code 的 provider schema 会随扩展版本变化。官方 OpenAI Compatible 文档当前以设置界面为主，因此建议先通过 Kilo Code Provider 设置保存 TokenHub，不要手写未验证的 JSON 或 YAML 字段。
| 位置 | 用途 |
|---|---|
| Kilo Code Provider 设置 | 保存 TokenHub Base URL、API Key 和 Model ID。 |
| Kilo Code 模型设置 | 选择 Chat、Edit 或补全模型。 |
| 团队文档 | 只记录 Base URL、Model ID 和用途建议，不记录真实 API Key。 |
如果团队要共享配置，请把 API Key 留在本机环境变量或 IDE 安全字段里，不要写入项目仓库。
通过设置界面配置
在 Kilo Code 的 Providers 设置中添加 Custom provider，填写一个自定义 Provider ID（例如 tokenhub），并把 Provider API 设为 OpenAI Compatible：
| 字段 | 值 |
|---|---|
| Provider ID | tokenhub |
| Display Name | TokenHub |
| Provider API | OpenAI Compatible |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY 对应的密钥值 |
| Model | TokenHub 模型列表中的 Model ID |
Kilo Code 会尝试从 /v1/models 获取模型；如果自动获取失败，就手动填写 TokenHub 模型列表中的真实 Model ID。如果 IDE 没有继承环境变量，先在 UI 中直接粘贴 API Key 验证。
配置补全模型
如果你要使用 Tab 补全，建议单独配置低延迟模型：
| 用途 | 建议配置 |
|---|---|
| Chat | 更强的代码理解模型 |
| Edit | 与 Chat 相同或稍快的代码模型 |
| Tab | 更低延迟、成本更低的模型 |
先验证 Chat，再配置补全，排错会简单很多。
验证
重载 IDE 后，在 Kilo Code Chat 中输入：
请解释当前选中代码，并指出一个可能的测试用例。如果 Kilo Code 正常回答，说明聊天模型已接入。补全模型建议在小文件中测试，观察是否能稳定给出建议。
故障排查
| 现象 | 处理方式 |
|---|---|
| 配置不生效 | 使用 Kilo Code 设置页重新选择模型，确认实际激活的是 TokenHub 条目。 |
| 401 | 如果环境变量未被 IDE 继承，直接在设置 UI 中粘贴 API Key 测试。 |
| 模型不支持补全 | 聊天和补全可以使用不同 TokenHub 模型。 |
| 扩展版本差异大 | 以当前安装版本的配置格式为准，保持 Provider、Base URL、API Key、Model 一致。 |
| 项目要长期使用 | 记录当前 UI 字段、推荐模型和权限策略，避免共享包含密钥的本地配置。 |
推荐模型怎么选？
Kilo Code 定制 API FAQ
为什么Kilo Code无法读取TokenHub型号列表？
自动模型发现失败并不一定意味着 API 不可用。从 TokenHub 复制准确的型号 ID 并手动输入。
如果聊天功能正常但 Tab completion 不起作用怎么办？
Chat 和 Tab 可以使用不同的模型槽。为 Tab 配置低延迟的 completion-compatible 模型并单独验证。
为什么IDE无法读取TOKENHUB_API_KEY？
从桌面图标启动的 IDE 可能不会继承终端环境变量。使用 Kilo Code 的安全 API 密钥字段进行初始验证。
Kilo Code、CLI 和 IDE 扩展是否共享一种型号配置？
它们可以使用相同的 TokenHub 型号，但配置范围和配置文件可能不同。验证每个客户端中的 Base URL、密钥、型号和活动配置文件。
如果 Kilo Code 可以聊天但不能编辑代码怎么办？
确认模型支持本机工具调用和结构化参数，然后检查编辑权限和命令批准。基本文本生成不会验证代理工具链。
配置资料
本页配置以 TokenHub 教程和官方资料为依据，最后核验于 2026-09-04。
