用途:当用户要求运行 Codex CLI(codex exec、codex resume)或引用 OpenAI Codex 做代码分析、重构、自动化编辑时,按本指南安全地组装并执行命令。
主要能力:支持只读审查、工作区写入、机器可读输出、独立批处理、会话恢复、额外写目录授权等。先运行 codex --version 与 codex exec --help,确认可用性与实际支持的参数;未指定模型或推理强度时使用已安装默认值,不硬编码模型列表。
使用方式:按需选择最小沙箱,read-only 用于检查,workspace-write 用于本地编辑;网络访问、额外可写根目录与更宽模式需单独授权。常用参数包括 -m/--model、--config model_reasoning_effort、--sandbox、-C/--cd、--add-dir、--json、--ephemeral、--skip-git-repo-check、--dangerously-bypass-approvals-and-sandbox。自动化或需计量用量时加 --json 保存 JSONL,读取最终 usage 事件报告 token。续接对话任务用 codex exec resume --last。传递提示词应使用带引号的 heredoc,避免 shell 重解释。保留 stderr 并写入有界产物,不要重定向到 /dev/null。
适用场景:只读审查、本地重构、跨目录运行、独立批次处理、对话式续接等。
限制:--skip-git-repo-check 不应默认使用,仅在用户明确要求或批准时使用;danger-full-access 与 --dangerously-* 属高影响模式,需先行授权;不要使用 --full-auto 等已弃用参数。对非零退出或超时停止并报告,不自动重试昂贵运行。批量成本需先做小规模校准并确认预算;缓存输入仍计为用量。缺失信息暂未提供。