用途:Codex 是 PATH 上的独立代理(命令为 codex),与当前工作树共享并已认证,可作为第二意见而非绝对真相,用于代码审查和(仅在用户明确要求时)实现委派。
主要能力:可运行 codex review 对实质性 diff 做审查;支持非交互式 codex exec,通过 --sandbox read-only 做只读审查,workspace-write 做实现;可用 -o 捕获最终消息,用 codex exec resume <session-id> 继续会话。它读取仓库自带的技能,提示中可直接引用技能名。
使用方式:审查时先确定 diff 范围(--uncommitted、--base <branch>、--commit <sha>),用只读沙箱并分离进度与结论文件,例如: review_dir=$(mktemp -d "${TMPDIR:-/tmp}/codex-review.XXXXXX") codex exec --sandbox read-only -C "$(git rev-parse --show-toplevel)" review --commit "$(git rev-parse HEAD)" --json -o "$review_dir/verdict.md" < /dev/null > "$review_dir/events.jsonl" 2> "$review_dir/stderr.log" 实现委派仅在用户点名 Codex 时进行,从干净工作树开始,按任务选择沙箱:纯代码用 codex exec --sandbox workspace-write "<task>";需浏览器或服务器时用 codex exec --dangerously-bypass-approvals-and-sandbox "<task>",且仅在专用 git worktree 中、提示由自己撰写,事后必须审查 diff。
限制与注意:stdin 必须是文件或 /dev/null,否则会阻塞;启动目录应为仓库根,否则写入会被拒;未受信任目录可能卡住,需在 ~/.codex/config.toml 添加 trust_level = "trusted";不要同时启动两个 exec;审查完成需退出码为零、turn.completed 且结论非空;所有发现需对照代码核实,推断不等于事实。若 codex 未安装,需先征得用户同意再按官方说明安装,首次认证由用户完成,并用 codex --version 验证。