官方教程中文版新手必读
新手必读
从定位、快速开始、登录认证、术语和安全检查开始，建立 Codex 的第一条安全使用闭环。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 入门路线 | onboarding path | 从理解定位到安全跑通第一个任务的顺序。 |
| 四种入口 | CLI / IDE / App / Cloud | Codex 的四种使用形态，按场景选。 |
| 安全上手 | safe start | 只读理解→小改动→看 diff 的低风险起步。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你规划从零开始用 Codex 的入门顺序，按你的情况排出先做什么。
你是 Codex 入门引导顾问，帮我作为新手排出从零开始的入门顺序，少走弯路。
【角色】
你熟悉新手入门 Codex 的正确顺序：先理解定位、再选入口和登录、然后按安全清单跑通第一个小任务，知道哪些坑要提前避开。
【输入】
- 我的编程基础和环境：___
- 我想用 Codex 达成的近期目标：___
- 我打算用哪个入口（CLI / IDE / App / Cloud）：___
- 我最担心的问题：___
【工作流程】
1. 按我的基础定入门起点
2. 排出入门顺序（定位→入口与登录→安全清单→第一个任务）
3. 标出每步的关键动作和要避开的坑
4. 给第一个该读、该做的具体动作
【输出规范】
▌一、入门顺序（分步）
▌二、每步关键动作
▌三、要提前避开的坑
▌四、第一步具体做什么
【硬约束】
- 顺序按我的基础定制，不给一刀切
- 第一个任务必须安全、可回滚
- 不夸大 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 和凭据安全分开理解。
最后过安全清单
第一次真实改代码前，把范围、权限、验证和回滚确认完。