官方教程中文版新手必讀
新手必讀
從定位、快速開始、登入認證、術語和安全檢查開始，建立 Codex 的第一條安全使用閉環。
第一次接觸 Codex，不要從複雜自動化開始。先完成定位、quickstart、認證、術語和安全清單這 5 步，再讓它改真實專案。
這一章只建立第一條安全閉環：知道 Codex 是什麼，能跑通一個最小任務，認證方式清楚，術語不混淆，第一次改程式碼前有檢查清單。
推薦順序
flowchart LR
A[理解定位] --> B[快速上手]
B --> C[登入認證]
C --> D[術語速查]
D --> E[安全清單]
E --> F[小範圍真實任務]
style E fill:#dcfce7,stroke:#22c55e,stroke-width:2px章節速查
理解 Codex 定位
先分清 Codex 是 coding agent，不是普通聊天框，也不是無邊界自動運維。
快速上手 Codex
跑通安裝、啟動、最小任務和結果檢查，先建立第一條閉環。
完成登入和認證
分清 ChatGPT 登入、API key、CI/CD auth 和憑據安全邊界。
新手術語速查
回查 agent、sandbox、approval、MCP、context、diff 等常見術語。
第一次安全使用清單
第一次讓 Codex 改程式碼前，逐項確認範圍、許可權、驗證和回復。
從原理到實戰
想先建立完整認知，走 12 篇理解路線。
新手判斷標準
- 能解釋 Codex 會讀檔案、改檔案、跑命令，也會受到當前入口和許可權邊界限制。
- 能完成一次只讀專案理解任務，再進入小範圍修改。
- 能說清認證憑據放在哪裡、哪些資訊不能貼進公開文件或日誌。
- 能在任務結束時找到 diff、測試結果、未驗證項和剩餘風險。
- 能知道遇到陌生詞時回術語頁，而不是憑感覺理解。
學完本章你應該做到什麼
學完這章，不要求你掌握所有 Codex 功能，但應該能獨立完成這條最小閉環：
- 選擇 App、IDE extension、CLI 或 Cloud 中一個入口。
- 登入並確認當前專案或 repository。
- 發起只讀專案理解任務。
- 選擇一個低風險小改動。
- 檢視 diff。
- 跑至少一個驗證命令。
- 記錄未驗證項。
如果這 7 步做不到，先不要繼續學 MCP、subagents、Cloud automation 或團隊治理。
本章不解決什麼
這一章不深入講：
- 複雜
config.toml。 - MCP server 配置。
- skills / subagents / plugins。
- Cloud environment 高階配置。
- 企業治理、SSO、SCIM、managed config。
- 大型遷移和多 agent 協作。
這些放在後續章節。新手階段先建立正確邊界，避免一開始就把 Codex 當成無邊界自動化工具。
配套從原理到實戰
每個新手必讀章節都有對應的深度講解：
- 理解 Codex 定位：Codex 到底是什麼
- 快速上手：一次任務是怎麼完成的
- 安全清單：Codex 為什麼需要審批和沙箱
返回 官方教程中文版總目錄
接下來去哪
先理解定位
第一篇先建立邊界，避免一開始就用錯入口。
再跑 Quickstart
跑通最小任務，不急著接複雜專案。
補認證
把登入、API key、CI/CD 和憑據安全分開理解。
最後過安全清單
第一次真實改程式碼前，把範圍、許可權、驗證和回復確認完。