Claude Desktop × AIHubMix 設定指南

適用版本:Claude Desktop 1.3883.0(更新日期:2026 年 4 月 23 日)
難度:入門 — 無需指令列,完全點擊操作,無需 Anthropic 帳號

​

介紹

• 無需 Anthropic 帳號 — 跳過手機/電子郵件註冊限制
• 透過單一 AIHubMix 金鑰存取 Claude、GPT、Gemini、DeepSeek 等模型
• 用多少付多少的計費方式,彈性且成本可控

​

前置需求

• 作業系統: macOS 13.0(Ventura)或更新版本,或 Windows 10 / 11
• AIHubMix 帳號: 在 aihubmix.com 註冊並儲值

​

步驟 1:取得您的 AIHubMix API Key

1. 造訪 aihubmix.com 並登入
2. 進入控制台 → API Keys 頁面
3. 點擊 建立新 Key,輸入名稱(例如 claude-desktop)
4. 複製產生的金鑰(格式:sk-xxxxxxxxxxxxxxxx)

安全提醒: API Key 只會顯示一次。請立即將其儲存於安全的地方。

​

步驟 2:下載並安裝 Claude Desktop

1. 造訪官方下載頁:claude.ai/download
2. 下載適合您作業系統的安裝程式

• 開啟下載的 .dmg 檔案
• 將 Claude.app 拖曳到 應用程式 資料夾
• 從 Launchpad 或應用程式資料夾開啟 Claude

• 執行下載的 .msix 安裝程式
• 依畫面指示完成安裝
• 從「開始」功能表開啟 Claude

注意:開啟後無需登入 Anthropic 帳號。直接進入下一步。

​

步驟 3:啟用 Developer Mode 並設定 AIHubMix

1. 開啟 Claude Desktop 應用程式
2. 點擊頂部選單列的 Help
3. 選擇 Troubleshooting
4. 點擊 Enable Developer mode
   
5. 啟用後,頂部選單列會新增一個 Developer 選單。

6. 點擊選單列的 Developer,然後選擇 Configure third-party inference

7. 在設定對話框中填入以下欄位:

https://aihubmix.com

sk-xxxxxxxxxxxxxxxx

8. 點擊 Apply locally → Relaunch

9. 重新啟動後,在下方畫面中選擇 Continue with Gateway

​

步驟 4:設定模型並驗證

claude-g-p-t-5.5 -> gpt-5.5
claude-gemi-3.1 -> gemini-3.1-pro-preview
claude-depsek-v4 -> deepseek-v4-flash

• Model ID 使用 claude- 前綴。
• 不要直接寫 gpt、gemini、deepseek 等真實模型系列名，可使用 g-p-t、gemi、depsek 等別名。
• Model ID 必須和 AIHubMix 映射左側逐字元一致，否則請求不會命中預期映射。

主模型失敗時自動切換備用模型、按最終回應模型計費等更多用法，見 模型映射與回退。

注意：預設模型為 Claude Opus 4.7，定價較高，日常使用可能造成不小的費用。建議切換到其他模型；AIHubMix 提供多款性價比高與免費的模型 — 完整清單請見 aihubmix.com/models。

• 左側導覽面板出現 Cowork 分頁
• 可以正常傳送訊息並收到回應
• 右下角顯示您設定的模型名稱
  

​

疑難排解

​

啟動時報錯/無法連接

1. 確認連接類型設為 gateway(而非 bedrock / vertex)
2. 確認 Base URL 為 https://aihubmix.com(末尾不要加斜線)
3. 確認 API Key 完整複製(必須以 sk- 開頭)
4. 確認您的 AIHubMix 帳號有足夠的餘額

• macOS:開啟 Console.app,以 Claude 過濾
• Windows:開啟 事件檢視器

​

Model Not Found 錯誤

curl https://aihubmix.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

​

我應該使用哪種驗證方案?

​

進階:匯出設定檔(選用)

​

相關資源

• AIHubMix 文件
• AIHubMix Claude 原生 API 參考
• Claude Desktop 官方第三方平台指南
• Claude Desktop 下載頁