OpenAI Codex CLI 安裝與 MYAI168 設定指南 — macOS 版

本指南目標：在 macOS 安裝 OpenAI Codex CLI，並接上自己的 MYAI168 API，使用 gpt-5.6-sol。

Codex 走 OpenAI 格式，接的是 MYAI168 的「OpenAI 相容端點」搭配 gpt-5.6-sol。

端點與模型

端點   https://www.myai168.com/nthu/api/openai/v1
模型   gpt-5.6-sol

重要安全須知

• Codex 能在工作目錄裡讀寫、執行檔案。實際使用請 cd 進專案資料夾再開，不要在家目錄開啟。
• API Key 視同密碼，不要外流；外流就到 MYAI168 後台撤銷換新。
• 驗證請用「運算題」，不要用「你是誰」（模型自我認知不可靠）；並對照 MYAI168 後台呼叫紀錄確認。

前置

準備好 MYAI168 API Key（Codex 透過環境變數 MYAI168_API_KEY 讀取金鑰，設定步驟見「二、設定 MYAI168」）。Node.js 僅「npm 安裝方式」需要——官方首選的 standalone 安裝器不需 Node。

官方首選：standalone 安裝器（不需 Node.js；官方文件 https://developers.openai.com/codex/cli/）：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

替代方式：npm（需已安裝 Node.js）：

npm install -g @openai/codex
source ~/.zshrc
codex --version

cc-switch 是跨平台 GUI，macOS 操作介面與 Windows 相同。（安裝方式見開發者中心的「cc-switch macOS」分頁。）

1. 開 cc-switch，點上方「Codex」分頁。
2. 點「+」新增，選 Custom Configuration。
3. 填：Provider Name = MYAI168；API Key = 你的金鑰；API Request URL = https://www.myai168.com/nthu/api/openai/v1
4. 展開 Advanced Options：Needs Local Routing 先「關閉」（gpt-5.6-sol 屬 GPT 系列、可走 responses，通常不需開；若直連失敗再打開，用本機代理轉換，並使用時保持 cc-switch 開著）。
5. 按 Save → 在卡片上 Enable。

確認金鑰已 export 在 ~/.zshrc（Codex 透過 env_key 讀取）：

echo "[$MYAI168_API_KEY]"

應印出金鑰、非空 []；若為空，先加入並生效：

echo 'export MYAI168_API_KEY="你的金鑰"' >> ~/.zshrc
source ~/.zshrc

確認 cc-switch 有寫進 config.toml：

cat ~/.codex/config.toml

若 cc-switch 沒寫成功（config.toml 不存在），用手動方式。把下面「一整塊」複製貼上、Enter（第一行開頭一定要有 cat >）：

mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "myai168"

[model_providers.myai168]
name = "MYAI168"
base_url = "https://www.myai168.com/nthu/api/openai/v1"
env_key = "MYAI168_API_KEY"
wire_api = "responses"
EOF

確認：

cat ~/.codex/config.toml

關鍵：env_key 填「環境變數名稱」MYAI168_API_KEY，不是金鑰字串本身。

進一個測試資料夾再開（不要在家目錄）：

mkdir -p ~/cc-test
cd ~/cc-test
codex

首次問信任資料夾 → 1. Yes。

驗證：進 codex 後問一個需要運算的問題：

123456 乘以 789 是多少？只回數字。

能算出 97406784、狀態列顯示 gpt-5.6-sol，即接通成功。

（不要用「你是誰」驗證——模型自我認知不可靠；以 MYAI168 後台呼叫紀錄為準。）

• codex 指令找不到 → 執行 source ~/.zshrc，或重開終端機。（Windows 為開新 PowerShell；或 npm bin 不在 PATH，用 npm prefix -g 找目錄加進 PATH。）
• no_pricing_info／模型不存在 → 該模型在此端點未登錄，確認用 gpt-5.6-sol。
• 回 404／responses not found（直連失敗） → MYAI168 端點對此模型可能只支援 Chat Completions。回 cc-switch 打開「Needs Local Routing」，Save、Enable，使用時保持開著。
• 401／unauthorized → echo "[$MYAI168_API_KEY]" 確認有值；必要時 provider 區塊加 requires_openai_auth = false。（Windows 為確認 [Environment]::GetEnvironmentVariable("MYAI168_API_KEY","User") 有值，並開新視窗。）
• 狀態列顯示 default／像官方模型 → config 沒套用。最常見：env_key 填成金鑰字串而非變數名。
• 切換模型 → 對話中 /model；或改 config.toml 的 model。臨時單次：codex -c model='"模型名稱"'

更新 Codex（standalone 安裝器版＝重跑官方安裝指令即更新；npm 版用 install @latest，不要用 npm update -g）：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm 版：npm install -g @openai/codex@latest

更換 API Key

改 ~/.zshrc 的 export MYAI168_API_KEY，再 source ~/.zshrc 生效。

設定檔位置

~/.codex/config.toml

官方文件

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