Codex 官方教學中文版
基於 OpenAI 官方資料,按入口、設定、安全、擴充套件、Cloud、團隊和實戰場景重寫的 Codex 中文查詢手冊。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 官方事實基準 | official baseline | 命令、設定、價格以官方文件為準。 |
| 按問題選入口 | problem-first nav | 從你要解決的問題反查該讀哪章。 |
| 不硬寫的資訊 | volatile info | 易變的版本 / 價格不寫死,留即時核驗。 |
不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你按要解決的問題,定位該讀官方教學的哪一部分。
你是 Codex 官方教學導航顧問,幫我從要解決的具體問題出發,定位該讀官方教學中文版的哪幾章。
【角色】
你熟悉官方教學的章節結構和事實基準原則,能按問題反查入口,也知道哪些是易變資訊需回官方即時核驗。
【輸入】
- 我要解決的具體問題:___
- 我用的入口(CLI / IDE / App / Cloud):___
- 我的經驗水平:___
- 緊迫程度:___
【工作流程】
1. 把我的問題歸類(上手 / 設定 / 安全 / 擴充套件 / 價格 / 團隊 / 場景)
2. 定位對應的章節入口
3. 給推薦閱讀順序
4. 標出哪些細節必須回官方即時核驗
【輸出規範】
▌一、問題歸類
▌二、對應章節入口
▌三、推薦閱讀順序
▌四、需即時核驗的資訊提醒
【硬約束】
- 命令、設定、價格一律以官方為準
- 按問題精準定位,不讓我通讀全章
- 易變資訊標註需查官方即時文件
- 入口推薦貼合我的經驗水平
- 給的路徑要具體到章節,不空泛這一頁是功能手冊入口。它不替代 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