用途:通过 codex exec 非交互执行 Codex,实现无需人工确认的代码分析、审查、批量任务与自动化管道集成。触发语如“use Codex to…”“run codex exec”。
主要能力:安全模式选择——默认只读用于分析审查:codex exec "分析认证流程并找出潜在安全问题";需要改文件时用 codex exec --full-auto;仅在需要网络时用 codex exec --sandbox danger-full-access。输出处理——默认标准输出为最终结果、stderr 为活动日志,可重定向;用 -o 存文件;--json 输出 JSONL 事件流(thread.started、turn.started、turn.completed、item.* 、error 等,item 类型含 agent_message、command_execution、file_change、reasoning、mcp_tool_call、web_search、plan_update);--output-schema 强制结构化 JSON。会话——默认持久化,可用 codex exec resume --last 或 resume <session_id> 续跑,--ephemeral 跳过持久化;续跑需重新指定行为标志。
用法要点:Codex 需 Git 仓库,必要时 --skip-git-repo-check;认证可用 CODEX_API_KEY=... codex exec;可用 jq 过滤事件、统计 token。
限制:显式模型选择仅在交互模式支持;跨机器续跑需共享或转移会话文件;权限应按需从只读逐步升级并告知用户。更多参数见 references/codex-exec-reference.md。