Codex CLI presets 教學:保存提示、重用指令與執行前驗收
每次開 Codex CLI 都貼一次「先看 diff,只列出可重現問題」,可以把這段文字存成 preset。CLI 0.164.0加入 /presets 與十個數字槽位,讓互動終端機重用提示或 slash command。選取已保存的數字槽位會提交該內容,並非只把文字貼回輸入框。
因此,第一個 preset 適合用沒有外部副作用的查詢,先確認保存、執行及設定讀回的行為。本文於 2026-10-24 檢閱 release、官方文件與該 tag 原始碼,沒有啟動 CLI 或改寫個人設定;以下為待執行的操作與驗收流程。
先在互動 CLI 建立一個不會修改檔案的 preset
這項功能屬於互動式 TUI。先在一般終端機檢查 codex --version,確認實際使用的執行檔;再進入不含敏感資料的測試專案執行 codex,等待啟動完成。本文以 0.164.0 為基準,不據此保證桌面 App、IDE 或 codex exec 有相同入口。
- 輸入
/presets開啟選單,按n建立提示。 - 在編輯器輸入測試文字,例如:「只回覆 preset-probe,不使用工具,不修改檔案。」
- 依畫面選擇一個空槽位並確認保存。十個槽位為
0到9;已有內容的替換會要求確認。 - 再開
/presets,核對槽位與內容後,按該數字執行。
選單還提供 s 從目前設定建立、e 編輯及 d 刪除。操作可對照 PR #54380與快捷選單 PR #54381;後者改成數字選單,所以不要把前一版 picker 截圖當成最終流程。
先用 /presets 驗收,再從 /keymap 確認自己的快捷鍵。自訂 keymap 與既有綁定會影響快捷入口,無須為了照教學操作而覆寫整份鍵位設定。
保存與執行,要分別檢查
該版本的 TUI 提交路徑會把槽位內容送入一般排隊與 slash command 解析流程;它也刻意保留輸入框草稿。這些設計不能只靠選單出現就算驗收成功。
可在同一個測試專案依序做三項檢查:
- 只保存:建立測試 preset 後,確認沒有因此開始新的模型工作;保存訊息也不代表該提示已執行。
- 保留草稿:先在輸入框留下
draft-probe,開啟選單執行測試槽位,確認送出的是 preset,原草稿沒有被一併送出或消失。若已有工作執行中,還要檢查排隊狀態,避免重複按鍵造成再次提交。 - 重開讀回:正常結束後,以相同設定來源重開 CLI,確認槽位仍存在。寫入失敗、另一份設定來源或不同使用者,不能用當下記憶體裡的選單當保存證據。
設定寫入實作會檢查設定層的擁有權:若槽位定義在 active user config 以外的層,就提示回原來源編輯;保存失敗也不會把記憶體狀態假裝更新成功。遇到這類訊息先查來源與寫入權限,不要直接刪除設定檔重建。
提示能重用,權限仍須在當下確認
從目前設定建立 preset,可以產生模型、推理強度或速度等指令;它不是整個 session 的備份。儲存 slash command 前先讀完整內容,尤其是 /permissions:再次呼叫代表執行一次權限指令,不能當成只切換顯示名稱。
對重複的程式碼審查,可把提示寫成以下內容,再依自己的專案補入真實檢查方式:
檢查目前未提交的變更,只回報有具體觸發條件的問題。每項列出位置、重現條件與影響;沒有足夠證據就標示待驗證。不要修改檔案、安裝套件或執行會寫入外部系統的操作。這是提示範例,沒有在本文執行。文字中的「不要修改」也不能取代工具權限;呼叫前核對目前專案、工作區路徑與 /permissions。若要固定團隊長期規則,應使用專案指引或 skill;preset 適合重用一次輸入,不應承擔整套工作流程的政策管理。完成標準的寫法可參考 AI coding agent 的可驗證完成狀態。
圖片、連結提及與跨介面的限制
0.164.0 的原始碼對輸入框中的圖片及帶綁定的 linked mentions 有特別處理:建立 preset 時不複製這些附件或綁定,會提示並從空白文字開始。不要只看到相同顯示名稱,就假設日後仍會帶入原檔案、圖片或 App 物件。
需要特定檔案時,讓提示要求先確認目前可讀路徑,再進行工作;不要在槽位裡保存金鑰、一次性憑證或客戶資料。preset 會持久保存於使用者設定,本文沒有驗證跨裝置或桌面 App 同步,也不將它描述為雲端提示庫。
如果 /presets 不存在,先比對版本與啟動入口;官方 CLI 使用文件可用來核對安裝方式。本文查核時的一般指令文件未列出這個新命令,故具體行為以 0.164.0 release 與 tag 為範圍。不要把別的工具的 prompt 檔案格式套進 Codex 設定。
參考資料: