Codex compact_prompt 自定義上下文壓縮提示詞怎麼寫:防止長對話 /compact 丟掉架構約束與關鍵變量

長對話執行 /compact 或觸發自動壓縮後,Codex 偶爾會把前面剛定好的接口字段、文件路徑和禁用項忘掉。本文詳解 config.toml 中的 compact_prompt 與 experimental_compact_prompt_file 寫法,附可直接複用的防失憶壓縮模板。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

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

高質素 compact_prompt 必保的六類工程狀態

圖:本站根據 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 的四條實操原則(本站建議)

  1. 只保留「精確符號」而不是長篇解釋。提醒模型保留文件名、函數名、環境變量名和接口字段名即可,不要在壓縮提示詞裏寫「把改過的代碼完整貼出來」,否則壓縮後的摘要本身就佔掉幾萬 Token,失去壓縮意義。
  2. 明確寫出「允許丟棄什麼」。如果不告訴模型剔除早期失敗嘗試和整屏測試日誌,摘要往往會為了求穩把過時的排查過程全留下來,導致後續繼續幹擾判斷。
  3. 配合階段性手動 /compact 效果最好。不要每次都等到上下文徹底塞滿才被迫自動壓縮;每當一個子功能開發並驗證完畢,主動執行一次 /compact(搭配合理的壓縮提示詞),既能大幅省額,也能讓下一階段推理更清爽(更多省額思路見 /guides/codex-save-usage-quota-model-reasoning-context-tips)。
  4. 把靜態規則放回 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,自助兌換無需交出帳號密碼,並可開具增值稅發票;實時價格以商品頁展示為準,售後執行掉訂閱按剩餘天數折退、封號不在質保範圍的政策。

相關教學

參考資料

  • 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

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

登入 後參與評論

還沒有評論,來搶沙發~