1375 字
7 分鐘

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 有相同入口。

  1. 輸入 /presets 開啟選單,按 n 建立提示。
  2. 在編輯器輸入測試文字,例如:「只回覆 preset-probe,不使用工具,不修改檔案。」
  3. 依畫面選擇一個空槽位並確認保存。十個槽位為 0 到 9;已有內容的替換會要求確認。
  4. 再開 /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 設定。

參考資料:

OpenAI:Codex CLI

Codex CLI 0.164.0 release notes

Codex:presets PR #54380

Codex:presets 快捷選單 PR #54381

Codex 0.164.0:TUI presets

Codex 0.164.0:設定寫入與來源檢查

Codex CLI presets 教學:保存提示、重用指令與執行前驗收
https://laplusda.com/posts/codex-cli-presets-reusable-prompts/
作者
Zero
發佈於
2026-10-24
許可協議
CC BY-NC-SA 4.0