跳转到内容
简体中文
РусскийEnglish简体中文HindiEspañolPortuguês (BR)日本語FrançaisDeutsch한국어
免费注册
在 Coding Agent 接入

Kodacode：API 配置与 429 错误排查

为 Kodacode 配置 BetterToken API Key、Base URL 和 Model ID，并排查 429 等常见错误。

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

重点信息

字段填写内容
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai/v1
Model从模型广场复制的当前 Model ID

准备工作

工具特定要求

  • 已安装 VS Code
  • 已安装 Kodacode / Koda 插件
  • 从模型广场复制准确的 Model ID。

安装

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

手动配置

字段填写内容
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai/v1
Model从模型广场复制的当前 Model ID

配置步骤

打开 Koda 面板并添加模型

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

在 Koda 面板的模型下拉菜单中选择 Add model: Agent。

填写 OpenAI-compatible 模型配置

在添加模型窗口中，按下面方式填写：

配置项推荐值
ProviderAny OpenAI-compatible API
API Basehttps://bettertoken.ai/v1/
Model ID从模型广场复制的模型 ID，例如 YOUR_MODEL_ID
API Key你的 BetterToken API Key

填写完成后，点击 Подключить / Connect。

在 Kodacode 添加模型窗口中选择 Any OpenAI-compatible API，并填写 API Base、Model ID 和 API Key。

确认模型已生效

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

检查 config.yaml

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

Kodacode config.yaml 中已经写入 OpenAI-compatible 模型配置。

config.yaml 示例

下面是可以对照检查的完整结构。请把 YOUR_API_KEY 替换为你的 BetterToken API Key，不要把真实 API Key 提交到仓库。

name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

验证连接

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

切换模型

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

常见错误

错误排查方式
401 或 Unauthorized检查 BetterToken API Key，并删除首尾空格。
404检查 Base URL，不要附加具体 endpoint 路径。
model not found从模型广场重新复制当前 Model ID。
配置未生效保存配置，并完全退出后重新启动工具。
  • 如果连接失败，先确认 API Base 是否为 https://bettertoken.ai/v1/，并保留末尾 /。
  • 从模型广场复制准确的 Model ID。
  • 如果鉴权失败，重新复制 API Key，避免多复制空格或换行。
  • 如果修改 config.yaml 后没有生效，重启 VS Code 或执行 Developer: Reload Window。
  • 接入 BetterToken 时通常不需要额外设置 User-Agent 或其他 headers。

进阶配置

相关指南

技术说明

协议、endpoint 与 provider 内部字段

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