OpenAI Codex 中文教學
基於 OpenAI 官方資料重寫的 Codex 中文教學,覆蓋 App、IDE、CLI、Cloud 和安全邊界。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 兩條閱讀路徑 | two paths | 理解篇和官方教學兩條主線,按目標選。 |
| 事實基準 | source of truth | 教學以官方文件為準、需即時核驗的內容。 |
| 最低標準 | minimum bar | 學完該達到的基本能力門檻。 |
不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你規劃這套 Codex 教學怎麼讀,按你的目標排出路徑和順序。
你是 Codex 教學導讀顧問,幫我按自己的目標排出這套教學該怎麼讀、先讀什麼、讀到什麼程度算夠。
【角色】
你瞭解本教學的兩條閱讀路徑(先理解原理再進官方命令設定)、各章定位、學完後的最低標準,也知道哪些內容以官方為準需即時核驗。
【輸入】
- 我的目標(快速上手 / 體系化理解 / 團隊推廣):___
- 我的基礎(沒用過 Agent / 用過別的工具 / 有經驗):___
- 可投入時間:___
- 我最想先解決的問題:___
【工作流程】
1. 按目標和基礎選閱讀路徑(理解篇為主還是直奔官方命令)
2. 排出章節閱讀順序
3. 標出哪些內容必須以官方即時文件為準
4. 給學完的自測標準
【輸出規範】
▌一、推薦閱讀路徑 + 理由
▌二、章節閱讀順序
▌三、需即時核驗的內容提醒
▌四、學完的自測標準
【硬約束】
- 路徑按我的目標和基礎定製,不一刀切
- 先理解後命令,不要一上來背設定
- 版本 / 命令類內容提醒以官方為準
- 自測標準要可檢驗,不空談學會了
- 時間不夠時給最小必讀子集這組教學只把穩定事實寫進正文:Codex 是 OpenAI 的 coding agent,官方入口覆蓋 App、IDE extension、CLI 和 Cloud。價格、模型列表、版本變化這類高波動資訊只給官方入口,不在正文硬寫死。
Codex 不是單一終端工具,也不是隻在網頁裡執行的助手。OpenAI 官方教學現在把它拆成幾種入口:本地 App、IDE 擴充套件、命令列 CLI,以及在 chatgpt.com/codex 執行的 Cloud 任務。你選擇哪一個入口,取決於任務要不要貼近編輯器、要不要長期後臺執行、要不要受本地 sandbox 和 approval 控制。
flowchart LR
Need[你的任務] --> Entry{選擇入口}
Entry --> App[Codex App<br/>本地專案與桌面體驗]
Entry --> IDE[IDE Extension<br/>貼近編輯器上下文]
Entry --> CLI[Codex CLI<br/>終端原生與指令碼化]
Entry --> Cloud[Codex Cloud<br/>後臺任務與 PR 流程]
App --> Guard[Sandbox / approvals / network]
IDE --> Guard
CLI --> Guard
Cloud --> Review[Diff / logs / PR review]
Guard --> Review
兩條閱讀路徑
先讀什麼
- 第一次用 Codex:先讀從原理到實戰,再跑 quickstart。
- 已經會用但結果不穩:先補上下文、AGENTS.md、審批和沙箱。
- 準備團隊落地:先看安全邊界、Cloud / GitHub 流程、託管設定和審查機制。
- 想接 MCP、Skills、Subagents、Hooks:先確認這些能力解決的是複用、外部上下文、隔離執行還是自動檢查,不要一次性全開。
學完後的最低標準
這套 Codex 教學的目標不是讓你記住所有入口,而是能判斷“這個任務應該怎麼交給 Codex”。學完後至少要能做到:
- 能區分 App、IDE、CLI 和 Cloud 各自適合的任務。
- 能給 Codex 一個清楚的目標、範圍、邊界和驗證方式。
- 能讀懂 diff、記錄、測試結果和剩餘風險。
- 能用規則、Skills、MCP 或 Subagents 沉澱高頻工作,而不是每次臨時寫長 prompt。
- 能在安全邊界內逐步放權,不把生產專案直接交給最大自治模式。
如果一個任務無法驗證,就先不要交給 Codex 修改。先讓它分析、分診、列計劃,再進入小範圍執行。
事實基準
- OpenAI Codex 官方文件:https://developers.openai.com/codex
- Codex quickstart:https://developers.openai.com/codex/quickstart
- Agent approvals & security:https://developers.openai.com/codex/agent-approvals-security
- 上游原始碼:https://github.com/openai/codex
接下來去哪
Codex 是什麼
先把 coding agent、聊天助手、本地工具和雲端任務分清。
CLI / App / IDE / Cloud 怎麼選
按任務型別選擇入口,避免每個入口都裝卻沒有一個用熟。
官方教學中文版
按官方資料查詢安裝、登入、設定、安全、擴充套件和實戰場景。
第一次安全使用
從只讀理解專案開始,再進入小範圍寫入和驗證。