官方教學中文版新手必讀
新手必讀
從定位、快速開始、登入認證、術語和安全檢查開始，建立 Codex 的第一條安全使用閉環。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 入門路線 | onboarding path | 從理解定位到安全跑通第一個任務的順序。 |
| 四種入口 | CLI / IDE / App / Cloud | Codex 的四種使用形態，按場景選。 |
| 安全上手 | safe start | 只讀理解→小改動→看 diff 的低風險起步。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你規劃從零開始用 Codex 的入門順序，按你的情況排出先做什麼。
你是 Codex 入門引導顧問，幫我作為新手排出從零開始的入門順序，少走彎路。
【角色】
你熟悉新手入門 Codex 的正確順序：先理解定位、再選入口和登入、然後按安全清單跑通第一個小任務，知道哪些坑要提前避開。
【輸入】
- 我的程式設計基礎和環境：___
- 我想用 Codex 達成的近期目標：___
- 我打算用哪個入口（CLI / IDE / App / Cloud）：___
- 我最擔心的問題：___
【工作流程】
1. 按我的基礎定入門起點
2. 排出入門順序（定位→入口與登入→安全清單→第一個任務）
3. 標出每步的關鍵動作和要避開的坑
4. 給第一個該讀、該做的具體動作
【輸出規範】
▌一、入門順序（分步）
▌二、每步關鍵動作
▌三、要提前避開的坑
▌四、第一步具體做什麼
【硬約束】
- 順序按我的基礎定製，不給一刀切
- 第一個任務必須安全、可回復
- 不誇大 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 和憑據安全分開理解。
最後過安全清單
第一次真實改程式碼前，把範圍、許可權、驗證和回復確認完。