OpenCode 设置指南

概览

OpenCode 从 JSON 配置文件读取其提供商。使用兼容 OpenAI 的适配器将 UnoRouter 添加为自定义提供商，即可选择任意 UnoRouter 模型作为当前模型。

快速配置

将这些值填入客户端。登录后会自动填入你的密钥。

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

兼容性

逐步设置

1. 1
   打开 OpenCode 配置文件

   在 OpenCode 中按 Ctrl + O 并粘贴路径。在 Windows 上，将 YOUR_USER 替换为你的 Windows 用户名。

   text

   C:/Users/YOUR_USER/.config/opencode/opencode.json

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

2. 2
   替换文件内容

   清空文件并粘贴 UnoRouter 提供商配置块。填入你的 UnoRouter API 密钥，并从目录中选择任意模型。

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "discoverModels": true,
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         }
       }
     }
   }

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

3. 3
   保存并重新加载

   按 Ctrl + S 保存，然后按 Ctrl + Shift + P 运行 Developer: Reload Window。重新加载后 OpenCode 会识别新的提供商。

4. 4
   选择模型

   在 OpenCode 中打开模型选择器并切换到你添加的模型。兼容 OpenAI 的适配器会自动处理流式传输和工具调用。

推荐模型

在这里表现良好的免费模型。把任意模型 ID 粘贴到客户端即可。

注意事项

• !设置 "discoverModels": true 后，OpenCode 启动时会自动从 /v1/models 拉取完整的 UnoRouter 目录，因此无需手动列出，每个模型（包括新模型）都会出现在选择器中。
• !如果 Developer: Reload Window 未显示你的提供商，请再次检查 JSON 是否在保存时没有多余的尾随逗号。
• !请使用 UnoRouter 目录中的精确模型 ID。如果复制粘贴时添加了前导提供商前缀，请将其去掉。
• !在没有自动发现的旧版 OpenCode 上，添加 "models" 块并列出所需的准确 id（例如 {"gemini-3.1-flash-lite": {}}），然后重启。