OpenCode Desktop 接入 HiyoAPI 简易配置教程

适用场景：Windows 版 OpenCode Desktop / OpenCode PC 端应用，通过 HiyoAPI 中转站接入模型。

1. 配置文件位置

OpenCode PC 端建议使用下面这个配置文件：

%USERPROFILE%\.config\opencode\opencode.json

一般对应路径类似：

C:\Users\你的用户名\.config\opencode\opencode.json

2. 打开配置文件

在 Windows PowerShell 中执行：

mkdir "$env:USERPROFILE\.config\opencode" -Force
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

3. 写入 HiyoAPI 配置

将下面内容复制进去，并把 你的HiyoAPIKey 替换成自己的 HiyoAPI Key。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "hiyo/gpt-5.5",
  "provider": {
    "hiyo": {
      "npm": "@ai-sdk/anthropic",
      "name": "HiyoAPI",
      "options": {
        "baseURL": "https://api.hiyo.top/v1",
        "apiKey": "你的HiyoAPIKey"
      },
        "models": {
        "gpt-5.5": {
            "name": "gpt-5.5",
            "limit": {
            "context": 1050000,
            "output": 128000
            }
        }
        }
    }
  }
}

关键点：

provider id：hiyo
model id：gpt-5.5
最终模型名：hiyo/gpt-5.5
baseURL：https://api.hiyo.top/v1
npm provider：@ai-sdk/anthropic

4. 重启 OpenCode Desktop

保存配置文件后，需要完全退出 OpenCode Desktop。

5. 在 OpenCode 中选择模型

重新打开 OpenCode Desktop 后，新建会话测试：

你好，只回复一句话

此时可得到正常回复，即配置成功。