OpenCode 配置｜云桥API教程

1. 准备 OpenCode 和 API Key

先按 OpenCode 官方安装说明安装命令行版，确认在 Windows PowerShell 或 macOS 终端中输入 opencode 能启动。

还没有 API Key？观看视频教程获取。

本文使用 OpenCode 1.x 的 provider 配置格式。可用 opencode --version 查看版本；2.x 配置结构不同，不要直接套用本文 JSON。

2. 打开配置文件

已有配置时，先复制一份文件备份。以下使用默认的全局配置目录；如曾自定义配置路径，请编辑实际使用的文件。

Windows（PowerShell）

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\opencode" | Out-Null notepad "$env:USERPROFILE\.config\opencode\opencode.json"

记事本提示文件不存在时创建，另存为选择“所有文件”和 UTF-8，文件名为 opencode.json，不要多出 .txt。

macOS（终端）

mkdir -p ~/.config/opencode touch ~/.config/opencode/opencode.json open -a TextEdit ~/.config/opencode/opencode.json

文本编辑使用“格式 → 制作纯文本”，粘贴后按 Command + S 保存。Windows 使用 PowerShell，不能将上述 macOS 命令直接粘贴到 CMD。

3. 填写云桥配置

新文件粘贴下面完整内容。已有文件只合并对应字段，保留原来的其他设置。

{ "$schema": "https://opencode.ai/config.json", "model": "yunqiao/gpt-5.6-sol", "provider": { "yunqiao": { "npm": "@ai-sdk/openai-compatible", "name": "云桥", "options": { "baseURL": "https://ai.aiyq.cloud/v1" }, "models": { "gpt-5.6-sol": { "name": "GPT-5.6 Sol" } } } } }

这里不填写 Key，第 4 步会单独保存。gpt-5.6-sol 沿用本站示例，请确认账户支持该模型；更换时同时修改 models 下的模型 ID 和顶部 model 中斜杠后的名称。

此示例使用 Chat Completions 接口。如果云桥明确要求该模型使用 Responses 协议，将 @ai-sdk/openai-compatible 换为 @ai-sdk/openai；地址仍填 https://ai.aiyq.cloud/v1。

4. 输入 Key 并选择模型

保存文件，重新打开 OpenCode。Windows 在 PowerShell、macOS 在终端输入：

opencode

进入 OpenCode 的对话界面后输入以下命令（不是在系统终端里输入）：

/connect

选择 Other → 供应商 ID 填 yunqiao → 粘贴云桥 API Key。这个 ID 必须与配置一致。

然后输入：

/models

选择“云桥”下的模型，发送“你好”测试。检查云桥用量记录出现对应请求，即可确认接入。

5. 常见问题

找不到云桥模型确认文件名是 opencode.json，保存后重新打开；检查 JSON 逗号、括号，以及 /connect 的 ID 是否为 yunqiao。

401 / 403重新执行 /connect 更新云桥 Key，并检查额度与模型权限。

404 / 不支持接口检查 baseURL 以 /v1 结尾、模型 ID 是否可用，以及模型要求 Chat Completions 还是 Responses。

配置了但仍用其他模型执行 /models 手动选择；项目内的 opencode.json 可能覆盖全局默认模型。

参考：OpenCode 官方自定义供应商说明 · 全局配置说明。