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