官方教程中文版新手必读
新手必读
从定位、快速开始、登录认证、术语和安全检查开始，建立 Codex 的第一条安全使用闭环。
第一次接触 Codex，不要从复杂自动化开始。先完成定位、quickstart、认证、术语和安全清单这 5 步，再让它改真实项目。
这一章只建立第一条安全闭环：知道 Codex 是什么，能跑通一个最小任务，认证方式清楚，术语不混淆，第一次改代码前有检查清单。
推荐顺序
flowchart LR
A[理解定位] --> B[快速上手]
B --> C[登录认证]
C --> D[术语速查]
D --> E[安全清单]
E --> F[小范围真实任务]
style E fill:#dcfce7,stroke:#22c55e,stroke-width:2px章节速查
理解 Codex 定位
先分清 Codex 是 coding agent，不是普通聊天框，也不是无边界自动运维。
快速上手 Codex
跑通安装、启动、最小任务和结果检查，先建立第一条闭环。
完成登录和认证
分清 ChatGPT 登录、API key、CI/CD auth 和凭据安全边界。
新手术语速查
回查 agent、sandbox、approval、MCP、context、diff 等常见术语。
第一次安全使用清单
第一次让 Codex 改代码前，逐项确认范围、权限、验证和回滚。
从原理到实战
想先建立完整认知，走 12 篇理解路线。
新手判断标准
- 能解释 Codex 会读文件、改文件、跑命令，也会受到当前入口和权限边界限制。
- 能完成一次只读项目理解任务，再进入小范围修改。
- 能说清认证凭据放在哪里、哪些信息不能贴进公开文档或日志。
- 能在任务结束时找到 diff、测试结果、未验证项和剩余风险。
- 能知道遇到陌生词时回术语页，而不是凭感觉理解。
学完本章你应该做到什么
学完这章，不要求你掌握所有 Codex 功能，但应该能独立完成这条最小闭环：
- 选择 App、IDE extension、CLI 或 Cloud 中一个入口。
- 登录并确认当前项目或 repository。
- 发起只读项目理解任务。
- 选择一个低风险小改动。
- 查看 diff。
- 跑至少一个验证命令。
- 记录未验证项。
如果这 7 步做不到，先不要继续学 MCP、subagents、Cloud automation 或团队治理。
本章不解决什么
这一章不深入讲：
- 复杂
config.toml。 - MCP server 配置。
- skills / subagents / plugins。
- Cloud environment 高级配置。
- 企业治理、SSO、SCIM、managed config。
- 大型迁移和多 agent 协作。
这些放在后续章节。新手阶段先建立正确边界，避免一开始就把 Codex 当成无边界自动化工具。
配套从原理到实战
每个新手必读章节都有对应的深度讲解：
- 理解 Codex 定位：Codex 到底是什么
- 快速上手：一次任务是怎么完成的
- 安全清单：Codex 为什么需要审批和沙箱
返回 官方教程中文版总目录
接下来去哪
先理解定位
第一篇先建立边界，避免一开始就用错入口。
再跑 Quickstart
跑通最小任务，不急着接复杂项目。
补认证
把登录、API key、CI/CD 和凭据安全分开理解。
最后过安全清单
第一次真实改代码前，把范围、权限、验证和回滚确认完。