OpenCode 接入

OpenCode 是开源的终端 AI 编程助手，通过配置文件声明 OpenAI 兼容的自定义提供商即可接入 Router。

• 协议：OpenAI Chat Completions
• 接入地址：https://routerapi.<你的域名>/v1

准备工作

1. 登录 Router 控制台，签发一个 Key 并保存明文
2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址

安装

npm install -g opencode-ai

其他安装方式（Homebrew 等）见 OpenCode 官方文档。

配置

编辑 OpenCode 配置文件 ~/.config/opencode/opencode.json（不存在则新建），声明一个自定义提供商：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "veyra-router": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "VeyraOS Router",
      "options": {
        "baseURL": "https://routerapi.<你的域名>/v1",
        "apiKey": "<你的 Key>"
      },
      "models": {
        "<模型名>": { "name": "<模型名>" }
      }
    }
  },
  "model": "veyra-router/<模型名>"
}

• <模型名> 从控制台「可用模型」列表选择（models 里可以登记多个）
• model 字段设置默认模型，格式为 <提供商>/<模型名>

验证

opencode

进入 TUI 后发一条消息。正常回复即接入成功；控制台「调用记录」出现调用明细。

常见问题

Q：提示 provider 不存在或模型找不到？ 检查 model 字段格式必须是 veyra-router/<模型名>，且该模型已在 models 中登记。

Q：401 鉴权失败？ 检查 apiKey 是否完整粘贴。也可以把 apiKey 换成 { "env": "OPENAI_API_KEY" } 形式从环境变量读取，避免 Key 落盘。