結論先說
- 用
compact_prompt接管預設摘要規則。在~/.codex/config.toml或受信任倉庫的.codex/config.toml中配置compact_prompt,即可覆蓋內置的上下文壓縮指令,無論是手動輸入/compact還是達到閾值自動壓縮都會按你的要求整理記憶。 - 模板較長時改用
experimental_compact_prompt_file獨立維護。如果團隊壓縮規範超過十行,把提示詞單獨放進 Markdown 或文本文件再通過文件路徑引用,比在 TOML 裏寫一大段轉義字符串更易做 Git 版本審查。 - 好的壓縮提示詞核心是「保硬狀態、砍過程噪音」。明確要求保留架構禁區、已改文件與符號名、精確配置鍵名、當前測試通過/失敗狀態和下一步清單,同時顯式指示丟棄已被替代的舊方案與冗長終端報錯全文。
- 別把全局常駐規範只寄託在壓縮摘要裏。長期不變的倉庫紅線應該寫進
AGENTS.md(每輪自帶),compact_prompt負責搶救的是「本輪對話裏臨時拍板的上下文狀態」。 - 超長上下文反覆壓縮與多輪精修建議配足會員額度。國內如無外幣支付方式,可在本站自助開通 ChatGPT Plus 或高額度 ChatGPT Pro,團隊多人標準化部署也可了解 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方文檔:Configuration Reference 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Configuration Reference》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 在單個長任務裏連續迭代幾十輪代碼,執行
/compact後發現 Codex 忘記了前面確認過的接口契約、目錄禁區或關鍵環境變量名的開發者; - 需要處理大型重構或跨模組聯調,希望自動壓縮上下文時只留高價值工程狀態、丟掉中間試錯噪音的工程師;
- 希望把團隊統一的壓縮摘要模板沉澱進配置文件、避免成員每次手動補充背景的研發團隊。
一、為什麼預設 /compact 在複雜工程裏容易「失憶」
在 Codex CLI 中,當一輪重構會話不斷讀取源碼、跑單測並貼入堆棧日誌,上下文窗口很快就會逼近上限(/compact 與回滾基礎操作可先看 /guides/codex-cli-diff-compact-rewind-rollback-guide)。觸發手動 /compact 或到達 model_auto_compact_token_limit 自動壓縮時,模型會把早前的多輪消息提煉成一段結構化交接摘要。
預設壓縮策略面向通用編程場景,它很難猜出哪些細節在你的項目裏「絕對不能改寫」:例如你三輪前臨時口頭約定的「舊接口必須保持向後兼容、嚴禁修改 migrations/ 目錄」「鑑權頭固定叫 X-Tenant-Token」「當前 test_billing.py 的第 3 個用例失敗是因為 mock 時區未固定」。一旦這些細節在通用摘要裏被模糊成「已討論鑑權和帳單測試問題」,壓縮後的下一輪代碼改動就很容易推翻先前結論。
通過自定義 compact_prompt,你相當於給交接班寫了一份強制檢查表,確保每次壓縮後模型拿到的是一份精確、可繼續執行的工程交接單。
二、兩種寫法模板:行內多行字符串與外部文件引用
打開 ~/.codex/config.toml(完整結構見 /guides/codex-config-toml-complete-guide),可按下面兩種方式落地配置。
方式 1:直接在 config.toml 中寫多行 compact_prompt(本站建議模板)
使用 TOML 三雙引號 """ 可以保持良好的換行排版,避免大量 \n 轉義符:
toml
#:schema https://developers.openai.com/codex/config-schema.json
# 可選:按需調整自動壓縮觸發閾值(須在當前模型窗口範圍內)
# model_auto_compact_token_limit = 80000
compact_prompt = """
請將以上會話壓縮為供後續繼續編碼的工程交接摘要,必須嚴格保留以下 5 個分節,嚴禁概括丟失精確標識符:
1. 【硬性約束與禁區】用戶明確禁止改動的文件/目錄、向後兼容要求、禁止引入的依賴或框架約定。
2. 【已確認的接口與變量】精確保留所有已拍板的 API 路徑、字段名、配置鍵名、環境變量名與數據庫列名。
3. 【代碼改動台帳】按「文件路徑 + 函數/類名 + 改動意圖」逐條列出已完成修改的文件。
4. 【當前驗證狀態】列出最近一次運行的構建/測試命令、已通過項,以及尚未修復的報錯核心資訊與行號。
5. 【待辦下一步】按優先級列出接下來立即要做的 1 到 3 件事。
請主動刪除已被否決的早期試錯思路、重複打印的完整命令行日誌和冗長源碼原文,確保摘要精煉緊湊。
"""
方式 2:使用 experimental_compact_prompt_file 拆成獨立團隊文件
如果你希望在團隊倉庫裏用 Markdown 維護壓縮模板並方便 PR 評審,可以把上述提示詞儲存為 .codex/compact-prompt.md(或 ~/.codex/compact-prompt.md),再在 config.toml 中引用路徑:
toml
#:schema https://developers.openai.com/codex/config-schema.json
experimental_compact_prompt_file = "~/.codex/compact-prompt.md"
注意:compact_prompt 與 experimental_compact_prompt_file 二選一維護即可,避免兩處同時配置造成排查困惑;若只針對當前項目生效,請把配置放進受信任倉庫的 .codex/config.toml。

圖:本站根據 OpenAI Codex 官方文檔:Configuration Reference 整理的示意圖
訂閱與帳號準備提示:大倉長會話既吃上下文空間,也在頻繁壓縮與高推理檔位下加快消耗週期配額(窗口和限額優化可參考 /guides/codex-app-context-window-1m-setting 與 /guides/codex-usage-limits)。如果高頻觸及限額,可在本站開通 ChatGPT Pro 充值 或 ChatGPT Pro 5x iOS 可覆蓋檔;註冊新 OpenAI 帳號遇到手機驗證環節卡頓,也可查看 Codex 註冊手機驗證服務。
三、寫好 compact_prompt 的四條實操原則(本站建議)
- 只保留「精確符號」而不是長篇解釋。提醒模型保留文件名、函數名、環境變量名和接口字段名即可,不要在壓縮提示詞裏寫「把改過的代碼完整貼出來」,否則壓縮後的摘要本身就佔掉幾萬 Token,失去壓縮意義。
- 明確寫出「允許丟棄什麼」。如果不告訴模型剔除早期失敗嘗試和整屏測試日誌,摘要往往會為了求穩把過時的排查過程全留下來,導致後續繼續幹擾判斷。
- 配合階段性手動
/compact效果最好。不要每次都等到上下文徹底塞滿才被迫自動壓縮;每當一個子功能開發並驗證完畢,主動執行一次/compact(搭配合理的壓縮提示詞),既能大幅省額,也能讓下一階段推理更清爽(更多省額思路見 /guides/codex-save-usage-quota-model-reasoning-context-tips)。 - 把靜態規則放回
AGENTS.md。目錄結構、構建腳本、代碼風格這類跨任務不變的約束應留在AGENTS.md,讓compact_prompt專注儲存當前會話的動態狀態,分工清晰才不容易丟重點。
常見問題
問:設定 compact_prompt 會讓每次普通提問都額外消耗更多 Token 嗎?
答:不會。compact_prompt 只在真正執行 /compact 或達到閾值觸發自動上下文壓縮的那一次請求中被使用,日常普通對話輪次不會重複注入這段提示詞。
問:為什麼改完 compact_prompt 後,正在運行的老會話裏跑 /compact 好像沒按新模板輸出?
答:Codex 通常在啟動會話時加載 config.toml。修改壓縮提示詞後,請重啟新的終端會話或在下次開啟任務時驗證;若配置寫在倉庫級 .codex/config.toml,還需確認當前目錄已設為受信任工作區。
問:國內沒有外幣信用卡,或者公司研發團隊需要開增值稅發票報銷,怎麼開通能跑 Codex 的訂閱?
答:可在本站 AI 會員充值總覽 按需選購 ChatGPT Plus、ChatGPT Plus 官網直充 或高配額的 ChatGPT Pro,企業團隊多人部署可直接查看 ChatGPT Business 團隊定製。支持支付寶、微信支付與 AlipayHK,自助兌換無需交出帳號密碼,並可開具增值稅發票;實時價格以商品頁展示為準,售後執行掉訂閱按剩餘天數折退、封號不在質保範圍的政策。
相關教學
- Codex CLI /diff、/compact 與回滾操作完全指南
- Codex 節省額度的模型、推理檔位與上下文實用技巧
- Codex App 1M 超大上下文窗口配置說明
- Codex config.toml 配置文件完整指南
參考資料
- OpenAI Developers 文檔:Codex Configuration Reference — https://developers.openai.com/codex/config-reference
- OpenAI Codex 官方文檔:Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
- OpenAI Codex GitHub 倉庫 — https://github.com/openai/codex
0 條評論
還沒有評論,來搶沙發~