跳到正文

Claude Desktop

用 Claude Desktop 的第三方推理模式,把對話、Cowork 和 Code 接到 HopBase。

Claude Desktop 是 Anthropic 的桌面應用程式。它的「第三方推理」模式(Claude Desktop on 3P)可以把請求送到任何實作 Anthropic Messages 介面的閘道,HopBase 以閘道方式接入。

設定項填什麼
Inference providerGateway
Gateway base URLhttps://api.hop-base.com(不帶 /v1)
Gateway API keyClaude 分組的金鑰
Credential kindStatic API key(預設)
Gateway auth schemeBearer(預設)

開始前準備

從 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、技能與外掛同樣可用。

更多細節

下一步