結論先說
--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 條評論
還沒有評論,來搶沙發~