Skip to main content
OpenCode 使用 @ai-sdk/openai-compatible 接入 BetterToken。Provider 名称填写 BetterTokenOpenAI Compatible;GPT、Kimi、GLM 是 BetterToken 内的模型提供商,不是 OpenCode provider 名称。普通的 API Key、Base URL 或 opencode.json 配置请继续使用本页;只有在选择和验证特定模型时,才进入单独的 GLM 指南Kimi K3 指南

重点信息

准备工作

安装

命令行配置

BetterToken Automatic setup 脚本会创建或更新 OpenCode 的 BetterToken provider。脚本需要 Node.js;如果没有通过参数提供 API Key 或 Model ID,运行时会提示你输入。
运行后选择 bettertoken/YOUR_MODEL_ID。OpenCode 已经打开时,请重启后再验证。

手动配置

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

启动 OpenCode,运行:
选择 Other,provider id 填 bettertoken,再输入 YOUR_API_KEY。OpenCode 将凭证保存在本机认证存储中。

方式二:配置 JSON

全局配置文件是 ~/.config/opencode/opencode.json;项目级可以在项目根目录使用 opencode.json
如果不使用 /connect,可以在 options 中添加 "apiKey": "YOUR_API_KEY"。不要把包含真实 Key 的配置提交到 Git。

验证连接

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

切换模型

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

常见错误

进阶配置

支持的提供商

状态仅针对本页介绍的 BetterToken 接入方式。
  • 命令行配置 + 手动配置:可以使用生成的一键命令,也可以按照完整步骤手动配置。
  • 手动配置:填写 API Key、Base URL 和 Model。
  • 不支持:当前没有经过验证的直接配置方式。

相关 FAQ

可选:使用 CC Switch 管理 provider

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

技术说明

OpenCode provider 是 bettertoken,底层使用 @ai-sdk/openai-compatible 和 Chat Completions。GPT、Kimi、GLM 是 BetterToken 模型广场中的模型提供商;把选中的完整 Model ID 写入 models