Codex 接入
用 Codex CLI 接入 BRUCEAI，搭配 OpenAI Key 即可使用 GPT-6.1 Sol、GPT-6 Astra / Sol / Luna、GPT-5.6 Sol / Terra / Luna 與 GPT-5.5。
為了完全不動到你原本的 Codex / ChatGPT 登入，建議把 BRUCEAI 的設定放在獨立資料夾，用 CODEX_HOME 隔離。你的個人 ~/.codex 不會被修改，測試完也不影響原本的 codex 指令。
Grok 與 DeepSeek 也能在 Codex 使用，做法一樣，只要換成對應的 Key 與模型 ID；細節請看左側的 Grok 接入與 DeepSeek 接入。不想手動改檔案的話，左側的 CC Switch 接入提供一鍵匯入。
可以把這些模型 ID 複製到 config.toml、API request body，或任何需要填模型名稱的 OpenAI 相容客戶端。每一組模型都要用對應類型的 Key 才能呼叫。
先準備 API 金鑰
Codex 使用 OpenAI 相容介面，Base URL 必須帶 /v1。
點「新增 API Key」，填一個你認得出來的名稱，再依照要呼叫的模型選擇 Key 的類型：
- OpenAI Key
- 可呼叫 gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-6-luna、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 與 gpt-5.5。支援 Codex、GitHub Copilot 與任何 OpenAI 相容客戶端。
- Grok Key
- 可呼叫 grok-4.7、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 或任何公開倉庫。
下方所有指令會依照你選擇的系統切換。
安裝並驗證 Codex CLI
沒裝過才需要執行 npm install。裝好後用 codex --version 確認指令找得到。
選擇 Ubuntu 主機時，會先用 NVM 切到 Node.js 22，確認 node 與 npm 來自同一套環境；npm 安裝完還要把全域執行檔目錄加進 PATH 並刷新指令快取，否則可能出現裝好了但系統仍提示找不到 codex。
node -v
npm -v
npm install -g @openai/codex@latest
hash -r
command -v codex
codex --version如果 Ubuntu 主機顯示「Command 'codex' not found」並建議安裝 Snap，請不要執行 snap install codex。改選 Ubuntu 主機、完成 PATH 設定，並確認 command -v codex 找到的是 npm 安裝的執行檔。
建立獨立設定資料夾
mkdir -p ~/.codex-bruceai打開 config.toml
先用下面指令打開 config.toml，檔案不存在時編輯器會幫你建立。
nano ~/.codex-bruceai/config.toml貼上 config.toml 內容
把下面內容完整貼進 config.toml。預設模型用兼顧能力與成本的 gpt-5.6-terra，之後隨時可以在 Codex 裡用 /model 切換。Windows 記事本使用者貼上後，按 Ctrl+S 存檔，再關閉視窗。
model_provider = "OpenAI"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.bruceai.net/v1"
wire_api = "responses"
requires_openai_auth = true打開 auth.json
用下面指令打開 auth.json，準備貼入你的 OpenAI Key。
nano ~/.codex-bruceai/auth.json貼上 auth.json 內容
把 sk-or-v1-你的金鑰 換成你在 API Key 頁面建立的 OpenAI Key。auth.json 是密碼檔，不要提交到 Git。Windows 記事本使用者貼上後，按 Ctrl+S 存檔，再關閉視窗。
{ "OPENAI_API_KEY": "sk-or-v1-你的金鑰" }啟動 Codex
CODEX_HOME="$HOME/.codex-bruceai" codex在 Codex 裡切換模型
進入 Codex 後輸入 /model，就可以切換 BRUCEAI 支援的模型。
只能切到這把 Key 所屬供應商的模型：OpenAI Key 用 GPT 系列，Grok Key 用 grok-4.7 / grok-4.6 / grok-4.5，DeepSeek Key 用 deepseek-v4.1-flash，填錯會直接收到 400。
/model
# OpenAI Key
gpt-6.1-sol
gpt-6-astra
gpt-6-sol
gpt-6-luna
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5
# Grok Key
grok-4.7
grok-4.6
grok-4.5
# DeepSeek Key
deepseek-v4.1-flash如果選到不支援的模型，BRUCEAI 後端會回覆目前這把 Key 可用的模型清單。
可選：建立別名
如果每次都要打 CODEX_HOME 很煩，可以建立一個 bcodex 指令。macOS 寫進 ~/.zshrc，Ubuntu 主機寫進 ~/.bashrc；Windows 記事本打開後，把函式貼到檔案最後，按 Ctrl+S 存檔後關閉視窗。
echo 'alias bcodex="CODEX_HOME=\"$HOME/.codex-bruceai\" codex"' >> ~/.zshrc
source ~/.zshrc之後測試就打 bcodex，原本的 codex 仍然走你個人的 ChatGPT / Codex 設定。
常見問題
401 / invalid token：確認金鑰完整、沒有多餘空白，格式是 sk-or-v1-...
400 / unsupported_model：模型 ID 不屬於這把 Key 的供應商。OpenAI Key 只能用 GPT 系列；要用 Grok 或 DeepSeek 請另外建立對應的 Key。
403 / requires openai：請聯絡管理員確認帳號權限。
Codex 仍走自己的 ChatGPT 帳號：確認是用 CODEX_HOME 指向 ~/.codex-bruceai 啟動，且 config.toml 的 base_url 正確。
對話太長出現 400 / conversation too large：在 Codex 輸入 /compact 壓縮對話，或開新對話。