codex exec 非交互执行模式

交互会话里的 codex 适合"人在回路"、边聊边改；codex exec 则面向 Shell 与脚本中的非交互自动化执行：一次性接收明确任务、按受控环境运行、把结果交给流水线或脚本处理。官方在全面开放公告中明确：需要在 Shell 环境工作流中直接使用 Codex 智能体时，可安装后通过 codex exec 运行 CLI。本节讲清它与交互模式的区别、适用边界、安全前置与落地流程；具体参数与选项以当前版本 codex --help 与官方文档为准。

一、交互模式与非交互 exec 的区别

维度	交互 codex 会话	非交互 codex exec
运行形态	启动终端界面，多轮对话、随时追问与确认	在 Shell/脚本中按给定任务一次运行，不进入持续对话界面
人工参与	人可在关键节点确认、纠偏、补充上下文	运行前把要求写清楚，运行过程中通常不逐条交互
适用场景	探索式开发、需求不清、需要反复澄清的任务	明确、可重复、可验证的任务，如检查、分析、固定改造、流水线步骤
审批与人确认	可按审批策略逐条确认敏感动作	无人值守，必须在运行前用受控沙箱、最小权限与规则把边界定好
结果形态	界面内逐步呈现，人工边看边决定是否采纳	产出改动、报告或退出状态，由脚本/流水线收集后交人工复核
典型位置	开发者本地终端	本地脚本、构建脚本、CI 步骤、定时任务

二、哪些任务适合用 exec，哪些不适合

适合（明确、可重复、可验证）	不适合（应回到交互会话）
对固定规则做一致性检查、代码风格与类型问题扫描建议	需求模糊、需要多轮澄清才知道做什么
按既定模板生成结构化产出（说明、摘要、检查清单）	高风险、强主观判断且需要人实时把关的决策
隔离环境中的重复改造、迁移样板、批量文档整理	对主分支直接写入、对外发布或凭据变更等不可逆动作
流水线中的只读分析与建议生成，供人工采纳	需要根据中间结果反复调整方向的探索任务

三、无人值守运行的安全前置

非交互运行缺少人在现场逐条确认，因此把安全边界前移到运行之前。结合官方安全部署原则，应在启动前满足以下条件：

• 受控工作目录：在干净、隔离、可回退的检出或副本中运行，不直接在生产源码工作区盲跑。
• 最小权限与受限沙箱：默认以受限读写姿态运行；只读可完成的分析任务不给写权限，可写范围限定在项目工作区内。
• 动作规则前置：把允许与禁止的命令、网络可达范围事先定义清楚；危险动作在无人值守时默认不放行。
• 网络最小开放：只允许任务必需的来源；未知域名、安装下载、外部回连先拦截或经白名单放行。
• 凭据安全存放：密钥、token 不写进脚本与仓库，经操作系统安全钥匙串或受保护环境变量读取，运行输出中不回显真实密钥。
• 结果可观测：记录运行任务、产出位置、改动范围与退出状态，便于事后审计与追责。

四、推荐落地流程

1. 备干净基线：确认目录与版本状态干净，必要时使用隔离检出或独立工作线，保证结果可回退。
2. 写自包含任务指令：把目标、输入范围、允许修改范围、禁止动作与验收标准写全，不依赖临场追问。
3. 定边界与权限：确定读写姿态、网络限制与审批规则，敏感动作不在无人值守中自动放开。
4. 受控环境运行：在脚本或流水线中执行 codex exec 任务，收集输出、改动文件清单与退出状态。
5. 人工复核再采纳：用 git diff 审阅改动、运行项目既有检查；确认无误后再由人工 git add、git commit，避免自动提交直接进主干。
6. 记录与迭代：沉淀可重复的任务模板与规则，连续运行稳定后再逐步扩大自动化范围。

五、FAQ

问题	处理建议
codex exec 有哪些命令行参数	不凭记忆照抄参数；以本机 codex --help、codex exec --help 与当前官方文档为准，不同版本选项可能调整。
exec 是否等于"全自动放心跑"	不是。它只是去掉了逐条对话交互，权限与审批边界仍需在运行前设定；高风险动作仍应人工把关。
脚本里如何保证失败可发现	让脚本检查退出状态与产出是否存在；失败时保留日志与改动快照，不静默吞错。
适合先从哪类 exec 任务起步	从只读分析、报告生成、建议产出开始，积累信任后再做受限写操作，不第一步就开放自动修改与提交。

六、动手练习

• 练习：把一个"只读代码检查/摘要"类任务改写成自包含指令，按受控流程准备干净目录、限定只读边界、运行后收集产出清单与 git diff，对比人工采纳过程与交互会话的差异。