--- title: "Codex CLI 從 0 開始使用教學 - 完整學習筆記" type: note specialty: Programming tags: [codex-cli從0開始使用教學, 00-index, codex, agent] created: 2026-08-04 updated: "2026" modified: 2026-08-04 --- # Codex CLI 從 0 開始使用教學 - 完整學習筆記 > 給已經懂 Codex 概念、要在終端機真的用起來的人：安裝登入、sandbox 與 approval 權限模型、`AGENTS.md` 與 `config.toml`、`codex exec` 自動化，以及怎麼被 Claude 指揮當「雙手」。 --- ## 先分清楚：這份跟另一份的差別 | | [[Programming/Codex/Codex從0開始使用教學/00-Index\|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 的額度留給判斷與醫學查證。** 完整分工見 [[Programming/Herdr/Herdr從0開始使用教學/08-Claude當大腦-Codex當雙手|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-安裝與登入]]。 --- ## 🔗 相關筆記 - [[Programming/Codex/Codex從0開始使用教學/00-Index|Codex 從 0 開始使用教學]] — 觀念層，先讀那份 - [[Programming/Claude-Code/Claude-Code-CLI從0開始使用教學/00-Index|Claude Code CLI 從 0 開始使用教學]] — 另一支 CLI，本站的「大腦」 - [[Programming/Herdr/Herdr從0開始使用教學/08-Claude當大腦-Codex當雙手|Herdr 08 - Claude 大腦 + Codex 雙手]] — 兩者怎麼分工 - [[Programming/Git-GitHub/00-Index|Git & GitHub 從零開始教學]] — Codex 預設要求在 git repo 裡跑 --- ## 參考資料 - Codex 官方文件： - Codex CLI 頁： - 原始碼：（Apache-2.0） - 讀取日期 2026-08-04。⚠️ **本教學的部分細節（指令旗標、config 鍵值、模型名）由公開資料與社群整理交叉比對而來**，官方文件站在本次撰寫環境無法直接抓取。**實際操作請以你安裝版本的 `codex --help` 與 `/help` 為準。** *最後更新：2026-08-04*