Claude Desktop 串接第三方 API：Configure Third-Party Inference 設定與排錯

Wokey Team · 2026-09-24

簡短回答： Claude 桌面版使用第三方 API 的方法只有一個：Developer → Configure Third-Party Inference。它既不讀 ANTHROPIC_BASE_URL，也不讀 ~/.claude/settings.json，所以在終端機能用的設定，在桌面版完全沒有作用。本文逐一說明常見的問題：找不到選單、設定沒有生效、模型清單是空的，以及第三方模式下本來就無法使用的功能。完整的首次設定請見 Claude Desktop 設定指南。

正確的順序

1. 啟動桌面版，不要登入 Anthropic 帳號。

2. 開啟 Help → Troubleshooting → Enable Developer Mode。

3. 開啟 Developer → Configure Third-Party Inference…。

4. 在 Connection 中把 Inference provider 設為 Gateway，然後填寫 Gateway credentials：

   欄位	值
   Gateway base URL	https://api.wokey.ai（不加 /v1）
   Gateway API key	你的 Wokey API 金鑰
   Credential kind	Static API key
   Gateway auth scheme	Bearer（Wokey 也接受 x-api-key；保留預設即可）

5. 點 Apply Changes，再點 Save & Restart。

系統需求：

• macOS： 14（Sonoma）以上，Apple 晶片或 Intel 皆可。
• Windows： Windows 10 組建 19041 以上，x64 或 Arm64。

找不到 Developer 選單

Developer 選單只在開啟開發者模式後才會出現：Help → Troubleshooting → Enable Developer Mode。如果 Help 選單裡也沒有這個項目，請把應用程式更新到最新版本；舊版本沒有第三方推論設定。

設定視窗是唯讀的

如果電腦上已經有管理員推送的設定，例如公司的 MDM 設定描述檔，視窗會以唯讀方式開啟，無法在本機修改。請洽詢管理員，或改用未受管理的電腦。

環境變數沒有作用

這是最常見的錯誤。桌面版只從第三方推論設定讀取閘道設定。它既不讀 ANTHROPIC_BASE_URL，也不讀 settings.json。

桌面版的 Code 分頁也是一樣。它執行的是和 CLI 相同的 Claude Code 引擎，但閘道位址和憑證直接來自桌面版的設定。~/.claude/settings.json 中的使用者層級設定無法覆蓋它們。

反過來也一樣：桌面版的設定不會影響終端機中的 claude。兩者要各自設定；終端機的部分請見 Claude Code base URL 設定指南。

模型清單是空的或缺少模型

沒有自訂模型清單時，應用程式會請求閘道的 GET /v1/models，並且只保留 ID 看得出是 Claude 的模型。因此串接 Wokey 時，自動探索會顯示 claude-opus-5、claude-sonnet-5 等模型，GPT、Grok 等其他模型會被過濾掉。這是預期行為。

要固定清單或選擇預設模型，請在設定視窗的模型清單（Model list，鍵名為 inferenceModels）中填入完整的模型 ID：

• 第一個項目就是預設值，Code 分頁的新工作階段也會從它開始。
• 所有項目都是完整 ID 時，應用程式會略過 /v1/models 請求。
• 如果 /v1/models 失敗、清單又是空的，模型選擇器就會是空的。

錯誤

Gateway was unreachable： 應用程式連不到閘道。檢查 Gateway base URL 有沒有打錯，再從終端機用 curl 測試：

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

如果 curl 可以而應用程式不行，原因通常是代理：終端機走代理而應用程式沒有，或反過來。

401 且 code 為 invalid_api_key： 請求到了 Wokey，但金鑰缺少或錯誤。Wokey 兩種驗證方式都接受，不需要改那個設定。請重新貼上金鑰。

invalid x-api-key： 請求送到了 Anthropic，表示第三方設定沒有生效。通常是沒有點 Save & Restart，或之後在登入畫面選了 Anthropic 登入。詳見 invalid x-api-key 排查指南。

需要更多細節時： 用 Help → Troubleshooting → Generate Diagnostic Report 匯出報告。其中有三個檔案很有用：

• managed-config.txt：目前生效的設定。
• provider-status.txt：閘道連線狀態。
• deployment-mode.txt：目前的模式。

記錄檔位置：

• macOS：~/Library/Logs/Claude-3p/main.log
• Windows：%LOCALAPPDATA%\Claude-3p\Logs\main.log

第三方模式下無法使用的功能

以下功能依賴 Anthropic 帳號或 Anthropic 的雲端服務，所以使用閘道時無法使用。這不是設定問題：

• 行動裝置與 claude.ai 網頁版存取
• 語音模式
• 專案與外掛分享
• Claude Design、Claude Security 和 Claude Tag
• Computer use
• Remote Control 和 Anthropic 託管的雲端環境

另外還有兩項預設關閉：

• 工具搜尋和實驗性 beta 功能。 為了相容較嚴格的閘道，應用程式會關閉它們。工具搜尋可以用 toolSearchEnabled 重新開啟。
• SSH 遠端工作階段。 在第三方模式下仍是 beta，需要管理員設定主機允許清單。

回到 Anthropic 帳號

在登入畫面選擇 Anthropic 登入選項，就會回到標準的 Claude 桌面版。