搜索文档...

开始输入以搜索文档

opencode
OpenCode

OpenCode 设置指南

将 UnoRouter 添加为 OpenCode 的自定义提供商,并选择任意模型作为当前的编码代理。

概览

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

快速配置

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

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

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

兼容性

Chat Completions流式传输工具调用

逐步设置

  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",
          "options": {
            "apiKey": "YOUR_API_KEY",
            "baseURL": "https://api.unorouter.ai/v1"
          }
        }
      }
    }

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

  3. 3
    保存并重新加载

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

  4. 4
    选择模型

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

推荐模型

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

devstral-2512qwen3-next-80b-a3b-instructc4ai-aya-vision-32bmistral-vibe-cli-with-toolsqwen3guard-gen-8b

注意事项

  • OpenCode 在底层使用 npm 的 @ai-sdk/openai-compatible 适配器,因此你可以在 "models" 下持续添加模型而无需重启。
  • 如果 Developer: Reload Window 未显示你的提供商,请再次检查 JSON 是否在保存时没有多余的尾随逗号。
  • 请使用 UnoRouter 目录中的精确模型 ID。如果复制粘贴时添加了前导提供商前缀,请将其去掉。
生成 API 密钥模型