Codex CLI 從 0 開始使用教學 - 完整學習筆記

給已經懂 Codex 概念、要在終端機真的用起來的人：安裝登入、sandbox 與 approval 權限模型、AGENTS.md 與 config.toml、codex exec 自動化，以及怎麼被 Claude 指揮當「雙手」。

先分清楚：這份跟另一份的差別

	Codex 從 0 開始使用教學	本份（Codex CLI）
講什麼	Codex 這個產品：Project、Thread、cloud task、Skills、Automations	終端機裡的 `codex` 指令
適合	建立整體心智模型	實際在 WSL / mac 終端機操作
重點	觀念與工作流	sandbox / approval、config.toml、exec 自動化

建議先讀那一份的 01–03 建立觀念，再回來讀這份。

Codex CLI 是 OpenAI 的 coding agent，跑在你自己的電腦上。 用 ChatGPT 帳號登入（Plus 就可以），在終端機裡讀你的 repo、改檔案、跑指令。

對本站作者的定位很明確：它是「雙手」——負責量產與機械性工作，把 Claude 的額度留給判斷與醫學查證。 完整分工見 Herdr 08。

檔案	主題	說明
01-什麼是Codex-CLI	什麼是 Codex CLI	定位、跟 Codex app / Claude Code 的差別
02-安裝與登入	安裝與登入	npm / brew / 安裝腳本、ChatGPT 登入、Windows 建議
03-互動模式基本操作	互動模式	斜線指令、快捷鍵、session resume
04-Sandbox與Approval權限模型	⚠️ 權限模型	兩個獨立的旋鈕，最該讀懂的一章
05-AGENTS-md與config-toml	設定	`AGENTS.md` 階層、`config.toml` 完整鍵值、profiles
06-非互動模式codex-exec	自動化	`codex exec`、JSONL、CI 整合
07-MCP與擴充	擴充	MCP、Codex 當 MCP server
08-實戰-被Claude指揮的雙手	實戰	搭配 Herdr 的分工、任務檔寫法
09-疑難排解與速查表	排錯與速查	症狀對照 + cheat sheet

裝：npm i -g @openai/codex 或 brew install --cask codex。⚠️ Windows 支援仍是 experimental，官方建議在 WSL2 裡跑。
登入：跑 codex，選 Sign in with ChatGPT。Plus / Pro / Business / Edu / Enterprise 都可以。
最重要的觀念：sandbox mode 和 approval policy 是兩個獨立的旋鈕——一個管「技術上能做什麼」，一個管「什麼時候要問你」。
專案指示放 AGENTS.md（不是 CLAUDE.md）。全域的放 ~/.codex/AGENTS.md。
設定放 ~/.codex/config.toml，可以定義 profiles 一鍵切換不同安全等級。
自動化用 codex exec "TASK"（別名 codex e），--json 出 JSONL、-o 存最後訊息。
⚠️ 模型異動：gpt-5.4 與 gpt-5.4-mini 於 2026-08-31 從 ChatGPT 登入的 Codex 退場——存在設定 / 自訂 agent / 排程任務裡的舊模型名要換掉。詳見 02-安裝與登入。

Codex 官方文件：https://developers.openai.com/codex
Codex CLI 頁：https://developers.openai.com/codex/cli
原始碼：https://github.com/openai/codex（Apache-2.0）
讀取日期 2026-08-04。⚠️ 本教學的部分細節（指令旗標、config 鍵值、模型名）由公開資料與社群整理交叉比對而來，官方文件站在本次撰寫環境無法直接抓取。實際操作請以你安裝版本的 codex --help 與 /help 為準。

最後更新：2026-08-04