Codex CLI

安裝總覽(macOS 版)

OpenAI Codex CLI 安裝與自定義 API 設定指南 — macOS 版

本指南目標:在 macOS 安裝 OpenAI Codex CLI,並接上自己的 MYAI168 API,使用 gpt-5.5。

重點說明

Codex 走 OpenAI 格式,因此要接的是 MYAI168 的「OpenAI 相容端點」。金鑰沿用先前已 export 到 shell 的 MYAI168_API_KEY,不需重設。

開始之前:前置準備與安全須知

前置:Node.js 與 API Key

  • Codex 透過 npm 安裝,需要 Node.js(建議 18 以上;若已裝過 Node 24 就沒問題)。
  • 端點與模型:
端點   https://www.myai168.com/futaba/api/openai/v1
模型   gpt-5.5

金鑰:假設 MYAI168_API_KEY 已經 export 在 ~/.zshrc(先前設定其他工具時已加入)。確認方式:

echo "[$MYAI168_API_KEY]"

應印出 [你的金鑰字串],不是空的 []。

重要安全須知

  • Codex 能在工作目錄裡讀取、編輯、執行檔案。實際使用時請 cd 進特定專案資料夾再開,不要在家目錄(~)開啟。
  • API Key 視同密碼,不要外流。若不慎外流,立刻到 MYAI168 後台撤銷換新。
一、安裝 Codex CLI
npm install -g @openai/codex

裝完讓指令生效並確認:

source ~/.zshrc
codex --version
二、設定 config.toml 接上 MYAI168

建立設定資料夾與設定檔。把下面「一整塊」複製貼上、按一次 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/futaba/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 那行。

五、常見問題速查

回話像是官方模型 / 狀態列顯示 default

多半是 config 沒被正確套用。最常見原因:env_key 填成了金鑰字串而非變數名稱。改成 env_key = "MYAI168_API_KEY"。

用「你是誰」測,它自稱別的模型

正常現象,模型自我認知不可靠。改用運算題或建檔等實際動作驗證,並對照 MYAI168 後台呼叫紀錄確認。

permission denied 寫不進 config.toml

檔案權限/擁有者問題。先修正擁有權再重建:

sudo chown -R $(whoami) ~/.codex

然後重跑第 2 節的 cat > 區塊。

貼上 cat > 區塊卻說 no such file or directory

貼上時第一行的 cat > 被吃掉了,導致直接執行檔案路徑。重貼,確認第一行開頭是 cat >。

no_pricing_info / no pricing info

該模型在 MYAI168 的這個端點沒有登錄,換用端點支援的模型。

401 / unauthorized

金鑰未被讀到,或 Codex 在驗證 key 前綴。先確認 echo "[$MYAI168_API_KEY]" 有值;必要時在 provider 區塊加一行 requires_openai_auth = false。

確認金鑰變數有值

echo "[$MYAI168_API_KEY]",印出 [字串] 為正常,[] 為空(未設)。

六、維護與安全

更新 Codex:

npm update -g @openai/codex

更換 API Key(外流或定期輪替時)

  1. 到 MYAI168 後台撤銷舊 key、產生新 key。
  2. 更新 ~/.zshrc 裡的 export MYAI168_API_KEY="新key"。
  3. source ~/.zshrc 生效(Codex 讀的就是這個變數,改完即跟著更新)。
  4. 若同一把 key 也用在其他工具,記得一併更新它們的設定檔。

設定檔位置

~/.codex/config.toml

官方文件

  • https://developers.openai.com/codex/config-advanced
  • https://developers.openai.com/codex/config-reference

其他常見問題頁面

  • 常見問題
  • 帳戶問題
  • 功能問題
  • 隱私權
  • OpenAI ChatGPT API
  • Anthropic Claude API
  • Google Gemini API
  • Google News API
  • OpenRouter API
  • API 收費
  • OpenCode
  • OpenClaw
  • Hermes Agent
  • Claude Code CLI
  • MYAI168 MCP CLI
  • MYAI168 MCP 網頁及應用程式