OpenCode

添加 OpenCode 自定义 provider，连接凭据并选择模型。

安装与准备

1. 用下方官方 npm 包安装 OpenCode，然后运行 opencode --version，需先安装 Node.js 和 npm。
2. 在 API 密钥创建 routerra.ai 密钥，从模型复制此密钥可访问的模型 ID。示例使用 Chat Completions 协议，编码任务需要模型支持工具调用。

npm install -g opencode-ai
opencode --version

注册并连接 routerra

3. 在项目根目录创建或合并 opencode.json。需对全部项目生效则使用 ~/.config/opencode/opencode.json。一致替换所有 YOUR_MODEL_ID；routerra/ 是 OpenCode 的 provider 前缀，不属于上游模型 ID。
4. 启动 opencode，运行 /connect，选择 Other，输入 provider ID routerra 并粘贴密钥。ID 必须与 JSON 对象键完全一致。凭据单独存储于 ~/.local/share/opencode/auth.json。运行 /models 选择已配置模型。修改配置文件后重启 OpenCode。

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

检查连接

provider 未出现时，检查加载的是项目还是全局配置，以及是否包含 provider.routerra.models。通过其他 /connect ID 保存的密钥无法用于此 provider。若模型仅支持 /responses，将 npm 改为 @ai-sdk/openai；示例的 @ai-sdk/openai-compatible 调用 /chat/completions。测试简短回复与只读文件查询，再查看 routerra.ai 用量中的模型。