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 條評論

登入 後參與評論

還沒有評論,來搶沙發~