開始前完成通用備份,並在 BearLab 模型列表中確認目標模型支援 Anthropic Messages 協定。

新增 Provider

  1. 開啟已安裝的 CC Switch,確認初始 Provider 頁面能正常顯示。
  2. 在頂部應用切換欄選擇 Claude Code,不要停留在 Claude Desktop。
CC Switch 頂部已選擇 Claude Code 應用分支
  1. 點擊右上角 +,選擇“自訂設定”。
CC Switch 新增新服務商頁面中的自訂設定入口
  1. 在 BearLab 建立適用於 Anthropic Messages 的專用令牌並複製;不要使用帳號存取令牌。
BearLab API 金鑰頁面中的建立 API 金鑰按鈕 在建立表單中填寫名稱並選擇能存取目標 Anthropic 模型的分組;下面截圖中的 auto 僅展示表單位置,實際分組以目前模型列表和帳戶權限為準。 BearLab 建立 API 金鑰表單中的名稱與分組設定
  1. 名稱填寫 BearLab AI,API Key 填寫模型令牌;請求位址填寫 https://bearlab.ai,亞太地區填寫 https://bearlab.space。不要追加 /v1/v1/messages
CC Switch 中 BearLab AI Provider 的名稱、官網、已打碼 API Key 和請求位址設定 API Key 會顯示為圓點;確認截圖或錄屏中沒有展開明文。繼續向下檢查請求位址: CC Switch 中 BearLab Claude API 請求位址為 https://bearlab.ai
  1. 沒有合併需求時關閉“應用通用設定”,點擊“新增”,確認回傳 Provider 列表並出現 BearLab 卡片。
  2. 點擊卡片右側“啟用”,確認顯示“使用中”。
CC Switch 中 BearLab AI Provider 已被選中
  1. 開啟“設定 → 通用”,開啟“跳過 Claude Code 初次安裝確認”。
CC Switch 已開啟跳過 Claude Code 初次安裝確認
  1. 完全退出並重新開啟終端;下面以 Ghostty 為例啟動 Claude Code。

在 Ghostty 中啟動

下面是在 Ghostty 中實際啟動 Claude Code 後的介面。頂部應顯示 Claude Code 版本、目前模型和工作目錄;不應再跳轉到官方登入頁。 在 Ghostty 中啟動由 CC Switch 設定的 Claude Code 在 Claude Code 輸入框傳送一條短訊息,並在 BearLab 主控臺日誌中核對模型、狀態和請求時間。若需要固定模型,在 Claude Code 設定中使用 BearLab 實際回傳的 Anthropic 模型 ID,不要照抄截圖中的示例模型。

獨立介面檢查

教學截圖展示的是實際設定步驟:選擇 Claude Code、新增自訂 Provider、建立 BearLab API 金鑰、填寫 Provider、啟用、跳過首次確認,以及在 Ghostty 中啟動 Claude Code。截圖中的 API Key 已打碼。

排錯

  • 仍出現官方登入:核對“跳過初次安裝確認”、Provider 啟用狀態和 ANTHROPIC_BASE_URL 的實際來源。
  • CC Switch 自檢失敗:某些令牌分組可能限制第三方探測;不能據此斷定 Claude Code 對話失敗。
  • 對話使用錯誤模型:核對令牌可見模型與 CC Switch 的主模型/快速模型對應。
  • 切換後無變化:完全退出 Claude Code,而不是只關閉目前視窗。