OpenCode 设置指南

概览

OpenCode 从 JSON 配置中读取提供商。用 OpenAI 兼容适配器添加 UnoRouter，即可使用任意 UnoRouter 模型。

快速配置

把这些粘贴到客户端。已登录时会自动填入你的密钥。

基础 URL: https://api.unorouter.com/v1
API 密钥: YOUR_API_KEY

兼容性

逐步设置

1. 1
   打开 OpenCode 配置文件

   用文本编辑器打开 OpenCode 配置文件。如果文件不存在，请新建一个。

   WindowsmacOSLinux

   powershell

   $f = "$env:USERPROFILE\.config\opencode\opencode.json"
   md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f

   登录以自动填入您的 API 密钥

2. 2
   替换文件内容

   把 UnoRouter 的 provider 配置块添加到你的配置中。请与现有文件合并，保留你已有的 mcp 或 agent 配置块。

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter-live": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         },
         "models": {
           "ling-3.1-flash:free": {},
           "agnes-3.0-flash:free": {},
           "minicpm5-2b:free": {},
           "k2-horizon:free": {},
           "qwen3.8-flash-next:free": {}
         }
       }
     }
   }

   登录以自动填入您的 API 密钥

3. 3
   验证模型是否加载

   保存文件，然后在终端运行 opencode models。你列出的每个 id 都应显示出来，并带上你的 provider 键作为前缀。

   bash

   opencode models

   登录以自动填入您的 API 密钥

4. 4
   选择模型

   打开模型选择器并切换到新模型。适配器会处理流式输出和工具调用。

推荐模型

在这里可用的免费模型。把任意模型 id 粘贴到客户端即可。

注意事项

• !OpenCode 对 OpenAI 兼容的 provider 没有实时模型发现功能。你想使用的每个模型，都必须以准确的 id 写进 "models" 配置块。
• !不要把 provider 键直接命名为 "unorouter"。该 id 已存在于 models.dev 注册表中，OpenCode 会改用注册表的列表而不是你的列表，导致较新的模型缺失。上面的 "-live" 后缀可以避开冲突。
• !请使用 UnoRouter 目录中准确的模型 id。删除复制粘贴时带上的 provider 前缀，若 id 带有 :free 后缀则保留。
• !自定义 provider 键若缺少 "models" 配置块，就会加载到零个模型，该 provider 会从选择器中彻底消失。