02 - 安裝與登入
← 01-什麼是Codex-CLI | 00-Index | 下一篇 → 03-互動模式基本操作
安裝
npm（最常用）
npm install -g @openai/codexHomebrew
brew install --cask codex安裝腳本 / 直接下載
官方也提供 curl（mac / Linux）與 PowerShell（Windows）安裝腳本，或直接從 GitHub Releases 下載對應平台架構的 binary。
驗證
codex --version⚠️ Windows：官方建議用 WSL2
CLI 在 macOS 和 Linux 上是完整支援的；Windows 支援仍是 experimental，官方建議在 WSL2 workspace 裡跑 Codex 以獲得可靠體驗。
這跟 Herdr 和 Claude Code 的建議一致——三個工具都指向同一個結論：在 WSL2 裡工作。
一次設定，三個工具都受益：
# WSL2 Ubuntu 裡
curl -fsSL https://claude.ai/install.sh | bash # Claude Code
npm install -g @openai/codex # Codex CLI
curl -fsSL https://herdr.dev/install.sh | sh # Herdr
sudo apt install -y jq # 編排腳本需要登入
用 ChatGPT 帳號（你要用的）
codex第一次會出現選單，選 Sign in with ChatGPT。支援 Plus、Pro、Business、Edu、Enterprise 訂閱。
也可以直接：
codex login無瀏覽器環境（SSH / 遠端）
codex login --device-auth走 device code 流程——它給你一組代碼，你在另一台有瀏覽器的裝置上輸入。
💡 從 iPhone SSH 進 WSL 第一次設定 Codex 時就會用到這個。
API key
也可以用 API key（從 stdin 傳入），但那是走 API 計費，不是你的 Plus 訂閱額度。
⚠️ 模型異動（2026-08 重要）
gpt-5.4和gpt-5.4-mini於 2026-08-31 從「ChatGPT 登入的 Codex」退場。 用 ChatGPT 登入的話，把儲存的設定、自訂 agent、排程任務裡的gpt-5.4換成gpt-5.6-terra、gpt-5.4-mini換成gpt-5.6-luna。
今天是 2026-08-04，也就是不到一個月。 該檢查的地方：
-
~/.codex/config.toml的model =那行 - 任何
[profiles.*]區塊裡的model - 排程任務 / automation 設定
- 你寫過的編排腳本——例如 Herdr 教學 裡出現的
herdr agent start reviewer --kind codex -- -m gpt-5.4這種寫法
💡 實務建議：編排腳本裡不要寫死模型名。 讓它用
config.toml的預設，或把模型名抽成一個變數。模型會換，腳本不該跟著壞。
思考力度
Codex 也有 reasoning effort 的概念（model_reasoning_effort），一般是 minimal / low / medium / high / xhigh，實際可用等級依模型而定。
另外有兩個特殊模式：
- Max：給選定模型更多時間思考單一任務，適合最難的問題、深度重於速度時
- Ultra：用 subagent 平行處理複雜任務的不同部分，適合工作可以切成有意義的區塊時
額度概念
ChatGPT Plus 的 Codex 用量是每 5 小時一個滾動視窗，而且本機訊息和 cloud task 共用同一份額度，另外可能有週上限。不同模型的額度區間不同。
💡 這正是「Claude 當大腦、Codex 當雙手」有意義的原因：兩份訂閱各有各的窗口，分開用等於總產能加倍。但也要注意——Codex 的額度不是無限的，一次開 5 個 pane 全速跑會很快吃完 5 小時的量。實務上 2–3 個平行 worker 比較穩。
建議的初始設定
1. 建立 ~/.codex/config.toml
# 預設用哪個模型（⚠️ 2026-08-31 後不要再寫 gpt-5.4）
model = "gpt-5.6-terra"
model_reasoning_effort = "medium"
# 日常安全預設
approval_policy = "on-request"
sandbox_mode = "workspace-write"
# 常用 profile：一鍵切換安全等級
[profiles.paranoid]
approval_policy = "untrusted"
sandbox_mode = "read-only"
[profiles.batch]
approval_policy = "never"
sandbox_mode = "workspace-write"用法：codex --profile paranoid（純分析）、codex --profile batch（量產）。
2. 建立全域 ~/.codex/AGENTS.md
# 全域指示
- 回答用繁體中文，技術名詞保留英文
- 修改前先說明你要做什麼，做完列出改了哪些檔案
- **不要 git commit、不要 git push**，除非我明確要求
- 不確定的事情直接說不確定，不要猜最後兩條對你特別重要——你的兩個 repo 都規定 commit 由 orchestrator 統一做。
3. 在兩個 repo 建 AGENTS.md
⚠️ 你的 Obsidian-med-note 已經有 AGENTS.md 了。確認它的內容是不是也適合給 Codex 讀（它會讀，Claude Code 不會——除非 CLAUDE.md 用 @AGENTS.md 匯入）。
Taiwan_IM_board 目前只有 CLAUDE.md。要讓 Codex 也遵守那些規則，需要建一份 AGENTS.md（可以只放 Codex 需要的子集）。
更新
npm update -g @openai/codex # npm 安裝
brew upgrade --cask codex # Homebrew 安裝🔗 相關筆記
- 01-什麼是Codex-CLI — 上一步
- 03-互動模式基本操作 — 下一步
- 05-AGENTS-md與config-toml — 設定檔完整說明
- Herdr 02 — 同一個 WSL2 環境
- Claude Code CLI 02 — 另一支的安裝
最後更新：2026-08-04