Claude Desktop
讓 Claude Desktop 的 Chat、Cowork、Code 透過 Hakila 使用 Claude 模型
Claude Desktop 的「第三方推論」模式可以把整個 App 的推論改送到自訂閘道。指到 Hakila 後，Chat、Cowork、Code 三個分頁都走 Hakila 的 Messages API，Claude 模型原樣轉發給 Anthropic，用量照 Hakila 的價格與預算計費； 不需要 Anthropic 帳號或 Claude 訂閱。
用 Hakila Switcher 一鍵設定（Windows）
- 開啟 Hakila Switcher，選 Claude Desktop，貼上 Hakila API Key，按「套用」。
- 從系統匣（右下角）完全結束 Claude，再重新開啟。只關視窗不會重新讀設定。
- 啟動後不需要登入，直接開始使用。
Switcher 會在 %LOCALAPPDATA%\Claude-3p\configLibrary 新增並套用一組名為「Hakila」的設定（App 內顯示的供應商名稱也設為 Hakila），套用前自動備份，
之後可以按「還原原始設定」改回來。
模型選單列出這把 API Key 能用、且出現在所屬組織第三方工具模型清單裡的 Claude 模型與 claude-auto（即 hakila/auto，排在最後，不會成為預設模型；在 Claude Desktop 裡只會自動選 Claude 模型），
順序依平台模型目錄的排序，第一個是預設模型。之後每次開啟 Switcher 都會向 Hakila 取得最新清單，
有新模型時自動更新設定並提示你重新開啟 Claude；清單也可以用 GET https://api.hakila.ai/v1/clients/claude-desktop/models 查詢。
手動設定
- Claude Desktop 選單「Help → Troubleshooting → Enable Developer Mode」。
- 選單「Developer → Configure Third-Party Inference…」，在 Connection 填入：
| 欄位 | 值 |
|---|---|
| Inference provider | Gateway |
| Gateway base URL | https://api.hakila.ai（不要加 /v1） |
| Credential kind | Static API key |
| Gateway API key | 你的 Hakila API Key |
- 在 Models 依序加入要出現在選單的模型，第一個是預設模型：
claude-sonnet-5
claude-opus-5
claude-fable-5-1
claude-haiku-4-5-20251001- 在 Appearance 的「Deployment display name」填
Hakila，側欄、帳號選單與連線錯誤訊息就會顯示 Hakila 而不是 Gateway。 - 按「Apply Changes」再「Save & Restart」。
第一次啟動時的「You're using Gateway」提示卡固定顯示供應商類型，不受顯示名稱影響，關閉後就不會再出現。
模型請寫不帶前綴的 Claude 名稱：Claude Desktop 只接受看起來像 Claude 的 id，Hakila 會自動補成 anthropic/claude-*。
API Key 必須允許這些模型（見允許清單）。
要用自動選路時加入 claude-auto：hakila/auto 不像 Claude 的 id，會被 Claude Desktop 從清單移除，
Hakila 把 claude-auto 當成 hakila/auto 處理。
支援範圍
- 對話、工具呼叫、MCP、延伸思考與 prompt cache 都由 Anthropic 原樣處理；Hakila 不會改寫
cache_control， Cowork 與 Code 的長對話仍能命中快取。 - Claude 的
web_search每次搜尋另收 US$0.01，見 Messages API 的記帳。 - 第三方推論模式下，Code 分頁只能在本機執行（沒有 SSH、雲端環境與 Remote Control）； MCP tool search 等實驗性功能預設關閉。綁定 claude.ai 帳號的功能（雲端同步、帳號連接器等）不可用。
- 公司已用 MDM 或登錄檔（
HKLM\SOFTWARE\Policies\Claude）派送推論設定時，派送的設定優先，個人設定不會生效。