结论先说
--json把stdout变成逐行 JSONL 事件流。开启codex exec --json后,每一步会话初始化、命令执行、文件修改、推理片段和最终回复都会以单行 JSON 对象实时输出到stdout,而连接诊断和错误日志仍分离输出到stderr。-o/--output-last-message专攻最终成品落盘。无需自己在几百行 JSONL 里反向翻找最后一条回复,加上-o ./report.md即可直接把模型最终一条回答完整写进目标文件。- 「
--json+-o」双路并用是自动化最佳实践。一条命令同时拿到两份产物:events.jsonl负责全链路审计、故障回溯与 Token 记账,report.md(或搭配--output-schema产出的result.json)直接喂给下游步骤或 PR 评论接口。 - 抓下
thread.started里的thread_id即可断点续跑。流水线如果分阶段推进(例如先扫描、人工确认后再修补),从第一行 JSONL 解析出thread_id,后续就能通过codex exec resume <thread_id>接着上下文继续干活。 - 批量自动化巡检与多轮工具调用对周期配额消耗更集中。国内如无外币支付渠道,可在本站自助开通 ChatGPT Plus 或配额更高的 ChatGPT Pro,团队多人标准化接入流水线也可了解 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方文档:Non-interactive mode 整理的示意图
本文根据 OpenAI Codex 官方文档《Non-interactive mode》《Codex CLI reference》整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 正在把
codex exec接入 GitHub Actions、GitLab CI、Jenkins 或本地定时巡检脚本,希望结构化采集每一步执行轨迹的研发工程师; - 既想把最终评审报告、发布说明或检测 JSON 干净保存成文件,又不想丢掉完整命令调用与 Token 消耗记录的团队;
- 之前直接截取
codex exec纯文本 stdout,结果被中间日志或换行符破坏解析逻辑的脚本作者。
一、--json 输出的 JSONL 事件流长什么样
默认运行 codex exec 时,终端面向人类阅读输出排版文本;加上 --json 后,stdout 会严格按 JSON Lines(每行一个合法 JSON) 吐出事件,典型生命周期如下:
json
{"type":"thread.started","thread_id":"0199a213-81c0-7800-8aa1-bbab2a035a53"}
{"type":"turn.started"}
{"type":"item.completed","item":{"id":"item_1","type":"reasoning","text":"Checking API handlers..."}}
{"type":"item.completed","item":{"id":"item_2","type":"command_execution","command":"npm test","exit_code":0}}
{"type":"item.completed","item":{"id":"item_3","type":"agent_message","text":"全部检查完成,未发现阻塞性回归。"}}
{"type":"turn.completed","usage":{"input_tokens":24763,"cached_input_tokens":24448,"output_tokens":122}}
注意不同 CLI 小版本中 item.type 的具体子类名称和附加字段可能会有细微扩充,编写下游解析脚本时应针对你关心的 type 做条件匹配并忽略未知字段,保证升级后不脆弱。完整 CLI 命令总览可查阅 /guides/codex-cli-commands-cheatsheet。
二、实战模板:--json + -o 双路输出与流式解析
下面给出日常 CI 与本地自动化里最稳妥的四步流水线搭法(无状态 CI 基础配置可同步参考 /guides/codex-exec-full-auto-ephemeral-ci-pipeline-guide)。

图:本站根据 OpenAI Codex 官方文档:Codex CLI reference 整理的示意图
模板 1:Shell 一条命令同时归档事件流与最终报告
bash
mkdir -p ./codex-artifacts
codex exec \
--sandbox read-only \
--ephemeral \
--json \
-o ./codex-artifacts/pr-review.md \
"审查最近一次提交的鉴权改动,按严重级别输出 Markdown 检查结论" \
> ./codex-artifacts/events.jsonl \
2> ./codex-artifacts/stderr.log
执行结束后:
./codex-artifacts/pr-review.md里是干净的最终 Markdown 结论,可直接调用 GitHub CLI 发到 PR 评论区;./codex-artifacts/events.jsonl保留完整步骤记录,方便审计 Codex 实际读了哪些文件、跑了哪些命令;./codex-artifacts/stderr.log单独承接网络告警或异常诊断,绝不污染 JSONL 格式。
模板 2:用 jq 实时提取进度、会话 ID 与 Token 消耗
bash
# 从落盘事件流中提取会话 ID
jq -r 'select(.type=="thread.started") | .thread_id' ./codex-artifacts/events.jsonl
# 汇总本轮输入、缓存命中与输出 Token
jq -r 'select(.type=="turn.completed") | .usage' ./codex-artifacts/events.jsonl
# 仅筛选最终代理回复文本
jq -r 'select(.type=="item.completed" and .item.type=="agent_message") | .item.text' ./codex-artifacts/events.jsonl
模板 3:Python 实时流式监听并触发告警(本站建议)
如果需要在执行过程中实时把工具调用打印到 CI 面板或监控超时,可用 Python 逐行读取管道(更多管道喂入技巧见 /guides/codex-cli-pipe-stdin-exec-recipes):
python
import json, subprocess
proc = subprocess.Popen(
[
"codex", "exec", "--json",
"--output-last-message", "final.txt",
"检查仓库是否存在未关闭的数据库连接并汇总"
],
stdout=subprocess.PIPE,
text=True,
encoding="utf-8",
)
for line in proc.stdout:
ev = json.loads(line)
if ev.get("type") == "turn.completed":
print("Token 统计:", ev.get("usage"))
proc.wait()
如果下游程序需要机器严格可读的字段(如 severity、files、pass),还可以再叠加 --output-schema schema.json 并把 -o 指向 result.json(完整写法参考 /guides/codex-output-schema-structured-json-guide)。
订阅与账号准备提示:把codex exec接入每次提交或定时巡检后,并发与累计调用量会快速上升,建议关注窗口配额监控(限额说明见 /guides/codex-usage-limits)。如果高频触顶,可在本站升级 ChatGPT Pro 充值 或 ChatGPT Pro 20x 高额度档;新账号注册遇到手机验证问题,也可查看 Codex 注册手机验证服务。
三、脚本解析避坑要点(本站建议)
- 严禁把
2>&1混进--json管道。一旦把stderr合并到stdout,网络重试提示或警告行会夹杂在 JSONL 里,直接导致jq或json.loads()抛解析异常。务必把stdout和stderr分开重定向。 - 先判断进程退出码,再读取
-o文件。当任务中途因网络中断、审批拒绝或非受信任目录失败时,-o指定的文件可能尚未生成或为空。脚本里必须先校验$?(PowerShell 校验$LASTEXITCODE)为0,且目标文件非空,再往下游推送。 - 非 Git 仓库目录要提前考虑
--skip-git-repo-check。在干净构建目录或解压包里运行codex exec时,如果目标路径下没有.git,会立刻中止退出,需按需显式加上该参数。
常见问题
问:用了 -o report.md 之后,stdout 还会打印内容吗?
答:会。-o / --output-last-message 只是把最终回复额外保存一份到指定文件,不影响 stdout 的正常输出;因此它天生适合与 --json > events.jsonl 组合实现双路输出。
问:能不能只把最终结果输出成严格 JSON,而不是普通 Markdown?
答:可以。把 --output-schema ./schema.json 和 -o ./result.json 搭配使用,Codex 会按你给定的 JSON Schema 约束最终消息格式,并直接落盘到 result.json,下游脚本无需任何正则清洗。
问:国内没有外币信用卡,或者公司研发团队需要开增值税发票报销,怎么开通能跑 Codex 的订阅?
答:可在本站 AI 会员充值总览 按需选购 ChatGPT Plus、ChatGPT Plus 官网直充 或高配额的 ChatGPT Pro,企业团队多人采购可直接查看 ChatGPT Business 团队定制。支持支付宝、微信支付与 AlipayHK,自助兑换无需交出账号密码,并可开具增值税发票;实时价格以商品页展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围的政策。
相关教程
- Codex output-schema 强制结构化 JSON 输出教程
- Codex CLI 管道 stdin 与 exec 批处理脚本配方
- Codex exec 全自动与 --ephemeral 无状态 CI 流水线指南
- Codex CLI 常用命令与参数速查表
参考资料
- OpenAI Developers 文档:Non-interactive mode — https://developers.openai.com/codex/noninteractive
- OpenAI Developers 文档:Codex CLI reference — https://developers.openai.com/codex/cli/reference
- OpenAI Codex 官方文档:CLI reference — https://learn.chatgpt.com/docs/cli/reference
- OpenAI Codex GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~