Codex codex exec --full-auto 与 --ephemeral 无痕自动化运行参数:CI 流水线防写乱历史与权限边界

把 codex exec 放进 CI 流水线或定时脚本时,老教程里的 --full-auto 在新版已废弃,而忘记加 --ephemeral 又会把宿主机历史写爆。本文讲清 --full-auto 迁移方案、--ephemeral 无痕运行机制与 CI 最小权限边界。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Plus 账号

结论先说

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

--full-auto 迁移、显式沙箱与 --ephemeral 对比

图:本站根据 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

这里有三个容易忽略但非常关键的工程细节:

  1. 环境变量只注入当前步骤:把 CODEX_API_KEY 放在单个 step 的 env 下,不要暴露给整条 Job 里的第三方构建插件;报错找不到变量时可对照 /guides/codex-missing-environment-variable 排查。
  2. 进度与结果天然分流:codex exec 把运行日志打到 stderr,只把最终结果输出到 stdout。因此 > codex-audit.md 得到的就是干净报告,同时 CI 控制台日志里依然保留完整过程供排错。
  3. 自托管构建机为什么必须加 --ephemeral:托管云 Runner 用完即毁,但公司内网的自托管构建机往往长期复用同一个磁盘目录。不加 --ephemeral 时,每天几百次构建都会往 ~/.codex/sessions 写入完整上下文日志,久而久之不仅撑爆磁盘,还可能把 A 项目的代码片段残留在宿主机磁盘上。
订阅与账号准备提示:CI 正式无人值守运行通常使用按量计费的 API Key 并配置月度预算上限,而开发者在本机反复调试提示词模板、试跑非交互脚本则最常用 ChatGPT 订阅账号。若本地调试高频使用导致 Plus 档配额紧张,可在本站升级 ChatGPT Pro 充值 或选用 ChatGPT Pro 5x iOS 可覆盖档;新注册账号若在手机验证环节受阻,也可查看 Codex 注册手机验证服务。

三、CI 流水线安全边界六项上线核对清单

CI 流水线运行 codex exec 安全边界核对

图:本站根据 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 付款,无需提供账号密码,可开具增值税发票;实时价格以商品页展示为准,售后遵循掉订阅按剩余天数折退、封号不在质保范围的规则。

相关教程

参考资料

  • 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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 整理家庭装修预算明细、隐蔽工程验收清单与主材优缺点对比表实战

    第一次装修面对几十页施工报价单、密密麻麻的水电防水隐蔽项目与五花八门的主材参数,极易踩坑增项。本文梳理用 ChatGPT 审查装修报价漏项、生成带公式的预算明细表、定制工地隐蔽工程验收单与主材对比表的实战提示词。

    ChatGPT0
  2. 02

    用 ChatGPT 做费曼学习法读书共读:反向追问检验自己是否真读懂专业书籍与整理书单笔记

    读完一本专业硬书常感觉「合上书就忘」,直接让 AI 概括全书又容易产生懂了的错觉。本文介绍用 ChatGPT 结合 Study Mode 与费曼学习法做反向追问共读,通过通俗复述、挑刺盲区到沉淀书单卡片的完整流程与提示词。

    ChatGPT0
  3. 03

    用 ChatGPT 做外贸产品多语种目录、展会邀约与客户跟进节奏表(附脱敏与本地化提示词)

    做外贸展会与海外推广时,手工翻译十几款产品目录费时且容易留下一堆中式英文,展后客户跟进也常缺节奏。本文梳理用 ChatGPT 先脱敏建术语库、再批量产出多语种目录、展前邀约函与展后 21 天跟进节奏表的实战流程与提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写高质量技术专栏文章、开源项目 Release Notes 与版本更新日志实战

    让 AI 直接凭空写技术文章容易满篇空洞套话,直接甩 Git 记录写更新日志又常常漏掉破坏性变更。本文整理用 ChatGPT 结合真实代码片段、压测数据与 PR 摘要,高效产出深度技术专栏、GitHub Release Notes 与 CHANGELOG 的实战工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做产品用户访谈纪要编码、提炼高频痛点需求池与 RICE 优先级打分实战

    手头攒了十几份用户访谈逐字稿,手工贴便利贴归纳痛点耗时又容易带入主观偏见。本文分享用 ChatGPT 完成脱敏检查、逐份开放式编码、跨样本聚类高频痛点并搭建 RICE 优先级打分表的 5 步实战流,附可直接复制的三段核心提示词。

    ChatGPT0
  6. 06

    ChatGPT 网页版上传超过 10 个文件或回形针附件按钮变灰怎么办:打包合并与配额限制排查

    在 ChatGPT 网页版批量分析文档时,常遇到一次选超 10 个文件被拦截或输入框回形针按钮变灰。本文依据 OpenAI 文件上传与存储说明,梳理 6 类常见报错的分流排查法,提供 ZIP 打包、本地合并与 Projects 复用方案及可直接复制的解包提示词。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~