Claude Desktop 有兩種不同模式。官方模式使用 Anthropic 帳號登入；第三方模式讀取 CC Switch 寫入的 3P Profile。兩種模式不要混用，也不要修改 OAuth、Cookie 或會話文件繞過登入。

​
1. 安裝 Claude Desktop

從 Claude 官方下載頁 下載使用者端。macOS 使用者開啟 DMG 後，把 Claude.app 拖到“應用程式”。完整系統要求和安裝說明見 Anthropic 幫助中心。 Claude Desktop 官方 macOS 安裝鏡像 安裝後先退出 Claude Desktop。CC Switch 寫入 Provider 後需要重新啟動，執行中的使用者端不會可靠地熱載設定。

​
2. 在 CC Switch 選擇 Claude Desktop

  1. 開啟 CC Switch。
  2. 在頂部應用切換器中選擇 Claude Desktop，不要選成 Claude Code。
  3. 如果看不到該分支，開啟“設定 > 通用 > 首頁顯示”，確認 Claude Desktop 沒有被隱藏。
  4. 點擊右上角加號，選擇“自訂設定”。
Claude Desktop 與 Claude Code 使用不同設定。Claude Code 讀取 ~/.claude/settings.json，Claude Desktop 則讀取自己的 3P Profile。

​
3. 填寫 BearLab Provider

依次填寫：
  1. 服務商名稱：BearLab AI。
  2. 官網連結：https://bearlab.ai。
  3. API Key：貼上 BearLab 模型令牌，截圖或分享時保持掩碼。
  4. 請求位址：https://bearlab.ai，不要手動追加 /v1/messages。
  5. API 格式：Anthropic Messages（原生）。
  6. BearLab 模型不是 Claude Desktop 能直接識別的角色名時，開啟“需要模型對應”。
CC Switch Claude Desktop 分支中的 BearLab Provider 設定

​
4. 設定模型對應

目前 CC Switch 表單提供 Sonnet、Opus、Fable、Haiku 角色路由。CC Switch 會把使用者端選擇的角色對應到 BearLab 的真實模型 ID。
  1. 點擊“取得模型列表”。
  2. 把需要使用的 Sonnet、Opus、Fable、Haiku 角色對應到 BearLab 主控臺實際存在的模型 ID。
  3. 服務商只有一個模型時，至少填寫一個角色，其他空角色會繼承首個有效對應。
  4. 只有模型確實支援 1M 上下文時才勾選 1M。
  5. 儲存前核對模型 ID，不要照抄截圖裡的值。
CC Switch 中的 Claude Desktop 模型角色對應

​
5. 啟用本機路由

  1. 儲存 Provider，回到服務商列表並啟用 BearLab AI。
  2. 開啟“設定 > 路由 > 本機路由”，啟用“在主頁顯示路由開關”。
  3. 回到 Claude Desktop 分支，開啟本機路由。
  4. 確認路由顯示為執行中，預設監聽 127.0.0.1:15721。
  5. 完全退出並重新啟動 Claude Desktop。
模型對應模式下，Claude Desktop 連線到：
CC Switch 負責角色對應、協定轉換和上游驗證，因此使用過程中必須保持執行。 CC Switch 的 Claude Desktop 本機路由已啟動
本機路由啟動只表示 CC Switch 已準備好轉發請求。仍需在 Claude Desktop 中傳送訊息，並在 BearLab 日誌中確認對應請求。

​
6. 官方模式的登入邊界

如果 CC Switch 啟用的是“Claude Desktop 官方”，使用者端會進入 Anthropic 登入流程。這不是 BearLab API Key 的輸入頁。 Claude Desktop 官方模式首次啟動介面 點擊 Get started 後，可以選擇 Google 登入或郵箱登入。只使用自己的合法帳號，不要把 BearLab Key 填進郵箱或密碼輸入框。 Claude Desktop 官方帳號登入邊界 恢復官方模式時，在 CC Switch 中啟用“Claude Desktop 官方”，完全退出使用者端後重啟。官方模式不需要 BearLab Key，也不依賴本機路由。

​
7. 驗證 BearLab 接入

只有 3P 介面正常出現後才繼續：
  1. 在 Claude Desktop 選擇已對應的角色模型。
  2. 傳送一條最短訊息。
  3. 確認使用者端顯示正文回覆。
  4. 開啟 BearLab 主控臺，確認出現同一時間的請求記錄。
  5. 核對請求模型與 CC Switch 的實際對應一致。
使用者端回覆、BearLab 請求記錄和模型對應三項必須同時成立。只看到本機端口、Provider 已啟用或登入頁，都不能算接入成功。

​
常見問題

​
啟動後進入 Sign In

目前讀取的是官方 1P 設定。需要 BearLab 時，回到 CC Switch 的 Claude Desktop 分支啟用 BearLab Provider，然後完全退出並重啟使用者端。

​
3P 模式視窗空白

先完全退出 Claude Desktop，再確認 CC Switch 仍在執行、本機路由已開啟、目前 Provider 仍是 BearLab，然後重新啟用 Provider 並重啟。仍然空白時，恢復“Claude Desktop 官方”，不要繼續嘗試傳送訊息。

​
CC Switch 已啟用，但請求沒有出現在 BearLab

確認目前分支是 Claude Desktop。模型對應模式還必須保持本機路由執行。若使用者端沒有正文回覆或 BearLab 沒有請求記錄，繼續檢查本機路由和模型對應。

​
模型對應後報模型不存在

重新取得 BearLab 模型列表，複製實際模型 ID。Claude Desktop 顯示的是角色名稱，真實上游模型由 CC Switch 對應。

​
設定文件位置

macOS：
Windows：
這些文件由 CC Switch 管理。設定異常時，回到 CC Switch 重新啟用目前 Provider，不要手改文件裡的 Key 或本機路由令牌。更多欄位和模式說明見 CC Switch Claude Desktop 官方手冊。