用途:把非交互式的 codex exec 进程以后台方式并行拉起多个,把任意批量任务(代码修改、分析、摘要、评审、生成等)拆分处理,结果按任务写入文件回收。它不是图像专用技能,而是 codex-imagegen 的通用姊妹版:通用任务通过 -o(output-last-message)直接写入每个任务的结果文件,因此回收时没有竞态。
主要能力:核心机制是“一次 codex exec = 一个任务”,示例为 codex exec --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox -C /path/to/workdir -o /path/to/result.md "任务指令"。可用参数包括 -o、--json、--output-schema、-C、--add-dir、-s(read-only/workspace-write/danger-full-access)、--dangerously-bypass-approvals-and-sandbox、--skip-git-repo-check、--ephemeral、-m、-i,以及 resume。并发数 PARALLEL 默认 auto,按任务数自动估算 worker 并从 START(默认 3)开始,每成功 RAMP_EVERY(默认 5)个任务加一,出现 429 就停止增长;也可手动固定。
使用方式:输入为 JSONL,每行形如 {id, prompt, cwd?, schema?},结果写入 OUTDIR/<id>.md(带 schema 时写 .json)。提供 Python 参考运行器,也能用 xargs -P 的最小 bash 变体实现。用 --output-schema 可强制结构化 JSON 输出,便于聚合与后处理。
适用场景:只读任务(分析、评审、调查、摘要)可安全并行;修改任务必须隔离,可按任务分目录,或对同一 repo 用 git worktree。
限制与注意:额度按 ChatGPT 账号计,增加进程不会复制账号的速率限制,过度自动批量调用有会话失效风险,不要无限拉起进程。并行时建议用 --ephemeral 避免会话文件堆积;--dangerously-bypass-approvals-and-sandbox 会同时关闭沙箱,不可信提示词不要使用。失败任务在下一轮 resume 时重试,不要在一轮内无限重试。清理残留进程时避免误杀自身(例如用 pkill -9 -f "python3.*codex_spawn_runner" 与 pkill -9 -f "codex exec")。以上细节依据所提供资料。