搜索文档...

开始输入以搜索文档

opencode
OpenCode

OpenCode 设置指南

把 UnoRouter 添加为 OpenCode 的自定义提供商,并选择任意模型作为活动智能体。

概览

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

快速配置

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

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

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

兼容性

Chat Completions流式传输工具调用

逐步设置

  1. 1
    打开 OpenCode 配置文件

    在 OpenCode 中按 Ctrl + O 并粘贴路径。在 Windows 上,请把 YOUR_USER 替换成你的用户名。

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

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

  2. 2
    替换文件内容

    清空文件并粘贴 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。

  4. 4
    选择模型

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

推荐模型

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

ox-alpha:freeglm-5.3-search:freeglm-5.3-think-search:freeglm-5.3-thinking:freeglm-5.3:free

注意事项

  • 设置 "discoverModels": true 后,OpenCode 启动时会从 /v1/models 拉取 UnoRouter 的完整目录,因此无需逐条列出,所有模型都会出现在选择器中。
  • 如果 Developer: Reload Window 之后仍看不到你的提供商,请检查保存的 JSON 是否有多余的尾逗号。
  • 使用 UnoRouter 目录中的精确模型 id。复制粘贴时带上的提供商前缀请删掉。
  • 没有自动发现时,较旧的 OpenCode 需要一个列出精确 id 的 "models" 配置块(例如 {"gemini-3.1-flash-lite": {}})并重启。
生成 API 密钥模型