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