在 Coding Agent 接入

OpenCode 自定义模型与 API 配置

通过 /connect 和 opencode.json 将 OpenCode 接入 BetterToken 的 Chat Completions API，配置 API Key、Base URL 和 Model ID。

OpenCode 使用 @ai-sdk/openai-compatible 接入 BetterToken。普通的 API Key、Base URL 或 opencode.json 配置请继续使用本页；只有在选择和验证特定模型时，才进入单独的 GLM 指南或 Kimi K3 指南。从模型广场复制准确的 Model ID。

重点信息

字段	填写内容
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

准备工作

使用下方命令安装 OpenCode 1
创建 BetterToken API Key
从模型广场或 Key 的 Setup 弹窗复制 Model ID

安装

下方命令安装的是 OpenCode 1。OpenCode 2 请使用其安装指南。OpenCode 2 会从相同位置读取现有配置，并转换受支持的 V1 provider 设置；修改配置语法前请阅读迁移指南。

curl

curl -fsSL https://opencode.ai/install | bash

npm

npm install -g opencode-ai

命令行配置

BetterToken Automatic setup 脚本会创建或更新 OpenCode 的 BetterToken provider。脚本需要 Node.js；如果没有通过参数提供 API Key 或 Model ID，运行时会提示你输入。

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-opencode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-opencode-provider.ps1" -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

运行后选择 bettertoken/YOUR_MODEL_ID。OpenCode 已经打开时，请重启后再验证。

手动配置

方式一：使用 /connect 保存凭证

启动 OpenCode，运行：

/connect

选择 Other，provider id 填 bettertoken，再输入 YOUR_API_KEY。OpenCode 将凭证保存在本机认证存储中。

方式二：配置 JSON

全局配置文件是 ~/.config/opencode/opencode.json；项目级可以在项目根目录使用 opencode.json。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

如果不使用 /connect，可以在 options 中添加 "apiKey": "YOUR_API_KEY"。不要把包含真实 Key 的配置提交到 Git。

本例使用 @ai-sdk/openai-compatible 调用 Chat Completions。SDK 包必须与接口协议匹配；改用其他协议前，请查看官方 provider 说明。测试中，OpenCode 1.19.4 和 2.1.3 在使用相同 Base URL、未设置输出 Token 上限时，均通过 @ai-sdk/openai-compatible（/v1/chat/completions）和 @ai-sdk/openai（/v1/responses）成功完成了文本请求。

验证连接

在项目目录运行 opencode，选择 bettertoken/YOUR_MODEL_ID 并发送一条简短消息。能够返回内容即表示配置成功。修改 JSON 后需要重启 OpenCode。

切换模型

在 provider.bettertoken.models 中加入新的 YOUR_MODEL_ID，同时更新顶层 model，保存后重启。

常见错误

错误	处理方式
`401`	重新执行 `/connect`，或检查 `apiKey`。
`404`	`baseURL` 只填 `https://bettertoken.ai/v1`，不要追加 `/chat/completions`。
找不到模型	确认顶层 `model` 与 `models` 中的 ID 完全一致。
配置未生效	检查项目级 `opencode.json` 是否覆盖全局配置，并重启 OpenCode。

进阶配置

可选：使用 CC Switch 管理 provider

需要集中管理多个工具的 provider 时，可以查看 CC Switch 中的 OpenCode 配置。

技术说明

配置模型

OpenCode provider 是 bettertoken，底层使用 @ai-sdk/openai-compatible 和 Chat Completions。从模型广场复制准确的 Model ID。