使用 CLI 斜槓命令
理解 Codex CLI slash commands 的控制面:會話、模型、許可權、上下文、審查和分支探索。
斜槓命令不是要背的命令表,而是 CLI 的控制面。具體可見命令會隨版本、feature flag、登入狀態和當前任務狀態變化;長期可靠的做法是記住“什麼時候該控制會話、什麼時候該控制許可權、什麼時候該審查結果”。
在 Codex CLI 的 composer 裡輸入 /,會開啟 slash command popup。官方 CLI features 文件說明,Codex 的互動模式可以讀儲存庫、改檔案、跑命令,也能用 /clear、/copy、/theme 等命令控制 TUI。執行中按 Tab 還可以把後續文本、斜槓命令或 ! shell 命令排隊到下一輪。
flowchart LR
Prompt[當前會話] --> Session[會話控制<br/>clear / new / resume / compact]
Prompt --> Risk[許可權控制<br/>permissions / status]
Prompt --> Work[工作控制<br/>plan / review / diff]
Prompt --> Branch[探索控制<br/>fork / side / agent]
Prompt --> UI[TUI 控制<br/>copy / theme / keymap / statusline]
Risk --> Verify[用 status 驗證]
Work --> Verify
先按用途記
會話控制
新開、恢復、壓縮或清空對話,避免上下文無限膨脹。
許可權控制
用 permissions 和 status 確認當前 sandbox、approval、writable roots 和 token 狀態。
任務控制
用 plan、review、diff 把實現、審查和驗證拆開。
探索控制
用 fork、side、agent 探索不同方案或檢視子執行緒工作。
會話控制
這些命令解決“當前對話要不要繼續沿用”的問題:
/compact:長會話後壓縮 transcript,釋放上下文,但保留關鍵結論。/clear:清空 terminal 並開始 fresh chat;不同於Ctrl+L只清屏。/new:在同一個 CLI session 裡開始新 conversation。/resume:從已儲存的 session 恢復舊對話。/quit//exit:退出 CLI。
使用原則很簡單:如果只是輸出太長,用 /compact;如果任務已經切換,用 /new;如果要接舊任務,用 /resume;不要在重要改動未 review 前退出。
許可權控制
這些命令解決“Codex 現在能做什麼”的問題:
/permissions:在會話中調整許可權模式,例如從只讀切到更自動化的 Auto,或在高風險任務前收回寫許可權。/status:檢視 active model、approval policy、writable roots、token usage 等當前狀態。/debug-config:排查配置層級、policy requirements、MCP、rules 等實際生效來源。
如果你不確定 Codex 現在是否能寫檔案、跑命令或聯網,先用 /status。不要靠記憶判斷當前許可權,因為 profile、專案級配置和 managed requirements 都可能改變實際行為。
任務控制
這些命令把“做事”和“檢查結果”拆開:
/plan:進入 plan mode,適合複雜實現前先出執行方案。/review:讓 Codex review working tree、commit 或自定義 diff 範圍。/diff:直接檢視當前 Git diff,包括未跟蹤檔案。/copy:複製最新完成的 Codex 輸出;也可以用Ctrl+O。
推薦流程:
- 複雜任務先
/plan,不要直接讓 Codex 改。 - 改完先
/diff看範圍。 - 再
/review找風險。 - 最後跑專案測試和構建。
探索控制
這些命令適合“同一上下文下臨時分叉”:
/fork:把當前 conversation fork 成新 thread,適合比較不同實現路線。/side:開一個臨時 side conversation,適合做聚焦追問,不汙染主線。/agent:檢視或切換 active agent thread,適合繼續 subagent 工作。
不要把這些當成預設動作。分叉越多,越容易丟失主線;只有當你確實需要比較方案、隔離探索或繼續子執行緒時再用。
TUI 和輸入效率
這些能力來自 CLI 互動模式,和 slash commands 一起構成日常控制面:
- 輸入
@可以搜尋並插入檔案路徑。 - 輸入
!可以執行本地 shell 命令;仍受 sandbox 和 approval 控制。 - 執行中按
Tab可以排隊下一輪輸入。 Ctrl+R搜尋 prompt history。Ctrl+G可以開啟由VISUAL或EDITOR指定的 prompt editor。/theme、/keymap、/statusline、/title用於調整 TUI 顯示和快捷鍵。
不要硬背完整命令表
完整命令列表受這些因素影響:
- Codex CLI 版本。
- 當前登入方式和 workspace。
- feature flags。
- 當前是否有任務執行。
- 是否啟用了 apps、plugins、MCP、subagents 或 background terminals。
- 作業系統差異,例如 Windows 原生 sandbox 相關命令。
所以教程裡只固定命令用途和判斷方法。需要確認當前機器上可用命令時,直接在 CLI 輸入 /,或查官方 CLI features 和 slash commands 入口。
官方資料
- Codex CLI features:https://developers.openai.com/codex/cli/features
- Agent approvals & security:https://developers.openai.com/codex/agent-approvals-security
- Configuration Reference:https://developers.openai.com/codex/config-reference