OpenCode 接入配置

OpenCode 通过 AI SDK 连接自定义服务，一个 provider 条目只说一种协议。 UnioAPI 是多协议网关，每个模型按实际供给的入口协议上架——所以接入的全部要点是： 按协议把模型拆进对应的 provider 条目，放错协议的请求会在路由层直接失败。

1. 原理：模型跟着协议走

provider 条目的 npm 字段决定它使用哪种协议与请求路径：

每个模型支持哪些协议，见 GET /v1/models 响应中的 protocols 字段：

curl https://api.unioapi.com/v1/models -H "Authorization: Bearer $UNIO_API_KEY"

模型放错条目的表现：请求毫秒级失败并返回 503（routing_no_available_channel）—— 网关按入口协议筛选渠道，协议不匹配时没有任何可执行候选。例如把只有 anthropic 协议的 Claude 模型登记在 @ai-sdk/openai-compatible 条目下，就会稳定复现这个错误。

2. 安装 OpenCode

已安装的用户可直接跳到第 3 节。安装方式以 OpenCode 官方文档为准，常用方式：

npm install -g opencode-ai
opencode --version

3. 配置 opencode.json

先在工作台创建 API Key。然后在项目根目录创建 opencode.json（或编辑全局配置 ~/.config/opencode/opencode.json）， GPT 系与 Claude 系分成两个 provider 条目：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "unioapi-claude/claude-sonnet-5",
  "provider": {
    "unioapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UnioAPI",
      "options": {
        "baseURL": "https://api.unioapi.com/v1",
        "apiKey": "{env:UNIO_API_KEY}"
      },
      "models": {
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" }
      }
    },
    "unioapi-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "UnioAPI Claude",
      "options": {
        "baseURL": "https://api.unioapi.com/v1",
        "apiKey": "{env:UNIO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" }
      }
    }
  }
}

字段说明：

• provider id（unioapi、unioapi-claude）可任取，它会成为模型全名前缀 （如 unioapi-claude/claude-sonnet-5），顶层 model 用这个全名设置默认模型。
• baseURL 恒以 /v1 结尾，不要追加 /chat/completions 或 /messages—— 操作路径由 SDK 拼接。两个条目共用同一个 baseURL 与密钥。
• models 的键必须与平台模型 ID 完全一致，可用清单见 GET /v1/models。
• {env:UNIO_API_KEY} 从环境变量读取密钥（也支持 {file:~/.secrets/key}）， 避免明文写入配置。Anthropic 条目会以 x-api-key 头发送，平台两种鉴权头都接受。

导出密钥后启动，/models 命令中即可看到两组模型：

export UNIO_API_KEY="sk-unio-..."
opencode

4. 可选参数

Claude：扩展思考（thinking）

在模型条目的 options 里开启，budgetTokens 是单次思考预算：

"models": {
  "claude-sonnet-5": {
    "name": "Claude Sonnet 5",
    "limit": { "context": 200000, "output": 64000 },
    "options": {
      "thinking": { "type": "enabled", "budgetTokens": 16000 }
    }
  }
}

• budgetTokens 必须小于单次输出上限，思考产生的 token 按推理输出价计费。
• 建议同时声明 limit（context 上下文窗口 / output 单次输出上限， 数值按模型规格填写）：自定义 provider 拿不到公共模型库元数据， 不声明时 OpenCode 会采用保守默认值，长对话会被过早截断。

GPT：推理档位

OpenAI 协议模型用 reasoningEffort 控制推理力度，档位以模型规格为准：

"models": {
  "gpt-5.6-sol": {
    "name": "GPT-5.6 Sol",
    "options": {
      "reasoningEffort": "high",
      "textVerbosity": "low"
    }
  }
}

若需要 Responses 专属能力（推理摘要、加密推理内容续传），把该条目的 npm 换成 @ai-sdk/openai 走 POST /v1/responses，即可使用 reasoningSummary、 include: ["reasoning.encrypted_content"] 等选项。

变体（variants）：同一模型多档预设

为同一模型定义多套参数，会话中用 variant_cycle 快捷键循环切换， 不必登记重复模型：

"models": {
  "claude-sonnet-5": {
    "name": "Claude Sonnet 5",
    "variants": {
      "high": { "thinking": { "type": "enabled", "budgetTokens": 16000 } },
      "max": { "thinking": { "type": "enabled", "budgetTokens": 32000 } }
    }
  }
}

注意事项

• 两种协议的模型必须拆成两个 provider 条目，同一条目内的模型全部走同一协议。 最常见错误就是把 Claude 模型塞进 @ai-sdk/openai-compatible 条目——请求会秒失败。
• 新上架模型先查 GET /v1/models 的 protocols，再决定放进哪个条目。
• 模型 ID 区分大小写，登记后需重启 OpenCode 才会出现在 /models 选择器。
• 密钥始终用 {env:...} / {file:...} 注入；明文密钥一旦提交进仓库应立即在工作台轮换。

排障