Claude Code 會在 Base URL 後補齊 Messages 路徑,因此只填寫 BearLab 根域名,不要手動新增 /v1/messages

1. 檢查版本

在 Ghostty 中執行:
如果版本升級後介面或參數發生變化,請先執行 claude --help 核對目前用法。

2. 建立專用 BearLab 令牌

  1. 開啟 BearLab 的 API 令牌頁面。
  2. 建立僅用於 Claude Code 的令牌。
  3. 選擇能存取 Anthropic Messages 模型的分組。
  4. /v1/models 複製目前可用的準確模型 ID。
截圖中只能顯示打碼後的 sk-••••••••••••,不能顯示完整令牌。

3. 備份並開啟設定

Windows 使用 %USERPROFILE%\.claude\settings.json;WSL 與 Windows 原生是兩套目錄,不要混用。

4. 寫入最小 BearLab 設定

  • ANTHROPIC_BASE_URL:BearLab 根域名。
  • ANTHROPIC_API_KEY:專用模型令牌,不是帳號存取令牌。
  • ANTHROPIC_MODEL:必須替換為目前令牌可見且支援 Anthropic Messages 的模型 ID。
在 Ghostty 中編輯 Claude Code 的 BearLab 設定 儲存後限制文件權限:
只新增上面的 BearLab 環境變數,不要覆蓋已有的外掛、Hook 或其他 Claude Code 設定。

5. 在 Ghostty 啟動 Claude Code

完全退出舊的 Claude Code 程式,重新開啟 Ghostty,在臨時目錄啟動:
啟動成功後,Claude Code 會在 Ghostty 中顯示目前模型和工作目錄。介面中不應出現完整令牌。 Ghostty 中啟動 Claude Code

6. 驗證回覆

在 Claude Code 輸入一個不會修改文件的短問題,例如:
原生 Claude Code 顯示回覆後,到 BearLab 日誌核對請求時間、模型和狀態。兩處記錄一致時,使用者端接入才算完成。

7. 常見問題

  • 仍進入官方登入:檢查是否殘留官方 OAuth、ANTHROPIC_AUTH_TOKEN 或 CC Switch 接管。
  • 401:重新複製專用 BearLab 令牌,檢查前後空格。
  • 404:Base URL 不應包含 /v1/messages
  • 模型不可用:重新查詢 /v1/models,不要繼續使用已下線別名。

8. 恢復

如果備份文件不存在,只移除剛新增的 BearLab 欄位,不要刪除整個 ~/.claude 目錄、外掛、Hooks 或登入態。