OpenAI · 编程智能体
Codex 使用攻略
把复杂的仓库任务，交给一个会执行、验证和解释的代码协作者。
Codex 可以在终端、IDE、网页和桌面端协助完成实现、重构、调试、测试与代码审查。高质量用法不是只问答案，而是给清楚目标、边界与验收标准，让它在工作区里闭环推进。
约 10 分钟资料核验 含安全检查
本轮资料更新
10 月更新 · CLI 0.166.0
- 10 月 29 日的 CLI 0.166.0 增加会话文本选择、队列恢复和专用网络诊断命令。
- 继续或分叉任务时保留已确认的权限设置；升级后仍应核对当前工作区与执行权限。
01 · 快速上手
从第一次启动，到完成一个真实任务
01
在项目根目录启动
让 Codex 先读取 README、依赖、项目约定和 Git 状态；不要一上来就授权修改。
02
先侦察，再执行
先要求定位入口、列出影响范围与验证命令，确认方向后再进入实现。
03
用事实闭环验收
要求它运行测试、解释变更，并把失败项、未完成项和风险单独列出。
建议从这个任务开始
请先阅读与结算流程相关的文件，不要修改代码。输出：1. 当前流程 2. 可能的缺陷 3. 最小改动计划 4. 验证命令。
先用小样本验证结果，再扩大任务范围。
02 · 基础配置
上手设置与任务模板
仓库级行为说明 · AGENTS.md
# AGENTS.md
## 工作方式
- 修改前先说明计划和影响范围
- 使用 pnpm，不要擅自替换依赖
- 完成后运行 pnpm test 和 pnpm lint
- 不要读取或输出 .env 文件
## 验收标准
用实际命令与结果说明验证情况。命令按当前官方资料整理；选择适合自己系统的安装方式，执行前核对版本与工作目录。
03 · 实用技巧
真正拉开效果差距的使用习惯
技巧 01
把需求改写成验收清单
把“新增登录页”拆成登录方式、错误态、移动端表现和验收场景，减少隐含假设。
技巧 02
跨文件任务先要计划
要求列出涉及文件、依赖关系与验证方式；计划正确后再允许编辑。
技巧 03
把 Git 当安全网
保持 diff 小而清晰；删除、迁移、部署等高风险动作先解释影响。
可直接复用的任务模板
请先阅读与结算流程相关的文件，不要修改代码。输出：1. 当前流程 2. 可能的缺陷 3. 最小改动计划 4. 验证命令。
04 · 安全边界
明确使用与执行边界
执行前检查
- 默认在隔离分支或工作树里执行
- 不要把生产密钥、.env 或个人数据放进上下文
- 删除、迁移、部署前必须解释目标与影响
05 · 学习资源
继续深入
官方资料用于确认安装、命令和权限；社区资料用于补充中文经验与案例。涉及版本的内容请以官方为准。