用途:让宿主智能体(如 Grok、PowerShell 调度器)以非交互方式调用 OpenAI Codex CLI,把编程任务转交给 Codex 执行,避免开启 TUI。官方资料基于 codex-cli 0.147.0 与 Windows 官方安装器验证。
安装(Windows):先设 $env:CODEX_NON_INTERACTIVE = '1',再执行 powershell -ExecutionPolicy Bypass -c "irm https://chatgpt.com/codex/install.ps1 | iex"。安装会把 codex.exe 等写入 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin 并加入用户 PATH;之后刷新 PATH,用 where.exe codex 与 codex --version 校验。不存在 codex-cli 命令,应使用 codex。
认证:可用 codex login --device-auth(打开 https://auth.openai.com/codex/device 输入一次性码)配合 codex login status、codex doctor --summary;自动化可用 CODEX_API_KEY。--oss 指向本地 lmstudio / ollama,不是 ChatGPT。配置目录为 ~/.codex/。
用法:核心是 codex exec,示例:codex exec --json --skip-git-repo-check -C <dir> "任务"。常见参数含 --json(stdout 输出 JSONL)、-o 写入最终消息、-C 指定工作目录、-m 模型、-s 沙箱级别、--output-schema 约束输出、--search 联网、--ephemeral 不持久化会话。恢复会话用 codex exec resume --json --skip-git-repo-check <session-id> "跟进",或用 --last;thread_id 来自 --json 的 thread.started 事件。
结构化与审查:--output-schema 加 -o 可约束最终消息;codex review --uncommitted / --base / --commit 用于代码审查。MCP 场景可用 codex mcp-server,工具为 codex 与 codex-reply。
限制与注意:非 git 目录须加 --skip-git-repo-check;-a/--ask-for-approval 仅 TUI 可用,传给 exec 会报错;--full-auto 在 0.147 已移除;exec resume 不接受 -C,需先 cd;不要用 winget 的 OpenAI.Codex 或 jcv8000.Codex;不要禁用 code_mode_host,否则文件工具会失败;宿主为 PowerShell 时避免在双引号字符串中写 Linux 的 2>/dev/null。具体收费、价格与更多限制资料暂未提供。