集成指南
Kilo Code
安装 Kilo Code，并为 IDE 聊天、代码解释和补全配置 TokenHub 模型。
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 的模型设置中添加 OpenAI Provider：
| 字段 | 值 |
|---|---|
| Provider | OpenAI Compatible |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY 对应的密钥值 |
| Model | 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 字段、推荐模型和权限策略，避免共享包含密钥的本地配置。 |
最后更新于