用途:当一项编码、审查或验证任务边界清晰、可独立完成时,可在单独的 Codex CLI 会话中运行它。适合并行处理多个独立任务,或作为对你自身改动的独立二次验证。不要委派需要你无法完整写入提示词的对话上下文的任务。
预检与用法:先运行 codex --version 检查是否安装,缺失则用 npm i -g @openai/codex(或 brew install --cask codex);再运行 codex login status,显示“Logged in using ChatGPT”即就绪,未登录需用户自行执行 codex login。绝不读取、打印或复制凭据。
启动方式:使用 codex exec,配合 --cd 指定仓库路径、--sandbox workspace-write 与 --output-last-message 输出最终消息。当标准输入不是真实终端时必须加 </dev/null,否则 Codex 会一直等待 EOF。Codex 看不到你的对话,需在提示词中写明目标、路径、约束与完成标准;提示词过长可用 codex exec [flags] - < /tmp/task.md 传入。可用 -m 覆盖模型,--json 输出 JSONL 事件流。运行耗时数分钟且无内置超时,建议放到后台并监控。
结果与续跑:读取输出文件获得最终消息,用 git status --short 查看实际改动。同一会话续跑用 codex exec resume --last “后续指令” </dev/null,需在同一工作目录运行。并列任务应真正独立并预先分配文件归属,每个 Codex 运行使用独立 git worktree,切勿在同一树中并行两个。
常见故障:无输出卡死通常是标准输入未关闭;登录状态非零需用户自行登录;命中速率限制应报告用户而非循环重试;非 git 仓库可加 --skip-git-repo-check。workspace-write 沙箱默认禁止网络,如任务需要可加 -c sandbox_workspace_write.network_access=true。切勿使用 --dangerously-bypass-approvals-and-sandbox。
限制:每次启动只做一项任务,大任务需拆分;宣布完成前应自行审查 Codex 的 diff。资料未提供具体收费与价格信息。涉及远程访问、调度、浏览器自动化或改文件的工作流,应先取得用户明确批准并确认目标环境。