CC Switch 一鍵接入
CC Switch 是管理 Codex 供應商設定的桌面工具。把 BRUCEAI 的 Key 匯入之後，就能在圖形介面裡一鍵切換 OpenAI、Grok 與 DeepSeek，不需要手動改 config.toml 或 auth.json。
下面的產生器會在你的瀏覽器裡組出 ccswitch:// 匯入連結，自動帶入 Base URL、預設模型與金鑰；三種 Key 各自匯入成一個供應商。
一鍵匯入也會自動啟用額度查詢，CC Switch 顯示的是你在 BRUCEAI 的可用額度。既有或手動建立的供應商不會自動補上這項設定，可重新匯入或按下方腳本設定。
可以把這些模型 ID 複製到 config.toml、API request body，或任何需要填模型名稱的 OpenAI 相容客戶端。每一組模型都要用對應類型的 Key 才能呼叫。
先準備 API 金鑰
匯入 Codex 供應商時一律使用 https://api.bruceai.net/v1，/v1 不可省略。
點「新增 API Key」，填一個你認得出來的名稱，再依照要呼叫的模型選擇 Key 的類型：
- OpenAI Key
- 可呼叫 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 與 gpt-5.5。支援 Codex、GitHub Copilot 與任何 OpenAI 相容客戶端。
- Grok Key
- 可呼叫 grok-4.6 與 grok-4.5。支援 Grok Build、Codex 與任何 OpenAI 相容客戶端。
- DeepSeek Key
- 可呼叫 deepseek-v4.1-flash：1M 上下文，支援思考模式、工具呼叫與圖片輸入。支援 Codex 與任何 OpenAI 相容客戶端。
一把 Key 只能呼叫自己這家供應商的模型：用 Grok Key 送 GPT 模型 ID，或用 OpenAI Key 送 grok-4.6，都會直接收到 400。要用多家模型就分別建立幾把 Key。
不要把 API 金鑰發給別人，也不要提交到 GitHub、GitLab 或任何公開倉庫。
安裝並打開 CC Switch
從 CC Switch 官方 Releases 下載適合你系統的最新版，完成安裝後先啟動一次，讓系統註冊 ccswitch:// 連結協定。
同時確認本機已安裝 Codex CLI（npm install -g @openai/codex@latest）。CC Switch 負責管理設定，實際發出請求的仍是 Codex。
建立 API Key
登入 BRUCEAI，進入「API Key 管理」，點「新增 API Key」，類型依你要用的模型選擇 OpenAI、Grok 或 DeepSeek。
完整金鑰只會顯示一次，請先複製下來再關閉視窗。要同時用多家模型，請分別建立對應的 Key，各自匯入一次。
產生匯入連結並開啟 CC Switch
選擇 Key 的類型與預設模型，貼上剛建立的金鑰，按「開啟 CC Switch 匯入」。瀏覽器詢問是否開啟外部應用程式時，選擇允許。
匯入連結包含完整 API 金鑰。不要複製、轉傳或貼到聊天、工單與公開網頁；只在自己的電腦上直接點開。
選擇 Key 的類型與預設模型，貼上金鑰，再點一下開啟 CC Switch。連結只在你的瀏覽器裡組成，金鑰不會送到 BRUCEAI。
如果點了沒有反應，先確認 CC Switch 已安裝並啟動過，再檢查瀏覽器是否封鎖外部應用程式連結。也可以換用 Chrome、Edge 或系統預設瀏覽器重試。
核對匯入內容
CC Switch 確認畫面應顯示以下資料，確認後完成新增或更新。API 地址的 /v1 不可省略；預設模型依你選的 Key 類型而定。
應用：Codex
供應商：BRUCEAI
API 地址：https://api.bruceai.net/v1
預設模型：gpt-5.6-terra應用：Codex
供應商：BRUCEAI Grok
API 地址：https://api.bruceai.net/v1
預設模型：grok-4.6應用：Codex
供應商：BRUCEAI DeepSeek
API 地址：https://api.bruceai.net/v1
預設模型：deepseek-v4.1-flash確認額度查詢
透過上面連結匯入的供應商會自動帶入用量查詢腳本並定期更新，不用再手動填。查詢用這個供應商的 API Key 呼叫 https://api.bruceai.net/v1/usage，只回傳你自己在 BRUCEAI 的可用額度。
如果供應商是過去建立、從其他平台搬來或手動新增，CC Switch 不會自己猜額度介面。最簡單的方式是用第 3 步重新匯入；也可以在 CC Switch 的供應商用量查詢中啟用自訂腳本並貼上以下內容。Base URL 有沒有 /v1 都能用。
({
request: {
url: "{{baseUrl}}".replace(/\/+$/, "")
+ ("{{baseUrl}}".replace(/\/+$/, "").endsWith("/v1") ? "" : "/v1")
+ "/usage",
method: "GET",
headers: { "Authorization": "Bearer {{apiKey}}" }
},
extractor: function(response) {
return {
isValid: response?.isValid ?? true,
remaining: response?.remaining ?? response?.balance,
unit: response?.unit ?? "USD"
};
}
})CC Switch 的單位欄位會顯示 USD，但數字是你在 BRUCEAI 的額度餘額，不是美金。
手動新增供應商（不用匯入連結）
在 CC Switch 點「添加新供應商」，上方分頁保持在「Codex 供應商」，選擇左上角的「自定義配置」。不要選 OpenAI Official 或其他預設供應商。
供應商名稱可自訂，例如「BRUCEAI」；官網連結填 https://bruceai.net；API Key 填你的金鑰（sk-or-v1- 開頭）；API 請求地址填 https://api.bruceai.net/v1，/v1 不可省略。
預設模型填這把 Key 對應供應商的模型 ID（例如 gpt-5.6-terra、grok-4.6 或 deepseek-v4.1-flash），並展開「高級選項」，把上游格式選為「Responses（原生）」。填完按右下角儲存。
上游格式一定要選「Responses（原生）」。選成 Chat 或 Anthropic Messages 會多一層格式轉換，Codex 可能收到 400 或空回覆。
啟用供應商並驗證
回到 CC Switch 的 Codex 頁面，把 BRUCEAI 切換為目前供應商。已經打開的 Codex 終端機不會自動讀取新設定，請退出後重新啟動。
Codex 啟動後可用 /model 檢查並切換模型。只能切到這把 Key 所屬供應商的模型，要換供應商就在 CC Switch 切換到另一個匯入的供應商。
codex常見問題
401 / invalid token：刪除舊供應商後重新建立一把金鑰並匯入，確認金鑰完整且沒有多餘空白。
切換後仍走舊供應商：完全退出正在執行的 Codex，再確認 CC Switch 中 BRUCEAI 已是目前供應商後重開。
400 / unsupported_model：模型 ID 不屬於這把 Key 的供應商。OpenAI Key 只能用 GPT 系列，Grok Key 只能用 grok-4.6 / grok-4.5，DeepSeek Key 只能用 deepseek-v4.1-flash。
Codex 無法請求：確認匯入到 Codex 分頁、地址包含 /v1，且上游格式是 Responses（原生）。
需要手動設定或想保留原本帳號：請改看左側的 Codex 接入，裡面提供 CODEX_HOME 隔離設定與切回方式。