本指南目標:在 macOS 安裝 OpenAI Codex CLI,並接上自己的 MYAI168 API,使用 gpt-5.5。
Codex 走 OpenAI 格式,因此要接的是 MYAI168 的「OpenAI 相容端點」。金鑰沿用先前已 export 到 shell 的 MYAI168_API_KEY,不需重設。
端點 https://www.myai168.com/ntue/api/openai/v1
模型 gpt-5.5
金鑰:假設 MYAI168_API_KEY 已經 export 在 ~/.zshrc(先前設定其他工具時已加入)。確認方式:
echo "[$MYAI168_API_KEY]"
應印出 [你的金鑰字串],不是空的 []。
npm install -g @openai/codex
裝完讓指令生效並確認:
source ~/.zshrc
codex --version
建立設定資料夾與設定檔。把下面「一整塊」複製貼上、按一次 Enter(注意第一行開頭一定要有 cat >):
mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.5"
model_provider = "myai168"
[model_providers.myai168]
name = "MYAI168"
base_url = "https://www.myai168.com/ntue/api/openai/v1"
env_key = "MYAI168_API_KEY"
wire_api = "responses"
EOF
確認內容正確:
cat ~/.codex/config.toml
關鍵檢查:env_key 那行必須是 MYAI168_API_KEY(環境變數的「名稱」),而不是金鑰字串本身。這是最容易填錯的地方,務必確認。
model:要用的模型 id。model_provider:指向下方自定義供應商的 id。base_url:API 根路徑,結尾 /v1,不要加結尾斜線。env_key:Codex 執行時去讀的「環境變數名稱」,當 Bearer token 送出。wire_api:目前 Codex 使用 "responses"。進一個專案/測試資料夾再開(不要在家目錄):
mkdir -p ~/cc-test
cd ~/cc-test
codex
首次會問是否信任此資料夾 → 選 1. Yes, continue。
驗證:在輸入框打一個「需要實際運算或動作」的問題來測,例如:
123456 乘以 789 是多少?只回數字。
能算出正確答案(97406784),即代表接通成功、模型正常運作。
注意:不要用「你是誰 / 你用什麼模型」來驗證 —— 模型回答自身身分並不可靠,常會回成訓練時的身分(例如自稱是某某模型),這不代表實際接的模型或接通與否。要判斷實際身分,以 MYAI168 後台的 API 呼叫紀錄為準。
設定完成後,平常進到專案資料夾打 codex 即可:
cd ~/你的專案資料夾
codex
臨時切換模型(單次,不改設定檔):
codex -c model='"模型名稱"'
永久切換:編輯 ~/.codex/config.toml 的 model 那行。
多半是 config 沒被正確套用。最常見原因:env_key 填成了金鑰字串而非變數名稱。改成 env_key = "MYAI168_API_KEY"。
正常現象,模型自我認知不可靠。改用運算題或建檔等實際動作驗證,並對照 MYAI168 後台呼叫紀錄確認。
檔案權限/擁有者問題。先修正擁有權再重建:
sudo chown -R $(whoami) ~/.codex
然後重跑第 2 節的 cat > 區塊。
貼上時第一行的 cat > 被吃掉了,導致直接執行檔案路徑。重貼,確認第一行開頭是 cat >。
該模型在 MYAI168 的這個端點沒有登錄,換用端點支援的模型。
金鑰未被讀到,或 Codex 在驗證 key 前綴。先確認 echo "[$MYAI168_API_KEY]" 有值;必要時在 provider 區塊加一行 requires_openai_auth = false。
echo "[$MYAI168_API_KEY]",印出 [字串] 為正常,[] 為空(未設)。
更新 Codex:
npm update -g @openai/codex
~/.codex/config.toml