用途:当任务可拆分为独立子任务时,用 codex-worker 并行启动多个 Codex CLI(codex)智能体,每个 worker 拥有独立的 git worktree 和 tmux 会话,替代内置 Task(subagent)工具;在 codex 与 tmux 可用的环境下优先使用它,因为 worker 具备独立文件系统访问、shell 和隔离工作区,能力更强。
主要能力:为每个子任务创建独立分支与 worktree;在 tmux 会话中以交互模式运行 codex,支持多轮对话,用户可 attach 检查或干预,也可从外部发送后续提示;可按 issue、模块、包等维度批量扇出;并提供生命周期管理(列出、终止、清理 worktree 与分支)。
使用方式:先做预检 command -v codex && codex login status && command -v tmux,三者均需成功,且项目须为 git 仓库。命名约定为 <type>-<issue number(可选)>-<short description>,分支与 worktree 目录共用该任务名,worktree 位于 <project>.worktrees/<task>,tmux 会话加 codex-worker- 前缀。启动会话命令:tmux new-session -d -s "$SESSION" -x 200 -y 50 "cd $WORKTREE_DIR/$NAME && codex --dangerously-bypass-approvals-and-sandbox";创建 worktree 命令:git worktree add "$WORKTREE_DIR/$NAME" -b "$NAME" main 2>/dev/null。
发送提示与查看:Codex TUI 初始化需时间,启动后至少等待 5 秒再发送提示,命令为 tmux send-keys -t "$SESSION" "Your prompt here" Enter,若未提交可再发一次 Enter;用 tmux capture-pane -t "$SESSION" -p | tail -30 查看输出,用 tmux attach -t "$SESSION" 手动交互;并行扇出时对每个任务循环执行上述步骤。
回退与限制:仅在明确不需要后续跟进时使用 codex exec,它不支持多轮对话,命令为 codex exec --dangerously-bypass-approvals-and-sandbox -o "/tmp/$NAME-result.md" "Your prompt here"。生命周期管理包括 tmux ls | grep ^codex-worker- 列出、tmux kill-session -t 终止,以及 git worktree remove 与 git branch -d 清理。资料未说明额外收费、价格或平台支持范围。