目錄
  1. 一、 為什麼選擇 WorkBuddy + OpenCode 組合？
  2. 二、 官方模型相容性實測
  3. 三、 3 步接入實操設定
  4. 第 1 步：進入自定義模型管理
  5. 第 2 步：填入 OpenCode 介面與金鑰資訊
  6. 第 3 步：選定模型並進行連通性測試
  7. 四、 常見報錯與排錯指南
  8. 1. 報 401 Unauthorized 錯誤？
  9. 2. 模型列表為空或下拉無法選擇？
  10. 五、 總結

WorkBuddy 接入 OpenCode 全攻略：3 步把 DeepSeek、Qwen 聚合進你的本機模型超市

在用 AI 輔助程式設計或日常協作時，很多朋友都會遇到一個極其繁瑣的痛點：今天想用 DeepSeek 寫複雜邏輯，明天想用通義千問 Qwen 處理中文長文字，後天又想用 MiniMax 做快速測試。

在傳統的做法下，你必須：

  1. 分別去 DeepSeek 開放平臺、阿里雲百鍊、MiniMax 開發者後臺註冊帳號；
  2. 在每個平臺單獨綁卡充值（甚至還要擔心每個帳號的餘額見底）；
  3. 分別建立、複製和儲存一堆長串的 API Key；
  4. 工具或用戶端切換模型時，來回在各個後臺翻找 Key 和不同格式的端點 URL。

光是維護這些帳號和憑證，就足以勸退不少開發者。

最近有讀者問我：WorkBuddy 能不能接入 OpenCode？

我自己動手深度折騰了一番，不僅完全可行，而且比想像中簡單得多——只需要搞清楚介面端點與模型命名規則，3 步就能把 WorkBuddy 變成一個隨心切換的「本機模型超市」。

一、 為什麼選擇 WorkBuddy + OpenCode 組合？

OpenCode 本質上是一個高性價比的 AI API 聚合與分發平臺。它的核心殺手鐧非常純粹：一個帳戶、一個 API Key、統一計費，聚合排程多家主流大模型。

DeepSeek、Qwen、MiniMax、MIMO 全部在一個後臺集中管理。不用再為每一個模型分別充值和維護帳戶。你可以直接通過我的 OpenCode 專屬訂閱邀請連結（點選直達） 註冊並領取 Go 方案權益。

而 WorkBuddy 作為一款體驗出色的 AI 桌面開發與效率助手，原生提供了非常開放的「自定義模型（Custom Model）」擴充功能能力。

WorkBuddy 與 OpenCode 聚合閘道器協同架構

當兩者結合後：

  • 你只需要在 OpenCode 維持一個帳戶餘額；
  • WorkBuddy 擁有了無限擴充功能的模型後端；
  • 隨時在聊天面板和程式碼生成中一鍵切換底座模型，體驗極其順暢。

二、 官方模型相容性實測

為了避免大家踩雷，我將主流模型在 WorkBuddy 下逐個進行了聯調整合測試，實測相容情況如下表所示：

模型系列 實測狀態 使用體驗與建議
DeepSeek ✅ 完美支援 邏輯推導與程式碼生成能力穩定，綜合性價比極高
Qwen（通義千問） ✅ 完美支援 中文語義理解深刻，長上下文指令遵循到位
MiniMax ✅ 完美支援 響應極快，適合日常對話與輕量腳本編寫
MIMO（小米） ✅ 完美支援 速度與文字表現均衡，適合通用輔助
GLM（智譜） ❌ 偶發 401 認證校驗存在特殊鑑權機制，需等待官方協議對齊

提示：智譜 GLM 在初期聯調時偶發 401 Unauthorized 報錯，主要是其鑑權簽名與標準 OpenAI 協議在部分參數轉發時存在出入。如果你主要使用 DeepSeek、Qwen 或 MiniMax，直接接入即可無縫起飛。

三、 3 步接入實操設定

整個設定過程不需要修改任何底層設定檔，直接在 WorkBuddy 的圖形介面即可完成。耗時不到 3 分鐘。

WorkBuddy 接入 OpenCode 3 步實操指南

第 1 步：進入自定義模型管理

開啟 WorkBuddy 用戶端：

  1. 點選左側工具欄或輸入框下方的模型選擇器；
  2. 滑動到模型列表最底部，點選 「設定自定義模型」（Configure Custom Model）；
  3. 點選 「新增新模型」 進入詳細參數面板。

第 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 步：選定模型並進行連通性測試

完成填寫後儲存設定：

  1. 回到 WorkBuddy 聊天或程式設計主介面；
  2. 在模型下拉式清單中，即可看到剛剛新增的自定義模型標籤；
  3. 直接傳送一句測試訊息：你好，请简要介绍一下你自己和当前上下文。

如果收到模型正常的流式輸出回答，說明整套鑑權、反向代理轉發與本機解析鏈路已完全打通！

四、 常見報錯與排錯指南

1. 報 401 Unauthorized 錯誤？

  • 檢查 Key 首尾空格：從瀏覽器複製 API Key 時，經常會不小心多複製一個不可見空格或換行符，清空後重新貼入；
  • 介面端點是否匹配：確認使用的是 /zen/go/v1 還是 /zen/v1，如果買了 Go 方案填了 Zen 地址，會被直接拒籤；
  • 帳戶餘額與方案狀態：登入 OpenCode 控制台，確認帳戶內是否有額度或方案是否處於啟用狀態。

2. 模型列表為空或下拉無法選擇？

  • 在 WorkBuddy 中新增模型時，Model ID（模型名稱）必須與 OpenCode 後臺提供的模型識別符號逐字匹配（大小寫敏感），不要隨意使用自創的別名。

五、 總結

通過 WorkBuddy + OpenCode 的搭配，我們用最低的維護成本，在本機擁有了一座隨取隨用的多模型軍火庫。不需要在不同廠商後臺之間來回橫跳，也不用在本機設定繁雜的反向代理工具，3 步設定即可兼顧高可用性與高性價比。

如果你還沒有開通方案，推薦使用博主專屬的 OpenCode 優惠邀請連結註冊，首月享受折扣優惠，一站式搞定開源頂級模型聚合。