Codex CLI
跑在本機終端機。適合工程師、產品人、創作者在自己的 repo 裡讀 code、修 bug、加功能、寫測試。
本頁重點
01 / Intro
Codex 是什麼
Codex 是 OpenAI 的程式工作代理。你可以把它想成「懂得看專案、會執行指令、會提出修改、能陪你完成工程任務」的 AI 夥伴。
Codex Web
雲端版代理，入口在 chatgpt.com/codex。適合把任務交給雲端環境處理，再回來看結果。
Codex in IDE
可搭配 VS Code、Cursor、Windsurf 等編輯器。適合邊看檔案邊請 Codex 協作。
一句話：ChatGPT 比較像對話腦；Codex 比較像會進專案現場工作的工程助手。
02 / Setup
安裝方式
官方目前提供 script、npm、Homebrew、GitHub Release 幾種方式。一般 Mac 使用者建議先用官方安裝 script 或 Homebrew。
Mac / Linux 官方安裝 script
curl -fsSL https://chatgpt.com/codex/install.sh | shnpm 安裝
npm install -g @openai/codexHomebrew 安裝
brew install --cask codexWindows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"登入方式
- 打開終端機，輸入
codex。 - 選擇 Sign in with ChatGPT。
- 用 Plus、Pro、Business、Edu 或 Enterprise 帳號登入。
- 也可以使用 API key，但需要額外設定，初學者先用 ChatGPT 登入最直覺。
03 / Daily Use
基本使用
互動模式
在專案資料夾輸入 codex，像跟工程搭檔講話一樣描述任務。
cd your-project
codex
# 然後輸入：請先閱讀這個專案，告訴我架構與啟動方式單次任務
把任務直接交給 Codex。適合小修改、整理文件、先做 code review。
codex "幫我找出登入流程可能失敗的地方，先不要修改檔案"適合交給 Codex 的任務
- 讀懂陌生專案，整理架構圖與啟動步驟。
- 修小 bug，並補一個能重現問題的測試。
- 把重複邏輯整理成函式或元件。
- 檢查 PR，找出可能漏掉的錯誤與安全風險。
- 把 README、安裝步驟、部署流程寫清楚。
04 / 808 Workflow
808 建議工作流
1
先讓它讀，不要急著改
第一句先說：「請只閱讀，不要修改，先告訴我你理解的架構、風險、建議步驟。」
2
要求它提出計畫
要 Codex 列出會改哪些檔案、為什麼改、如何驗證。你看懂再放行。
3
小步修改
一次只做一個功能或一個 bug。避免一次叫它重構整個世界。
4
一定要驗證
請它執行測試、lint、build，並回報真實輸出。沒有驗證，不算完成。
5
最後請它寫交付摘要
列出改了什麼、怎麼測、還有什麼風險。這就是給人看的 PR 摘要。
808 推薦第一句 prompt
「請先不要改檔案。請閱讀這個專案，告訴我：1. 專案用途，2. 主要資料流，3. 啟動與測試方式，4. 你會先檢查哪三個風險。」
05 / Community Playbook
X 社群正在討論的進階用法
我依 2026-06-12 的公開 X 搜尋與 fxtwitter 摘要，挑出幾個互動高、可落地的方向。重點不是多背指令，而是把 Codex 從「聊天工具」升級成「有記憶、有規範、可驗證的工程系統」。
1. 用 AGENTS.md 固化團隊規則
高互動文章反覆提到：成功的 prompt 不要每次重打，應該沉澱到 AGENTS.md。內容包含 repo 架構、啟動/測試指令、PR 標準、禁止事項，以及「完成」的驗證條件。
2. 複雜任務先進 Plan mode
遇到模糊需求、跨多檔案修改、長時間任務，先要求 Codex 只規劃、不動手。可用 /plan 或要求它先列階段、風險、需確認問題與驗證方式。
3. 把反覆流程變成 Skills / 模板
社群常見做法是把 code review、release、debug、文件更新等流程做成可重用模板。原則：一個 skill 只做一件事，description 要像「路由信號」一樣清楚，讓代理知道何時該用。
4. 用 MCP 接外部工具，但先限權
官方文件確認 Codex CLI / IDE extension 支援 MCP，可接文件、瀏覽器、Figma、內部工具等。建議先接 read-only 文件或查詢工具，再逐步開放寫入；需要 token 的 MCP 不要把密鑰寫進 prompt。
5. Worktree 隔離長任務
高階用戶會把大改動丟到獨立 git worktree / branch，讓 Codex 長時間跑也不污染 main。早上回來看 commits、測試輸出與交付摘要，不滿意就整個 worktree 丟掉。
6. 安全不是一句「不要做」
社群也提醒：AGENTS.md 是提醒，不是硬防線。危險動作要靠 sandbox、approval、CI、hook、沒有 production credential 的環境，以及人工部署確認來分層保護。
進階版 808 啟動 prompt
「請先不要改檔案。請閱讀本 repo，建立或更新一份精簡 AGENTS.md 草稿，內容只包含：專案架構、啟動/測試指令、coding conventions、禁止事項、完成定義。接著列出一份 plan，等我確認後才開始修改。」
MCP 例：先接文件查詢，再開工具權限
codex mcp add context7 -- npx -y @upstash/context7-mcp
codex
/mcp808 建議：初學者先學「讀 repo → Plan → 小步改 → 測試 → 摘要」。進階者再加「AGENTS.md → Skills → MCP → worktree → CI review」這條複利路線。
06 / Guardrails
安全與權限
不要把祕密交給 AI
不要貼 API key、密碼、付款資訊、客戶個資。需要環境變數時，只說變數名稱，不貼值。
- 第一次進陌生 repo，先用 read-only 任務。
- 大型改動前先建立 git branch。
- 要求 Codex 說明每個檔案為什麼要改。
- 部署、刪資料、改資料庫 schema 前必須人工確認。
- 把 AI 的輸出當成資深同事建議，不是法律或安全保證。
07 / FAQ
常見問題
Codex 跟 Claude Code 差在哪？
兩者都是 coding agent。Claude Code 在 Anthropic 生態系裡很成熟；Codex 是 OpenAI 的 coding agent，和 ChatGPT / OpenAI 工具鏈整合更深。實務上可以把兩個都當成工程夥伴，用同一套「先讀、再計畫、小步改、要驗證」流程管理。
我不是工程師可以用嗎？
可以，但建議從「讀懂專案、解釋錯誤、整理 README」開始，不要一開始就要求它大量改 code。
需要付費嗎？
官方 README 建議使用 ChatGPT 帳號登入，Plus、Pro、Business、Edu、Enterprise 等方案可使用相應能力。API key 使用會依 OpenAI API 計費與設定。
來源與延伸閱讀
內容依 OpenAI Codex GitHub README、OpenAI Developers 文件，以及 2026-06-12 公開 X 搜尋 / fxtwitter 摘要整理。社群互動數僅作趨勢參考，安裝指令與功能仍以官方文件為準。