AI Agent / 系统课时

使用非交互模式

使用非交互模式

非交互模式让 Codex 在没有 TUI 的情况下完成一次任务,并把结果交给脚本继续处理。本节会把提示词输入、标准输出、标准错误和退出状态放到同一条自动化链路中,最终得到可被 CI 或 Shell 稳定判断的执行结果。

学习目标

  • 使用 codex exec 从参数或标准输入接收任务
  • 正确分离 stdout、stderr,并读取进程退出状态
  • 为自动化任务选择合适的沙箱权限和会话策略

认识一次非交互执行

codex exec 会启动一次非交互会话。默认模式下,最终的代理消息写到 stdout,运行进度和诊断信息写到 stderr,因此脚本可以把最终文本重定向到文件,而不必从交互界面中截取内容。

自动化任务通常应从最小权限开始。只分析代码时使用只读沙箱;确实要修改工作区时再切换到 workspace-write。如果不希望保留本次会话的持久化记录,可以增加 --ephemeral。在 Git 仓库之外运行时,只有明确接受这一边界后才使用 --skip-git-repo-check。

从标准输入读取任务

把 - 作为提示词位置时,Codex 会强制把标准输入当作完整提示词。下面的脚本同时捕获标准输出、标准错误和退出状态;示例应在已完成 Codex 登录并可正常访问模型的环境中执行。

bash
set -o pipefail

tmp_dir="$(mktemp -d)"
printf '%s\n' 'Output exactly: READY' | codex exec --sandbox read-only - >"$tmp_dir/stdout.txt" 2>"$tmp_dir/stderr.txt"
status=$?

printf 'exit=%s\n' "$status"
printf 'stdout=%s\n' "$(cat "$tmp_dir/stdout.txt")"

预期输出

text
exit=0
stdout=READY

stderr.txt 中可能包含运行进度或诊断信息,具体内容会随版本和执行过程变化,因此不要把它与最终业务结果混在一起。若同时提供位置参数提示词和管道输入,位置参数会作为任务指令,管道内容则作为附加上下文。

用退出状态控制流水线

Shell 自动化不能只看输出文本,还要检查 Codex 进程是否成功结束。退出状态为 0 时可以进入后续步骤;认证、配置、初始化或运行失败时,应把非零状态向上传递,让 CI 直接失败,而不是继续处理一个不存在或不完整的结果。

如果把 codex exec 接到 tee、jq 等命令后面,普通 Shell 默认只返回管道最后一个命令的状态。Bash 中应启用 set -o pipefail,否则 Codex 已失败而后续命令恰好成功时,整个步骤仍可能被误判为成功。

选择适合自动化的边界

只需要一次最终文本时,保持默认输出最简单;需要写文件时可以直接重定向 stdout,也可以使用 -o 或 --output-last-message 保存最后一条代理消息。脚本应预先创建目标目录,并把 stderr 单独留作诊断证据。

不要为了省事在共享 CI Runner 上直接使用 danger-full-access。更稳妥的做法是让分析任务保持只读,让修改任务只获得工作区写权限,并把凭据通过 CI 的安全变量或密钥存储注入。这样即使任务失败,退出状态、结果文件和诊断日志也能被流水线分别处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用非交互模式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通