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 怎么选
按任务类型选择入口,避免每个入口都装却没有一个用熟。
官方教程中文版
按官方资料查询安装、登录、配置、安全、扩展和实战场景。
第一次安全使用
从只读理解项目开始,再进入小范围写入和验证。