基础
进入交互模式
codex在当前仓库开始一次任务。
CODEX / FIELD MANUAL中文速查表
把一句模糊想法，变成可验证的改动。
从启动命令、提示词结构到权限与自动化，一页掌握 Codex 的高质量工作流。 少猜测，多证据；先定位，再动手。
›
检查当前实现，定位根因，做最小兼容修复。完成后运行相关测试，并用实际输出说明结果；不要改动无关文件。
/
7 个核心章节01
START HERE
四条命令，开始工作
先把 Codex 放到正确的仓库和上下文里。
定位
指定工作目录
codex -C ./your-repo从任意位置进入目标仓库。
视觉
携带图片
codex -i bug.png "修复截图里的布局问题，并验证响应式页面"把截图作为任务上下文。
续接
继续上次任务
codex resume --last恢复最近一次交互会话。
开工前 10 秒：确认当前目录、Git 状态、可写范围与验证命令。路径错了，再强的模型也会做错地方。
02
PROMPT SYSTEM
用四块信息消灭歧义
复杂任务不需要长篇大论，但要让目标、上下文、边界和完成标准同时可见。
01
目标
要改变的最终结果
＋
02
上下文
文件、日志、复现与来源
＋
03
约束
必须保留与禁止触碰的边界
＋
04
完成标准
测试、行为与交付证据
可复制模板
目标：<要实现或修复什么>
上下文：
- 重点文件：<路径>
- 当前现象：<错误、日志、截图或复现步骤>
约束：
- 保持 <接口/行为/依赖> 不变
- 不要 <高风险或超范围动作>
完成标准：
- <测试或构建> 通过
- <目标行为> 已实际验证
- 总结改动、证据与剩余风险不要只说
“帮我优化这段代码。”
→
改成这样
“降低这个函数的重复 I/O，保持公开接口不变，并补测试证明行为一致。”
03
THE LOOP
完整执行闭环
让 Codex 对结果负责，而不只是对代码行数负责。
01INSPECT
调查
读实现、日志与约束
→02PLAN
规划
明确改动面与风险
→03BUILD
实现
做最小、聚焦的修改
→04VERIFY
验证
运行最相关的检查
→05REVIEW
审查
看 diff、回归与残余风险
×
弱交付
“应该已经好了。”
✓
强交付
“构建通过；目标测试 18/18；手动复现不再出现；未触碰支付模块。”
04
CONTROL SURFACE
斜杠命令速查
在交互会话里，用短命令改变模式、补充上下文或检查状态。
命令作用最佳时机
/plan先调查与规划，再进入实现复杂任务/status查看模型、权限、上下文与工作目录开工前/mention把指定文件或目录加入上下文精准定位/diff查看当前 Git 改动实现后/review审查工作区、提交或分支差异交付前/compact压缩长对话，保留关键上下文长任务/permissions调整当前任务的权限范围受阻时/model切换可用模型与推理强度按任务/init生成仓库级 AGENTS.md 起点新项目/mcp查看已连接的 MCP 工具外部系统/skills浏览并调用本地技能重复流程/goal设置并追踪长任务目标持续执行05
DURABLE CONTEXT
把重复要求写进 AGENTS.md
它会在任务开始前自动加载，适合仓库地图、命令、工程约定与完成标准。
~/.codex/AGENTS.md个人全局规则
repo/AGENTS.md仓库共享规则
repo/app/AGENTS.md更近的局部规则优先
规则从根目录向当前目录叠加；越接近当前工作目录，优先级越高。
AGENTS.md 起点
# AGENTS.md
## Project map
- app/: product code
- tests/: automated checks
## Commands
- Install: npm install
- Build: npm run build
- Test: npm test
## Working agreements
- Preserve public APIs unless asked otherwise.
- Reproduce bugs before changing code.
- Keep unrelated user changes intact.
## Done when
- Relevant tests pass.
- The requested behavior is verified.
- Risks and skipped checks are reported.持续改进：当 Codex 重复犯同一种错误，让它复盘并把可复用的纠错规则补进 AGENTS.md。
06
SAFETY BOUNDARIES
权限给到刚刚好
沙箱决定能访问什么，审批策略决定什么时候需要你确认。两者是不同旋钮。
-s
Sandbox
文件与命令的作用范围
read-only只读调查workspace-write日常开发推荐DEFAULTdanger-full-access仅限明确可信环境-a
Approval
何时暂停并请求确认
untrusted非信任命令需批准on-request由 Codex 按风险请求DEFAULTnever失败即返回，不弹审批07
NON-INTERACTIVE
把稳定流程交给自动化
使用 codex exec 运行非交互任务；让输入、输出和权限都可预测。
codex exec "修复 lint，并运行验证"codex exec --json "检查依赖风险"codex exec -o result.md "总结变更"codex review --uncommitted01
先在交互模式跑通
02
固定输入与完成标准
03
限制权限与输出格式
04
最后才接入 CI / 定时任务