结论先说
- 旧参数
--full-auto在较新版 Codex CLI 已废弃,CI 脚本应尽快迁移为显式沙箱参数。从 v0.147 起官方不再推荐宽泛的一键自动开关,改由--sandbox read-only(只读分析)或--sandbox workspace-write(工作区可写)精确声明能力边界。 --ephemeral是 CI 与定时任务的必加无痕参数。开启后codex exec不会把本次运行的会话轨迹写入本地~/.codex/sessions目录,既防止自托管构建机磁盘膨胀,也避免在开发机上污染日常交互历史列表。- CI 流水线要按「只读审计」与「受控改码」两类场景分权。生成 PR 体检报告、变更摘要或 JSON 校验结果只给
--sandbox read-only;只有确实需要生成补丁分支的作业才给--sandbox workspace-write,且把提交与推送交给后续确定性脚本完成。 - 严禁在跑外部 PR 的 CI 里打开完全绕过沙箱的危险参数。诸如
--dangerously-bypass-approvals-and-sandbox仅适用于可随时销毁且不含生产凭据的强隔离沙盒,切勿图省事直接照搬进常规流水线。 - 在本地调试好流水线模板再上线自动化任务,往往需要反复试跑验证。国内没有外币卡的用户可在本站开通 ChatGPT Plus 或高配额的 ChatGPT Pro,团队多人研发可了解 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方文档:Non-interactive mode 整理的示意图
本文根据 OpenAI Codex 官方文档《Non-interactive mode》《Command line options》《Approvals & security》整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 正在把
codex exec接入 GitHub Actions、GitLab CI 或内部构建脚本,发现照抄旧文档写--full-auto报错或收到废弃警告的开发者; - 在自托管构建机(Self-hosted Runner)或本机定时任务里高频跑非交互任务,不想把
~/.codex/sessions历史写满写乱的运维与研发人员; - 担心 CI 里给 AI 代理开太大权限会导致误删文件或泄露环境变量的安全负责人。
一、从 --full-auto 迁移到显式沙箱,以及 --ephemeral 的真实作用
很多早期脚本里会看到 codex exec --full-auto 的写法,但在新版 CLI 中继续沿用可能直接触发废弃提示或参数错误。理清每个参数的准确职责,就能写出既兼容新版又审计清晰的命令(管道喂入写法也可搭配参阅 /guides/codex-cli-pipe-stdin-exec-recipes):
| 参数写法 | 当前状态 | 权限与磁盘行为 | 适用场景 |
|---|---|---|---|
--full-auto | 新版已废弃 | 早期打包快捷项,权限边界不够显式 | 仅用于排查旧脚本,新脚本应替换为下方显式参数 |
--sandbox read-only | 现行推荐 | 仅允许读仓库与输出结论,禁止改任何文件 | PR 风险扫描、报错归因、发版说明生成 |
--sandbox workspace-write | 现行推荐 | 仅允许改动当前工作区,.git 与外网默认受控 | 自动修复格式化、补单测、生成补丁草稿 |
--ephemeral | 现行推荐 | 跳过会话记录落盘,不污染 ~/.codex/sessions | 所有 CI 作业、定时巡检、自托管构建机必加 |
1. 纯只读分析与报告作业(最高安全级)
当流水线只需要检查代码变更、输出 Markdown 审核意见或结构化 JSON(JSON 模式用法见 /guides/codex-output-schema-structured-json-guide)时,绝不要多给写权限:
bash
git diff origin/main...HEAD | codex exec \
--ephemeral \
--sandbox read-only \
"检查本次 PR 差异中是否存在空指针、越界访问或硬编码密钥风险,按严重级别输出 Markdown 列表。" > review-report.md
2. 受控改码作业(与 Git 推送解耦)
如果需要自动修补依赖迁移或补齐单元测试,只让 codex exec 在工作区里改文件,后续验证、建分支与推 PR 交给确定性的常规 CI 步骤,防止代理在异常情况下误操作远端分支:
bash
codex exec \
--ephemeral \
--sandbox workspace-write \
"运行 pytest 定位失败用例并做最小修复,不要修改业务断言,完成后列出改动文件。"
# 由常规确定性脚本复核测试与差异,再决定是否生成补丁
pytest -q && git diff --stat
如果某些极简 CI 镜像在检出源码时剥离了完整 Git 目录元数据,可按需评估附加跳过校验参数,具体风险与条件见 /guides/codex-not-inside-trusted-directory-skip-git-repo-check。
二、CI 流水线集成示例与无痕运行细节
在 GitHub Actions 等托管平台里,单步注入受控环境变量即可将 codex exec 接入工作流:
yaml
- name: Run ephemeral Codex read-only audit
env:
CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}
run: |
git diff origin/main...HEAD | codex exec \
--ephemeral \
--sandbox read-only \
"总结高风险逻辑改动并给出人工复核清单。" > codex-audit.md
这里有三个容易忽略但非常关键的工程细节:
- 环境变量只注入当前步骤:把
CODEX_API_KEY放在单个step的env下,不要暴露给整条 Job 里的第三方构建插件;报错找不到变量时可对照 /guides/codex-missing-environment-variable 排查。 - 进度与结果天然分流:
codex exec把运行日志打到stderr,只把最终结果输出到stdout。因此> codex-audit.md得到的就是干净报告,同时 CI 控制台日志里依然保留完整过程供排错。 - 自托管构建机为什么必须加
--ephemeral:托管云 Runner 用完即毁,但公司内网的自托管构建机往往长期复用同一个磁盘目录。不加--ephemeral时,每天几百次构建都会往~/.codex/sessions写入完整上下文日志,久而久之不仅撑爆磁盘,还可能把 A 项目的代码片段残留在宿主机磁盘上。
订阅与账号准备提示:CI 正式无人值守运行通常使用按量计费的 API Key 并配置月度预算上限,而开发者在本机反复调试提示词模板、试跑非交互脚本则最常用 ChatGPT 订阅账号。若本地调试高频使用导致 Plus 档配额紧张,可在本站升级 ChatGPT Pro 充值 或选用 ChatGPT Pro 5x iOS 可覆盖档;新注册账号若在手机验证环节受阻,也可查看 Codex 注册手机验证服务。
三、CI 流水线安全边界六项上线核对清单

图:本站根据 OpenAI Codex 官方文档:Approvals & security 整理的示意图
本站建议任何团队在把 codex exec 合并进主干 CI 配置前,逐条打勾确认以下六项:
- 已把旧脚本里的
--full-auto全部替换为明确的--sandbox read-only或--sandbox workspace-write; - 所有自动化脚本与定时任务均已显式带上
--ephemeral,确保不向本地或共享构建机落盘会话历史; - 面向外部 Fork PR 的工作流绝不向运行步骤暴露写仓库令牌或生产密钥,防止恶意代码借提示注入套取机密;
- API 密钥仅在调用 Codex 的单个步骤注入,并在 OpenAI 后台设定了硬性月度消费上限与告警阈值;
- 写权限作业与
git push解耦,任何自动改码都先经过单测与静态扫描门禁,且只向独立分支提 PR 不直推主干; - 给作业设置明确的 CI 步骤超时时间(如 10 分钟),防止网络抖动或模型死循环长期占满构建队列。
常见问题
问:本地开发机跑定时汇总脚本,加了 --ephemeral 后如果任务失败了,怎么看报错原因?
答:--ephemeral 只是不把会话轨迹持久化到 ~/.codex/sessions,并不会静默吞掉标准错误输出。你可以把命令的 stderr 定向到带日志轮转的普通日志文件(如 2>> /tmp/codex-cron.log),既能排错又不会写乱 Codex 交互历史。
问:为什么我把 codex exec --full-auto 改成 codex exec --sandbox workspace-write 后,CI 里依然不需要人工敲确认?
答:因为 codex exec 本身就是非交互执行子命令,在显式声明 --sandbox workspace-write 后会在沙箱边界内自动完成工作区内的允许操作,无需再依赖已经废弃的 --full-auto 快捷开关。
问:国内没有外币信用卡,或者公司团队需要开增值税发票报销,怎么开通能日常本地开发调试 Codex 的订阅?
答:可通过本站 AI 会员充值总览 办理 ChatGPT Plus 卡密自助兑换 或高配额 ChatGPT Pro,多人研发团队可直接选择 ChatGPT Business 团队定制。平台支持支付宝、微信支付及 AlipayHK 付款,无需提供账号密码,可开具增值税发票;实时价格以商品页展示为准,售后遵循掉订阅按剩余天数折退、封号不在质保范围的规则。
相关教程
- Codex CLI 管道与标准输入实战:6 个实用命令配方
- Codex --output-schema 结构化 JSON 输出配置指南
- Codex 报 not inside a trusted directory 与 --skip-git-repo-check 处理
- Codex 报 missing environment variable 怎么办
参考资料
- OpenAI Codex 官方文档:Non-interactive mode — https://learn.chatgpt.com/docs/non-interactive-mode
- OpenAI Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands
- OpenAI Codex 官方文档:Approvals & security — https://learn.chatgpt.com/docs/agent-approvals-security
0 条评论
还没有评论,来抢沙发~