Claude Desktop
用 Claude Desktop 的第三方推理模式,把對話、Cowork 和 Code 接到 HopBase。
Claude Desktop 是 Anthropic 的桌面應用程式。它的「第三方推理」模式(Claude Desktop on 3P)可以把請求送到任何實作 Anthropic Messages 介面的閘道,HopBase 以閘道方式接入。
| 設定項 | 填什麼 |
|---|---|
| Inference provider | Gateway |
| Gateway base URL | https://api.hop-base.com(不帶 /v1) |
| Gateway API key | Claude 分組的金鑰 |
| Credential kind | Static API key(預設) |
| Gateway auth scheme | Bearer(預設) |
開始前準備
從 claude.com/download 安裝 Claude Desktop。官方系統需求是 macOS 14 以上,或 Windows 10 2004 以上;Windows 請用 .msix 安裝檔,舊的 .exe 安裝檔沒有 Cowork。
在控制台「API 金鑰」頁準備一把 Claude Max(官號滿血版) 分組的金鑰。Claude Max(ccmax)分組只放行 Claude Code 用戶端,不要用在 Claude Desktop。
第三方推理模式不登入 Anthropic 帳號,對話記錄只保存在本機。claude.ai 網頁版、手機版和語音模式在這個模式下無法使用。
設定步驟
開啟開發者模式
啟動應用程式,停在登入畫面,不要登入。macOS 在上方選單列、Windows 在登入畫面左上角的 ☰ 選單,依序點 Help → Troubleshooting → Enable Developer Mode。
開啟第三方推理設定視窗
點 Developer → Configure Third-Party Inference…。
填寫連線資訊
在 Connection 裡把 Inference provider 設為 Gateway,再依上表填 Base URL 和金鑰,其餘兩項維持預設。
套用並重新啟動
點 Apply Changes,再點 Save & Restart。應用程式重新啟動後,在登入畫面選擇以第三方推理模式啟動。
傳一則測試訊息
新建對話,請它只回一個詞。成功後到控制台「使用記錄」能看到這次請求。
選擇模型
模型清單可以留空,應用程式啟動時會呼叫 GET /v1/models 自動讀取。選擇器是空的,或出現呼叫不通的模型時,在設定視窗的 Models 裡手動填寫模型 ID,第一個是預設模型。
claude-opus-5
claude-sonnet-5只填目前金鑰呼叫 GET /v1/models 回傳的 ID,區分大小寫。
能用哪些功能
依官方功能表,第三方推理模式下的對話(Chat)、Cowork 和 Code 都透過閘道呼叫模型,也就是全部走 HopBase。專案、Artifacts、本機與遠端 MCP、技能與外掛同樣可用。
更多細節
先在應用程式裡登出,回到登入畫面,再依上面的步驟操作。要切回一般模式,在登入畫面選擇 Anthropic 登入即可,第三方推理設定會保留。
官方說明:閘道不轉送 Anthropic 伺服器端工具時,聯網搜尋需要先在設定視窗裡另外設定一個搜尋服務。不需要聯網搜尋時可以忽略。
- 重新啟動後仍是 claude.ai 登入畫面:代表設定沒被讀取。完全結束應用程式再開啟,並確認 Inference provider 是 Gateway。
- 查看應用程式實際讀到的設定:點 Help → Troubleshooting → Generate Diagnostic Report 匯出診斷包,看其中的
managed-config.txt和provider-status.txt。 - 電腦裝了公司派發的 Claude 設定檔時,設定視窗是唯讀的,請聯絡管理員。
- 401:金鑰填錯,或金鑰不屬於 Claude 分組。
- 404:Base URL 多寫了
/v1,請求變成/v1/v1/messages。
其他錯誤見報錯速查。
下一步
- Claude Code:在終端機裡使用同一批 Claude 模型
- Anthropic SDK:在自己的程式裡呼叫 Claude
- 報錯速查:依錯誤原文排查