OpenCode

1. 安装官方客户端

使用OpenCode 官方客户端。已安装可跳过：

此配置流程已在 npm 官方发行版 opencode-ai 1.18.35 验证，包含四种协议的供应商和模型加载。

终端复制

1npm install -g opencode-ai

2opencode --version

2. 获取当前可用模型

先在控制台创建 API Key。配置工具要求 Node.js 22 或更新版本；可以从Node.js 官网安装。Windows 使用 PowerShell，macOS / Linux 使用终端。

命令会在终端提示输入 Key，输入时不显示内容。不要把 Key 发给 AI 对话，也不要放进命令参数或截图。

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup models

工具通过您的 Key 查询 https://api.uniroute.app/v1/models。请从返回结果选择适合当前客户端的模型，复制完整 Model ID；本文中的 MODEL_ID 需要替换为该值。模型是否可用以目录返回结果和账户权限为准；真实调用仍需验证。

3. 配置 UniRoute

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure opencode --model MODEL_ID --dry-run

先检查预览，再写入配置：

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure opencode --model MODEL_ID

工具更新用户目录下的 .config/opencode/opencode.jsonc（已有 .json 配置时使用该文件），按模型协议建立 UniRoute 供应商并设置默认模型：

这些是 OpenCode 的供应商适配器，由客户端加载。接入 UniRoute 无需安装 oh-my-opencode。配置工具使用实时返回的 Model ID，不填入未经确认的上下文长度、输出限制或能力参数。

已有配置会保留无关设置；有变化的文件会先生成备份。--dry-run 不写文件；需要在隔离目录试用时，可加 --home /path/to/test-home。

4. 检查与使用

终端复制

1opencode

启动客户端后核对当前模型和 UniRoute 供应商。需要验证真实调用时，可自行发送一条简短消息，再到控制台查看调用记录；模型请求会按实际用量计费。配置和模型目录查询不会自动发起测试对话。

也可以安装UniRoute 配置 Skill，让 AI 按同样流程协助配置。