用途：把生成、重构或审查代码等任务委派给本地 OpenAI Codex CLI 代理，使用 ChatGPT Pro 订阅的 OAuth 认证，不产生 API 按量费用。适用于用户提到 codex、run codex、delegate to codex，或需要运行 codex exec 执行非交互任务的场景。
认证：使用 ~/.codex/auth.json 中的 OAuth 凭据，不要设置 OPENAI_API_KEY 或传入 API Key，否则会切换到按量计费。ChatGPT.app 桌面端与 CLI 共享同一认证缓存；认证失败可在终端运行 codex login 走浏览器 OAuth 流程。
CLI 路径检测顺序：先看 CODEX_BIN 环境变量（不可执行则报错退出，不静默回退）；再用 which codex（PATH 中优先项，nvm 下的 npm 全局安装在此解析）；最后回退到 /Applications/ChatGPT.app/Contents/Resources/codex。判断实际运行的构建应使用状态输出中的 codex_path 字段执行 --version，而非直接 codex --version。
用法：基本执行 python3 scripts/codex_wrapper.py exec "<prompt>" [<workdir>] [<model>] [<sandbox>] [<timeout>]；代码审查 python3 scripts/codex_wrapper.py review [<workdir>] [<model>] [uncommitted:true] [<timeout>]；查看状态 python3 scripts/codex_wrapper.py status。输出为 JSON，含 success、exit_code、elapsed_seconds、stdout、stderr、parsed_jsonl、final_message。默认 model 为 gpt-5.5，sandbox 为 workspace-write，timeout 为 300 秒。
安全与限制：分析或审查用 read-only，生成代码用 workspace-write，danger-full-access 仅在明确需要时使用；在非 git 仓库中运行需加 --skip-git-repo-check，一次性任务可用 --ephemeral。多步任务可用 codex exec resume --last，但包装器目前仅支持单次执行。OAuth 令牌刷新需要桌面应用运行或令牌未过期；环境变量不会继承进 Codex 沙箱，需通过配置或提示传入；大文件操作可能需要增大超时。codex doctor 可用于排查问题，建议不加 --summary 运行。