Skip to main content
本页只适用于 Kodacode / Koda，不适用于 MonkeyCode。要在 Kodacode 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。如果错误发生在 MonkeyCode，请使用单独的 MonkeyCode 指南。

​
重点信息

​
准备工作

​
工具特定要求

  • 已安装 VS Code
  • 已安装 Kodacode / Koda 插件
  • 所选 Model ID 来自 受支持提供商

​
安装

安装或打开 Kodacode，然后继续完成下方手动配置。

​
手动配置

​
配置步骤

1

打开 Koda 面板并添加模型

打开 VS Code 左侧的 KODA 面板，点击输入框下方的模型下拉菜单，然后选择 Добавить модель: Agent / Add model: Agent。
在 Koda 面板的模型下拉菜单中选择 Add model: Agent。
2

填写 OpenAI-compatible 模型配置

在添加模型窗口中，按下面方式填写：填写完成后，点击 Подключить / Connect。
在 Kodacode 添加模型窗口中选择 Any OpenAI-compatible API，并填写 API Base、Model ID 和 API Key。
3

确认模型已生效

连接完成后，在 Koda 输入框下方的模型选择器中选择刚添加的模型，例如 YOUR_MODEL_ID。发送一条简单消息，确认能够正常返回结果。
4

检查 config.yaml

Kodacode 会把配置写入本机的 ~/.koda/config.yaml。你可以打开该文件确认模型已经写入。
Kodacode config.yaml 中已经写入 OpenAI-compatible 模型配置。

​
config.yaml 示例

下面是可以对照检查的完整结构。请把 YOUR_API_KEY 替换为你的 BetterToken API Key，不要把真实 API Key 提交到仓库。
如果你使用的模型不是 YOUR_MODEL_ID，请同时修改 name 和 model，保持它们与模型广场中的 受支持提供商的模型 ID 一致。

​
验证连接

发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。

​
切换模型

打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。

​
常见错误

  • 如果连接失败，先确认 API Base 是否为 https://bettertoken.ai/v1/，并保留末尾 /。
  • 如果模型不可用，确认 Model ID 是否来自 受支持提供商。
  • 如果鉴权失败，重新复制 API Key，避免多复制空格或换行。
  • 如果修改 config.yaml 后没有生效，重启 VS Code 或执行 Developer: Reload Window。
  • 接入 BetterToken 时通常不需要额外设置 User-Agent 或其他 headers。

​
进阶配置

​
支持的提供商

状态仅针对本页介绍的 BetterToken 接入方式。
  • 手动配置：填写 API Key、Base URL 和 Model。
  • 不支持：当前没有经过验证的直接配置方式。

​
相关指南

​
技术说明

本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。