System Framework v4.7.0 // BRUCEAI API Gateway
+ 01
+ 02

BRUCEAI

QUICK_START

Claude Code 接入

你可以用 Claude Code 接入 BRUCEAI API,原本的 Claude Code 登入不會被刪除,測試完隨時可以切回去。

建議只在目前終端機設定環境變數,不要先寫進 ~/.zshrc 或 ~/.bashrc,這樣測試和自用最不容易互相影響。

支援模型 ID

可以把這些模型 ID 複製到 config.toml、API request body,或任何需要填模型名稱的 OpenAI-compatible 客戶端。

STEP 01 / API_KEY_REQUIRED

先準備 API 金鑰

1. 前往 API Key 頁面

登入後到 API Key 頁面建立或複製 API Key。金鑰格式像 sk-or-v1-xxxxxxxxxxxx,請把它當密碼保管。

建立 API Key
2. 確認 Base URL
https://api.bruceai.net

Claude Code 使用這個 Base URL,不需要帶 /v1。

不要把 API 金鑰發給別人,也不要提交到 GitHub、GitLab 或任何公開倉庫。

先選擇你的系統

下方所有指令會依照你選擇的系統切換。

STEP 02

安裝 Claude Code

沒裝過才需要執行。

macOS / Linux
bash
npm install -g @anthropic-ai/claude-code
STEP 03

設定環境變數

把 sk-or-v1-你的金鑰 換成你自己的 BRUCEAI API Key。

macOS / Linux
bash
unset ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL="https://api.bruceai.net"
export ANTHROPIC_AUTH_TOKEN="sk-or-v1-你的金鑰"

一定要用 ANTHROPIC_AUTH_TOKEN,不要用 ANTHROPIC_API_KEY。

STEP 04

開始使用

在你的專案資料夾執行 claude。進入後可以輸入 /status 確認 Base URL 是否指向 BRUCEAI。

如果 Claude Code 顯示模型是 opus 4.8,可以先不用理會,實際後端會走 BRUCEAI 的模型路由。

macOS / Linux
bash
claude

GPT-5.6 Sol、Terra、Luna 支援約 1.05M 輸入上下文;當輸入與快取讀取合計超過 272K Tokens,整次請求會依長上下文費率扣除。Claude Code 的自動路由仍可能依內容與上游狀態選擇其他支援模型。

STEP 05

切回自己的 Claude Code 帳號

ANTHROPIC_AUTH_TOKEN 的優先級高於 /login 訂閱帳號,所以一設定就會走 BRUCEAI API,但原本登入不會被刪除。

想切回自己的帳號,取消環境變數或關閉目前終端機重開即可。

macOS / Linux
bash
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN