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

BRUCEAI

ISOLATED_CODEX_HOME

Codex 接入

為了完全不動到你原本的 Codex / ChatGPT 登入,建議把 BRUCEAI 測試設定放在獨立資料夾,用 CODEX_HOME 隔離。

這樣你的個人 ~/.codex 不會被修改,測試完也不影響原本的 codex 指令。

支援模型 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/v1

Codex 使用 OpenAI-compatible 介面,這裡需要帶 /v1。

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

先選擇你的系統

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

STEP 02

安裝 Codex CLI

沒裝過才需要執行。

macOS / Linux
bash
npm install -g @openai/codex
STEP 03

建立獨立設定資料夾

macOS / Linux
bash
mkdir -p ~/.codex-bruceai
STEP 04

寫入 config.toml

先用下面指令打開 config.toml,檔案不存在時編輯器會幫你建立。

macOS / Linux
bash
nano ~/.codex-bruceai/config.toml
STEP 05

貼上 config.toml 內容

把下面內容完整貼進 config.toml。macOS / Linux 使用 nano 時:貼上後按 Ctrl+O,再按 Enter 存檔,最後按 Ctrl+X 退出。Windows 記事本按 Ctrl+S 存檔後關閉視窗。

toml
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
STEP 06

建立 auth.json

用下面指令打開 auth.json,準備貼入你的 BRUCEAI API Key。

macOS / Linux
bash
nano ~/.codex-bruceai/auth.json
STEP 07

貼上 auth.json 內容

把 sk-or-v1-你的金鑰 換成你在 API Key 頁面建立的金鑰。macOS / Linux 使用 nano 時:貼上後按 Ctrl+O,再按 Enter 存檔,最後按 Ctrl+X 退出。Windows 記事本按 Ctrl+S 存檔後關閉視窗。

json
{ "OPENAI_API_KEY": "sk-or-v1-你的金鑰" }
STEP 08

啟動 Codex

macOS / Linux
bash
CODEX_HOME="$HOME/.codex-bruceai" codex
STEP 09

在 Codex 裡切換模型

進入 Codex 後輸入 /model,可以切換 BRUCEAI 支援的模型:gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5、gpt-5.4、gpt-5.4-mini。

text
/model

如果選到不支援的模型,BRUCEAI 後端會回覆目前支援的模型清單。

STEP 10

可選:建立別名

如果每次都要打 CODEX_HOME,可以建立一個 bcodex 指令。Windows 記事本打開後,把函式貼到檔案最後,按 Ctrl+S 存檔後關閉視窗。

macOS / Linux
bash
echo 'alias bcodex="CODEX_HOME=\"$HOME/.codex-bruceai\" codex"' >> ~/.zshrc
source ~/.zshrc

之後測試就打 bcodex,原本的 codex 仍然走你個人的 ChatGPT / Codex 設定。