Claude Desktop 設定教學（桌面用戶端）
Claude Desktop 是 Anthropic 的官方桌面用戶端（Windows / macOS）。它內建「第三方推理閘道」設定入口，不登入官方帳號也能把對話請求接到 NextHub。
和 Claude Code 是兩回事
Claude Desktop（桌面用戶端）和 Claude Code（命令列 / VS Code 外掛）是兩個獨立產品，設定互不相通，需要分別設定。這一頁說的是桌面用戶端；命令列設定請看手動設定 Claude Code。
準備工作
- 一個 Claude 系分組的 ApiKey：claude code（0.37x）、Claude Max（0.5x）或 Claude-AWSB（0.7x），見 ApiKey 管理。Claude Desktop 走 Anthropic Messages 協定，位址口徑與 Claude Code 相同
- 從 claude.com/download 下載對應系統的安裝包
Windows 安裝注意
Windows 安裝程式執行時需要連線到 Anthropic 官方服務。如果你的網路環境無法直連，可以在安裝程式所在目錄開啟 cmd，設定 Proxy 環境變數後再啟動安裝程式（連接埠換成你自己的）：
set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"macOS 直接正常安裝即可。
手動設定（開發者模式）
1. 開啟開發者模式
開啟 Claude Desktop 進入登入介面：
- Windows：滑鼠點擊郵件輸入框取得焦點，用
Tab鍵把焦點切到左上角選單，按 Enter 依序進入 Help → Troubleshooting → Enable developer mode - macOS：直接在左上角選單中依序進入 Help → Troubleshooting → Enable developer mode
開啟後等待軟體自動重新啟動。
2. 設定第三方推理閘道
用同樣的方法開啟選單，依序進入 Developer → Configure third-party inference，按下表填寫：
| 欄位 | 填寫內容 |
|---|---|
| Gateway base URL | https://api.nexthub.cc |
| Gateway auth scheme | x-api-key |
| Gateway API key | 你的 NextHub ApiKey（Claude 系分組） |
| Skip login-mode chooser | 開啟 |
點擊右下角 Apply locally 使設定生效。
不要等「測試通過」
這個頁面走的是第三方閘道模式，不是 Anthropic 官方帳號登入驗證，不會有、也不用等一個「連線成功 / 測試通過」的提示。點完 Apply locally 直接回對話視窗發訊息，能收到回覆就表示設定生效。
3. 驗證
開啟新對話並傳送一則訊息，能正常收到 Claude 回覆即連線成功。
第一則訊息的小額呼叫
開啟新對話後，消費紀錄裡可能會出現一筆與你所選模型不同的小額呼叫——這是用戶端自動為對話起標題產生的，金額很小，屬正常現象。
用 CC-Switch 設定（可選）
嫌手動流程麻煩？CC-Switch 內建 Claude Desktop 面板，支援一鍵匯入 Claude Code 裡已設定的供應商：
- 開啟 CC-Switch，在左側應用程式切換器選擇 Claude Desktop（找不到時去 設定 → 一般 → 應用程式可見性 確認入口未被隱藏）
- 首次進入點擊「將 Claude Code 中已有的供應商匯入」；或點右上角
+手動新增：介面位址填https://api.nexthub.cc，API Key 填 Claude 系分組的金鑰 - 在供應商卡片上點擊「啟用」，然後完全結束並重新開啟 Claude Desktop（它不像 Claude Code 那樣會熱重載設定，關閉視窗不等於結束程式）
重新啟動後的兩個警告是誤報
完全重新啟動後，對話頁面可能會彈出「設定未驗證」「網路連線」之類的警告訊息——這是閘道模式的常見誤報，直接忽略，能正常收發訊息就代表設定生效。若收不到回覆，請依序檢查：CC-Switch 是否正在執行、介面位址與 ApiKey 是否填對、是否忘了完全重新啟動。