结论先说
- 非交互模式入口是
codex exec(简写codex e),运行过程不打开全屏终端界面(TUI)。 - 输出天然分流:执行进度打往
stderr,最终回复只打往stdout,直接用>或管道|就能拿到干净结果。 - 默认是只读沙箱,且旧参数
--full-auto已废弃;需要让脚本改文件时,传--sandbox workspace-write。 - 管道有两种接法:传了提示词参数时,管道进来的
stdin当补充上下文;写成codex exec -时,stdin直接当整条提示词。 - 自动化解析有两件利器:
--json把stdout变成逐行 JSONL 事件流,--output-schema强制最终回复严格符合指定 JSON Schema。

图:本站根据 Codex 官方文档:Non-interactive mode 整理的示意图
本文根据 Codex 官方文档《Non-interactive mode》与《Command line options》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 想在 Shell 脚本、预提交检查、定时巡检或 CI 流水线里无人值守调用 Codex 的开发者;
- 需要把报错日志通过管道喂给 Codex,再把返回结果存盘或传给下游工具(如
jq、gh)的人; - 照旧教程写
--full-auto报错,想知道最新非交互权限与 JSON 输出参数的人。
一、基础命令与两种 stdin 管道模式
最简单的单次调用,直接把任务指令作为参数传入:
bash
codex exec "总结当前仓库目录结构,列出最需要注意的 5 个风险点" > summary.md
因为运行日志走 stderr、最终结论走 stdout,summary.md 里只会写入最后的总结正文。如果临时跑批处理不想在 ~/.codex/sessions 留下会话文件,加上 --ephemeral。
当上游命令(比如单测、日志截取、curl)通过管道喂数据时,按指令来源选写法:
- 模式 A:「指令 + 管道上下文」(命令带提示词参数,管道内容自动作为附加材料):
bash
npm test 2>&1 \
| codex exec "汇总失败的测试用例,并给出改动最小的修复方案" \
| tee test-triage.md
- 模式 B:「管道即完整提示词」(省略提示词或显式写
-,适合由上游脚本动态拼好整段提示词):
bash
cat prompt.txt | codex exec -
需要注意,Codex 默认强制检查当前目录是不是 Git 仓库,以防误伤非版本控制目录;如果确定在安全的临时目录里跑纯文本处理,需显式加上 --skip-git-repo-check。
二、沙箱与项目信任设置(别再用 --full-auto)
codex exec 默认运行在只读(read-only)沙箱中,不能改代码。按官方最新说明,旧版 --full-auto 参数已停止支持,脚本里请按最小权限改写:
bash
# 允许在当前工作区改文件
codex exec --sandbox workspace-write "修复失败的单测并重新运行验证"
# 在工作区可写基础上,把越界审批请求交给自动安全审核处理
codex exec --sandbox workspace-write --approve-for-me "更新快照并跑通检查"
只有在完全隔离的容器或一次性 CI 虚拟机里,才考虑 --sandbox danger-full-access。沙箱与自动审核的完整规则见 Codex 权限与沙箱设置 与 Codex 命令被自动审核拒绝怎么办。
另外两条容易在脚本里踩坑的加载规则:
- 未信任项目不加载
.codex/:即使开了可写沙箱,本地codex exec也只对受信任项目加载仓库内的.codex/config.toml和项目级 MCP 服务;首次在自动化目录运行可传--trust保存信任状态(不能与--ignore-user-config同用)。 - 纯净环境隔离:不想受本机
~/.codex/config.toml干扰时加--ignore-user-config;想跳过.rules规则文件时加--ignore-rules。若某个启用的 MCP 服务配置了required = true但初始化失败,codex exec会直接非零退出而不会静默跳过(MCP 配置见 Codex 怎么配置 MCP)。
三、机器可读输出:--json、-o 与 --output-schema

图:本站根据 Codex 官方文档:Non-interactive mode 整理的示意图
写流水线脚本时,纯自然语言不好给下一步解析,官方提供了三种输出控制参数:
1. 抓全量过程事件:--json
加上 --json 后,stdout 会变成每行一个 JSON 对象的 JSONL 流,包含 thread.started、turn.started、item.started、item.completed(涵盖命令执行、文件修改、MCP 调用、网页搜索等)以及带 token 统计的 turn.completed。若既想要 JSONL 流又想单独拿最终结论文本,搭配 -o(即 --output-last-message):
bash
codex exec --json -o last-message.txt "检查最近一次提交的潜在空指针问题" > events.jsonl
2. 强制返回固定 JSON 结构:--output-schema
先准备一份标准 JSON Schema 文件(注意顶层对象的 additionalProperties 设为 false),例如 schema.json:
json
{
"type": "object",
"properties": {
"risk_level": { "type": "string" },
"affected_files": { "type": "array", "items": { "type": "string" } }
},
"required": ["risk_level", "affected_files"],
"additionalProperties": false
}
执行时传入 --output-schema 并用 -o 落盘:
bash
codex exec "评估当前未提交改动的风险范围" \
--output-schema ./schema.json \
-o ./risk-report.json
四、多步接续、工作树与自动化凭据
- 两阶段流水线接续:第一步只审不改,第二步接着改,可用
codex exec resume --last "修复刚才找出的竞态条件"(或传指定<SESSION_ID>,会话恢复详见 Codex 历史会话在哪、怎么恢复)。 - 隔离工作树执行:加
--worktree(如codex exec --worktree "实现下一步"或codex exec fork <SESSION_ID> --worktree)可在受管 Git 工作树中独立改代码,不污染主检出。 - 凭据安全:
codex exec默认复用本机登录态;在无人值守环境推荐单条命令前注入CODEX_API_KEY=<密钥> codex exec ...,不要在跑未知仓库构建或测试代码的整个 CI Job 顶层暴露OPENAI_API_KEY,以防被第三方依赖钩子读取。计费区别见 Codex 怎么收费;本地个人交互与轻脚本若用订阅额度跑,可在本站查看 ChatGPT Plus 充值说明。
常见问题
问:codex exec 和 codex review 有什么区别?
答:codex review 是专门做非交互代码审查的子命令(支持 --uncommitted、--base、--commit),而 codex exec 是通用的非交互执行入口,查日志、改文件、抽结构化数据都能干。
问:为什么加了 --ephemeral 或 --output-schema 却报错缺提示词?
答:官方命令参考规定,使用 --image、--output-schema、--output-last-message 或 --ephemeral 时,必须提供提示词(可直接给字符串,或用 - 从 stdin 读入)。
问:能在公共开源仓库的 CI 里把本机 ~/.codex/auth.json 拷过去跑吗?
答:官方明确禁止在公共或开源仓库这样做。auth.json 内含账号访问令牌,等同密码;CI 自动化应使用可随时轮换的 API Key 或官方 GitHub Action。
相关教程
参考资料
- Codex 官方文档:Non-interactive mode — https://learn.chatgpt.com/docs/non-interactive-mode
- Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands
0 条评论
还没有评论,来抢沙发~