OpenCode

前置条件

• 已安装 OpenCode。
• 一把 OpenAI 协议的 API Key，并已导出为 ROIBEST_API_KEY。

步骤

在项目根目录或 OpenCode 的全局配置目录里编辑 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "roibest/your-model",
  "provider": {
    "roibest": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ROIBest AI",
      "options": {
        "baseURL": "https://ai.roibest.com/v1",
        "apiKey": "{env:ROIBEST_API_KEY}"
      },
      "models": {
        "your-model": {
          "name": "your-model"
        }
      }
    }
  }
}

{env:ROIBEST_API_KEY} 是从环境变量取值的占位写法，密钥不会落进配置文件。

model 的格式是 provider/model，前半段必须与 provider 下的键名一致。要用多个模型时，在 models 里逐个列出。

核心配置示意图，非软件截图；完整 JSON 见上方代码块。点击图片查看大图。

验证

opencode run "hello"

或直接验证网关：

curl https://ai.roibest.com/v1/chat/completions \
  -H "Authorization: Bearer $ROIBEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model","messages":[{"role":"user","content":"hello"}]}'

常见问题

提示 provider 不存在。 model 里的前缀和 provider 的键名不一致。两处都要写 roibest。

模型列表里看不到新模型。 models 是显式声明的，新模型要手动加一条。

鉴权失败。 ROIBEST_API_KEY 未导出，或用的是 Anthropic 分组的密钥。