第五部分,自动化与 Codex SDK

用 codex exec 非交互运行

在脚本和 CI 中运行 codex exec,使用 JSON 输出、schema 和安全沙箱获得稳定结果。

非交互模式的输入与输出

codex exec 接收一次性任务并在完成后退出,适合脚本、CI 和批处理。进度写到标准错误,最终消息写到标准输出,调用方应分别处理。

默认只读沙箱更安全。任务确实需要修改工作区时显式选择 workspace-write,并在隔离分支或 runner 中运行。

bash
codex exec "审查当前分支并输出最重要的三个风险"
codex exec --json "列出失败测试及可能根因"
codex exec --ephemeral "解释这个仓库的构建入口"
codex exec --sandbox workspace-write "修复测试并运行验证"

让机器可靠消费结果

自由文本适合人读,自动化应使用 JSON Lines 或输出 schema。调用方仍需处理非零退出码、超时、部分结果和模型拒绝。

不要把模型输出直接拼成 shell 命令执行。结构化输出需要经过 schema 校验和业务规则检查。

  • 用 --json 接收事件流。
  • 用 --output-schema 约束最终结构。
  • 用 -o 保存最终消息到文件。
  • 设置进程超时与日志上限。
  • 对外部写入增加独立批准步骤。

官方资料

本页由 xueai 根据 OpenAI 官方资料重新组织并用中文讲解。产品会持续更新,涉及版本、模型和命令时请同时核对下列官方页面。