Kilo Code 安装与 API 配置
安装 Kilo Code,配置 BetterToken Base URL 和 API Key,选择模型并排查常见错误。
要在 Kilo Code 中使用 BetterToken,请准备 API Key,填写下表中的 Base URL,并从模型广场选择当前可用的 Model ID。
三步完成首次请求
- 获取 BetterToken API Key,并从模型广场选择 Model ID。
- 在 Kilo Code 的 Providers 设置中添加 Custom provider,选择 OpenAI Compatible,然后填写 API Key、
https://bettertoken.ai/v1和 Model ID。 - 保存配置,重启扩展,然后在新对话中发送一个简短请求。
重点信息
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
准备工作
工具特定要求
- 已安装 VS Code
安装
如果已经安装 Kilo Code,请直接进入手动配置,填写 BetterToken API Key、Base URL 和 Model ID。
如果尚未安装扩展,或需要了解安装与俄罗斯地区使用背景,请先阅读英文 Kilo Code 安装与自定义 API 指南,再回到本页使用当前配置字段。
手动配置
主要通过 Kilo Code 的设置界面完成以下配置,不需要手动编辑配置文件。
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
配置步骤
清除冲突的环境变量
unset OPENAI_API_KEYunset OPENAI_BASE_URL打开 Kilo Code 设置
打开 Settings(齿轮图标),选择 Providers,点击列表底部的 Custom provider。
配置 API 提供商
按以下方式填写:
- Provider ID →
bettertoken - Display name →
BetterToken - Provider API →
OpenAI Compatible - Base URL →
https://bettertoken.ai/v1 - API Key → 你的 BetterToken API Key
- Models → 手动添加从模型广场复制的模型 ID,显示名称也使用同一 ID
点击 Submit 保存 provider。以上是官方 Custom Models 指南中的 VS Code 扩展字段。
仅在官方文档明确要求时再配置额外 headers
我们查到的 Kilo Code 官方资料提到 OpenAI-compatible provider 支持可选自定义 headers,但没有把 User-Agent 列为 BetterToken 默认接入的必填项。
如果你还接了自定义网关、租户路由或审计服务,再按对应上游服务的官方文档补充所需 headers。
重启 Kilo Code
修改配置后,请重启 VS Code 或重新加载 Kilo Code 插件,使新配置生效。
验证连接
打开一个新的 Kilo Code 对话,发送简短请求,例如:只回复一个词:OK。如果工具正常返回内容,并且没有出现鉴权或 Model ID 错误,说明首次请求成功。修改配置后请完全重启 VS Code 或扩展。遇到问题时直接查看常见错误。
切换模型
打开模型选择器,或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID,然后重新启动当前会话。
常见错误
| 错误 | 排查方式 |
|---|---|
401 或 Unauthorized | 检查 BetterToken API Key,并删除首尾空格。 |
404 | 检查 Base URL,不要附加具体 endpoint 路径。 |
model not found | 从模型广场重新复制当前 Model ID。 |
| 配置未生效 | 保存配置,并完全退出后重新启动工具。 |
技术说明
协议、endpoint 与 provider 内部字段
本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint;除非具体字段明确要求,否则不要在 Base URL 后附加 /chat/completions 或 /responses。

