@ai-sdk/openai-compatible 接入 BetterToken。Provider 名称填写 BetterToken 或 OpenAI Compatible;GPT、Kimi、GLM 是 BetterToken 内的模型提供商,不是 OpenCode provider 名称。普通的 API Key、Base URL 或 opencode.json 配置请继续使用本页;只有在选择和验证特定模型时,才进入单独的 GLM 指南或 Kimi K3 指南。
重点信息
准备工作
- 安装最新版 OpenCode
- 创建 BetterToken API Key
- 从模型广场或 Key 的 Setup 弹窗复制 Model ID
安装
- curl
- npm
命令行配置
BetterToken Automatic setup 脚本会创建或更新 OpenCode 的 BetterToken provider。脚本需要 Node.js;如果没有通过参数提供 API Key 或 Model ID,运行时会提示你输入。- macOS / Linux
- Windows
bettertoken/YOUR_MODEL_ID。OpenCode 已经打开时,请重启后再验证。
手动配置
方式一:使用 /connect 保存凭证
启动 OpenCode,运行: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
- Kimi K3 如何接入 OpenCode?
- GLM 如何接入 OpenCode?
- OpenAI-compatible API 和 Anthropic-compatible API 有什么区别?
- MCP 和 API Key / Base URL 有什么区别?
- model_provider、base_url 和 wire_api 是什么?
- Cline 如何配置 OpenAI-compatible API?
可选:使用 CC Switch 管理 provider
需要集中管理多个工具的 provider 时,可以查看 CC Switch 中的 OpenCode 配置。技术说明
Provider 与模型提供商
Provider 与模型提供商
OpenCode provider 是
bettertoken,底层使用 @ai-sdk/openai-compatible 和 Chat Completions。GPT、Kimi、GLM 是 BetterToken 模型广场中的模型提供商;把选中的完整 Model ID 写入 models。
