目录
在用 AI 辅助编程或日常协作时，很多朋友都会遇到一个极其繁琐的痛点：今天想用 DeepSeek 写复杂逻辑，明天想用通义千问 Qwen 处理中文长文本，后天又想用 MiniMax 做快速测试。
在传统的做法下，你必须：
- 分别去 DeepSeek 开放平台、阿里云百炼、MiniMax 开发者后台注册账号；
- 在每个平台单独绑卡充值（甚至还要担心每个账号的余额见底）；
- 分别创建、复制和保存一堆长串的 API Key；
- 工具或客户端切换模型时，来回在各个后台翻找 Key 和不同格式的端点 URL。
光是维护这些账号和凭证，就足以劝退不少开发者。
最近有读者问我：WorkBuddy 能不能接入 OpenCode？
我自己动手深度折腾了一番，不仅完全可行，而且比想象中简单得多——只需要搞清楚接口端点与模型命名规则，3 步就能把 WorkBuddy 变成一个随心切换的“本地模型超市”。
一、 为什么选择 WorkBuddy + OpenCode 组合？
OpenCode 本质上是一个高性价比的 AI API 聚合与分发平台。它的核心杀手锏非常纯粹：一个账户、一个 API Key、统一计费，聚合调度多家主流大模型。
DeepSeek、Qwen、MiniMax、MIMO 全部在一个后台集中管理。不用再为每一个模型分别充值和维护账户。你可以直接通过我的 OpenCode 专属订阅邀请链接（点击直达） 注册并领取 Go 套餐权益。
而 WorkBuddy 作为一款体验出色的 AI 桌面开发与效率助手，原生提供了非常开放的「自定义模型（Custom Model）」扩展能力。
当两者结合后：
- 你只需要在 OpenCode 维持一个账户余额；
- WorkBuddy 拥有了无限扩展的模型后端；
- 随时在聊天面板和代码生成中一键切换底座模型，体验极其顺畅。
二、 官方模型兼容性实测
为了避免大家踩坑，我将主流模型在 WorkBuddy 下逐个进行了联调整合测试，实测兼容情况如下表所示：
| 模型系列 | 实测状态 | 使用体验与建议 |
|---|---|---|
| DeepSeek | ✅ 完美支持 | 逻辑推导与代码生成能力稳定，综合性价比极高 |
| Qwen（通义千问） | ✅ 完美支持 | 中文语义理解深刻，长上下文指令遵循到位 |
| MiniMax | ✅ 完美支持 | 响应极快，适合日常对话与轻量脚本编写 |
| MIMO（小米） | ✅ 完美支持 | 速度与文本表现均衡，适合通用辅助 |
| GLM（智谱） | ❌ 偶发 401 | 认证校验存在特殊鉴权机制，需等待官方协议对齐 |
提示：智谱 GLM 在初期联调时偶发 401 Unauthorized 报错，主要是其鉴权签名与标准 OpenAI 协议在部分参数转发时存在出入。如果你主要使用 DeepSeek、Qwen 或 MiniMax，直接接入即可无缝起飞。
三、 3 步接入实操配置
整个配置过程不需要修改任何底层配置文件，直接在 WorkBuddy 的图形界面即可完成。耗时不到 3 分钟。
第 1 步：进入自定义模型管理
打开 WorkBuddy 客户端：
- 点击左侧工具栏或输入框下方的模型选择器；
- 滑动到模型列表最底部，点击 「配置自定义模型」（Configure Custom Model）；
- 点击 「添加新模型」 进入详细参数面板。
第 2 步：填入 OpenCode 接口与密钥信息
在弹出的配置表单中，我们需要重点关注并正确填写以下 3 个核心字段：
[提供商类型 / Provider]: Custom (OpenAI Compatible)
[接口地址 / Base URL ]: https://opencode.ai/zen/go/v1 (或 Zen 对应地址)
[API Key ]: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx
[模型名称 / Model ID ]: deepseek-chat (以 OpenCode 官方命名为准)
⚠️ 重点避坑：搞清 OpenCode Go 与 Zen 的接口端点
很多朋友在这里配置失败，90% 都是因为混淆了 OpenCode 的两套接口路由：
- OpenCode Go 接口：
https://opencode.ai/zen/go/v1（包含 Go 套餐所支持的开源模型集合，订阅通道：opencode.ai/go?ref=4S005HCG8T） - OpenCode Zen 接口：
https://opencode.ai/zen/v1（标准 Zen 聚合路由）
两者的接口地址与模型列表是不通用的，务必根据你订阅的 OpenCode 套餐与控制台显示的 EndPoint 保持绝对一致。
第 3 步：选定模型并进行连通性测试
完成填写后保存配置：
- 回到 WorkBuddy 聊天或编程主界面；
- 在模型下拉列表中，即可看到刚刚添加的自定义模型标签；
- 直接发送一句测试消息：
你好，请简要介绍一下你自己和当前上下文。
如果收到模型正常的流式输出回答，说明整套鉴权、反向代理转发与本地解析链路已完全打通！
四、 常见报错与排错指南
1. 报 401 Unauthorized 错误？
- 检查 Key 首尾空格：从浏览器复制 API Key 时，经常会不小心多复制一个不可见空格或换行符，清空后重新贴入；
- 接口端点是否匹配：确认使用的是
/zen/go/v1还是/zen/v1，如果买了 Go 套餐填了 Zen 地址，会被直接拒签； - 账户余额与套餐状态：登录 OpenCode 控制台，确认账户内是否有额度或套餐是否处于激活状态。
2. 模型列表为空或下拉无法选择？
- 在 WorkBuddy 中添加模型时，
Model ID（模型名称）必须与 OpenCode 后台提供的模型标识符逐字匹配（大小写敏感），不要随意使用自创的别名。
五、 总结
通过 WorkBuddy + OpenCode 的搭配，我们用最低的维护成本，在本地拥有了一座随取随用的多模型军火库。不需要在不同厂商后台之间来回横跳，也不用在本地配置繁杂的反向代理工具，3 步配置即可兼顾高可用性与高性价比。
如果你还没有开通套餐，推荐使用博主专属的 OpenCode 优惠邀请链接注册，首月享受折扣优惠，一站式搞定开源顶级模型聚合。