Codex / 入门
Codex 快速开始
用最小闭环启动 Codex：安装、登录、打开项目、描述任务、审查 diff、运行验证。
快速开始
快速开始的目标是建立最小闭环：安装或打开 Codex，进入一个低风险仓库，给出明确任务，允许它小步修改，运行验证，然后审查结果。
首次使用不要直接给大范围重构。先让 Codex 解释项目结构、依赖、运行命令和测试方式，确认它理解上下文。
cd your-project
codex "先解释这个仓库如何运行，不要改文件"第一条工程任务
Codex 对结构化任务响应更稳定。写出目标、范围、限制、验收标准和验证命令。
目标：修复设置页主题切换不生效。
范围：settings 页面和 theme provider。
限制：不要改登录、支付、数据库。
验收：pnpm build 通过；主题刷新后仍保留。
验证：运行 pnpm build，并说明改动文件。审查和继续
Codex 结束后，不要只看总结。查看改动文件、diff、命令输出和剩余风险。需要继续时，让它基于当前 diff 做小步调整。
git diff
pnpm build
pnpm test完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
完整入门闭环
快速开始应该覆盖五件事：选择入口、准备仓库、写任务、批准执行、验证收尾。官方文档把 Codex 放在开发工作流中，而不是只给一个一次性 prompt。新手最容易漏掉的是“验证”和“审查”。
- 选择一个低风险仓库或新分支，先确认没有未保存的关键改动。
- 让 Codex 解释项目结构、运行命令、测试命令和主要风险，不要一上来让它编辑。
- 把第一条任务写成工程卡片，包含目标、范围、禁止项、验收标准、验证命令。
- 如果 Codex 请求更高权限，先看它要运行的命令、触碰的路径和原因。
- 完成后查看 diff、命令输出和剩余风险；必要时要求它只做小范围修正。
快速开始的合格结果不是“页面看起来改了”，而是你能说清楚 Codex 改了哪些文件、为什么这样改、用什么命令验证、还有哪些事项需要人工判断。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“Codex 快速开始”放回 Codex 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是概念页面，要特别确认它如何影响真实任务：它改变上下文、权限、执行路径、验证方式，还是改变团队协作流程。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 AGENTS.md，哪些运行行为应该交给 config.toml、permission profile、skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Codex 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。
Codex 实操注意事项
围绕本地环境、权限升级、远程入口、自动化失败和回滚补齐 Codex 使用中最容易被忽略的执行细节。
Codex 实操注意事项
这一页属于 Codex 的核心概念。学习时要把概念和真实执行联系起来：它会改变上下文、权限、任务拆分、验证路径，还是改变团队协作方式。
处理“Codex 快速开始”相关任务时，建议始终先确认当前 Git 状态和工作目录。Codex 可以很快完成修改，但它不会自动知道哪些未提交改动来自用户、哪些文件不能碰、哪些命令会影响生产环境。
- 本地任务优先使用低风险分支或工作树，完成后用 git diff 审查。
- 涉及安装依赖、联网、数据库、部署、push、删除、reset 时，先要求 Codex 解释影响再批准。
- 远程或协作入口生成的结果，也要回到 PR、CI、构建日志和测试证据中确认。
- 自动化任务要提前定义失败输出和退出条件，避免 Codex 在错误方向上反复尝试。
把 Codex 当成能执行命令的工程队友，而不是只会写文本的助手。越靠近真实系统，越需要明确边界、证据和回滚。