Codex 官方教程中文版
基於 OpenAI 官方資料，按入口、配置、安全、擴充套件、Cloud、團隊和實戰場景重寫的 Codex 中文查詢手冊。
這一頁是功能手冊入口。它不替代 OpenAI 官方文件，而是把官方資料按中文開發者的查詢路徑重排：先選入口，再設邊界，再接擴充套件，最後進入 Cloud、團隊和真實場景。
Codex 的官方事實變化很快，所以本系列正文只固定穩定結構：App、IDE extension、CLI、Cloud 四類入口；AGENTS.md / config.toml / sandbox / approval 這條安全配置主線；MCP、Skills、Subagents、Hooks 這組擴充套件能力；以及 Cloud、GitHub、Slack、Linear、CI 這類團隊整合。模型、價格、版本更新和功能成熟度以官方頁面為準。
flowchart TB
Start[新手必讀] --> Entry[產品入口<br/>App / IDE / CLI / Cloud]
Entry --> Guard[規則、安全與配置<br/>AGENTS.md / config.toml / sandbox / approvals]
Guard --> Extend[擴充套件能力<br/>MCP / Skills / Subagents / Hooks]
Extend --> Runtime[雲端與遠端環境]
Runtime --> Team[團隊企業與整合]
Team --> Scenarios[實戰場景與學習路線]
Scenarios --> Versions[版本、遷移與官方影片]官方事實基準
- Quickstart 當前把 Codex 入門拆成 App、IDE extension、CLI 和 Cloud。
- Codex App 官方面向 macOS 和 Windows；平臺差異以對應官方頁面為準。
- Codex CLI 官方支援 macOS、Windows 和 Linux，安裝入口包括
npm install -g @openai/codex和 Homebrew。 - IDE extension 官方入口覆蓋 Visual Studio Code、Cursor、Windsurf 和 Visual Studio Code Insiders。
- Codex Cloud 在
chatgpt.com/codex執行，也可以透過 GitHub PR 評論裡的@codex觸發任務。 - 安全邊界由 sandbox mode、approval policy 和 network access 共同決定；預設網路訪問關閉，本地執行通常受 OS sandbox 限制。
按問題選入口
第一次跑通
從 quickstart、登入認證、術語和安全清單開始，先建立最小閉環。
選擇使用入口
查 App、IDE、CLI、Web、Windows、worktree、本地執行時和瀏覽器能力。
設定安全邊界
查 AGENTS.md、config.toml、approval、sandbox、network 和受保護路徑。
擴充套件 Codex 能力
查 MCP、Skills、Subagents、Hooks、memory、plugins 和 workflow 組合方式。
控制成本和速度
查提示詞、模型選擇、用量入口、提速方法和功能成熟度；具體價格以官方為準。
使用 Cloud 和遠端環境
查 Cloud runtime、網路許可權和遠端開發環境邊界。
團隊與企業落地
查 GitHub、Slack、Linear、CI/CD、SDK、企業治理和託管配置。
按場景學習
按 Web、遊戲、原生應用、生產系統和效率路線選擇學習順序。
真實任務模板
把 bug 分診、PR review、資料查詢、UI 構建、部署等需求改寫成 Codex 任務。
版本與遷移
只用來查官方演示、遷移說明和變更入口；不把高波動時間線當長期教程。
推薦學習順序
- 先讀 從原理到實戰，理解任務、上下文、工具、邊界和驗證。
- 再跑 Quickstart，只做一個可回復的小任務。
- 立刻補 第一次安全使用清單，不要讓第一次體驗變成大範圍改動。
- 寫 AGENTS.md，把專案約定沉澱成 Codex 能穩定讀取的規則。
- 根據入口選擇 CLI / App / IDE / Cloud，不要所有入口同時上手。
- 需要複用和整合時，再進入 MCP、Skills、Subagents、Hooks 和團隊整合。
不硬寫的資訊
- 價格、用量、套餐、模型預設值和上下文視窗。
- 平臺下載按鈕、支援系統的細小差異和版本釋出日期。
- GitHub、Slack、Linear、CI 整合的開關狀態和企業許可權策略。
- changelog、demo video 和遷移時間線。
這些內容只在對應文章裡給官方入口和判斷方法，不在索引頁偽裝成長期事實。
官方資料
- 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
- OpenAI Codex GitHub：https://github.com/openai/codex