CLI 命令與斜線指令

返回 Codex 教學總目錄

讀完能做到什麼

本篇以 Codex CLI 為範圍。桌面版和 ChatGPT 網頁也可能有斜線選單，但命令集合不相同。不要把 Claude Code 的命令、網路上的舊截圖，或桌面快捷鍵直接當成 CLI 語法；先查你正在使用的介面與版本。

開始之前

先完成CLI 安裝及登入，下載待辦練習材料，用 expected 副本建立 codex-practice。這一篇主要讀取檔案和規劃，不需要 GitHub 或付費外部服務。若 codex 命令找不到，先完成安裝排錯，不要把登入問題和路徑問題混在一起。

Windows 在練習資料夾開 PowerShell；macOS 開 Terminal；Linux／WSL 開該環境自己的終端機。WSL 中的 /home 路徑與 Windows 的 C:\Users 路徑不同，命令要在真的裝有 CLI 的環境執行。確認完位置，再開始以下步驟。

五種輸入要分清楚

終端機通常顯示路徑與提示符號；Codex 互動介面則有自己的對話輸入區。在 PowerShell 輸入 /plan 會被 shell 當成命令或路徑，不能開啟 Codex 的 Plan 模式。反過來，把多行安裝命令貼進 Codex 對話，也可能變成請代理執行的要求，與你直接執行不同。

第一步：查版本與說明

codex --version
codex --help
codex resume --help

三行可以逐行執行。第一行顯示版本，第二行列出此版本的子命令與選項，第三行只看接續工作階段的說明。它們不會開始新的代理工作。本次 Windows 實際查得 codex-cli 0.154.0-alpha.6.2；這是驗證環境紀錄，不是要求你安裝這個預覽版本。

說明中的方括號表示選用內容，角括號通常代表要替換的值。不要照抄 SESSION_ID 之類的占位文字，也不要把文件展示的所有旗標一起加上。查不到選項時，先確認拼字、子命令與版本，再判斷是否需要更新。

第二步：啟動並檢查狀態

codex

進入互動介面後，在輸入框打 /，使用彈出的清單搜尋 status，再執行 /status。應看到目前工作階段的設定資訊，例如模型、權限與上下文狀態；顯示欄位依版本而異。它不是購買額度或兌換重置信用的指令。

/status

請同時用唯讀自然語言核對工作位置。若路徑不符，離開這個工作階段，回終端機進入正確資料夾再啟動。不要試圖用切換模型來修正工作目錄。

Report the current working directory and list the five Small Steps source files.
Do not edit anything. If this is not the practice folder, stop and explain.

第三步：使用 Plan 模式做一次規劃

Plan 模式適合在實作前檢查需求、影響範圍與驗收方式。在互動輸入框執行下面的內容，要求設計一個「清除已完成」功能。這個功能不在初始需求中，所以要保留未完成資料並考慮空清單；本篇只產生計畫。

/plan Plan a Clear completed button for this todo website. Do not implement it yet. Preserve active tasks and explain how to verify an empty list, mixed completion states, and reload behavior.

合格計畫應指出相關檔案、按鈕位置、資料操作、儲存方式與測試案例，不能只有「修改、測試、完成」三個空泛步驟。檢查是否誤提不存在的 React 元件或資料庫。發現不符就補充限制，直到你能用計畫判斷成果。之後要實作，依目前介面的模式控制與提示交付；計畫本身不代表已改好網站。

如果 Codex 正在工作，/plan 暫時無法使用。先等這次工作結束；確實需要中止時再使用目前介面的停止功能，核對已完成的修改後才送出規劃要求。不要重複傳送多次 /plan，或以為切換模式會撤銷先前操作。

第四步：退出並找到同一個工作階段

完成計畫後，先記下任務名稱或工作階段識別資訊，再在互動輸入框執行 /quit。回到系統終端機後，執行 codex resume，從選擇器核對時間、內容與路徑，選回剛才的任務。剛入門先用選擇器，比直接假定最後一個就是目標更容易核對。

/quit

codex resume

官方文件也提供 codex resume --last 接續目前目錄最近的工作階段；加 --all 會擴大搜尋範圍。這些選項先查 resume --help 再使用。接續後請它摘要剛才的計畫和未完成事項，並核對路徑。能說出功能不表示檔案就在正確位置，兩項都要查。

續接時，啟動位置與原工作階段的儲存位置若不同，CLI 可能要求選擇要使用哪個目錄；tui.resume_cwd 設定也會影響選擇。對這份練習先核對 codex-practice 的完整路徑，不要只靠對話標題。明確的 --cd 覆寫會優先於該設定；新手先不要加覆寫，詳見工作階段與續接。

常用指令索引

需要挑模型看模型選擇，調整授權看權限與沙盒，腳本流程看codex exec。使用 /compact 前先保留需要逐字重現的錯誤與完成條件，可參考上下文交接。總目錄的指令搜尋可用 /plan、AGENTS.md 或 resume 找到相關篇章。

驗收、常見問題與還原

正常驗收：版本與說明可讀、工作位置正確、計畫沒有修改檔案、退出後能接續同一任務。邊界驗收：在 / 選單輸入不存在的名稱，確認它沒有變成你以為的功能；取消輸入並回文件查證，不要因此提高權限或安裝來路不明的補充工具。

「不是內部或外部命令」或 command not found：這是 shell 找不到 codex，先檢查安裝位置與新的終端機環境。若 codex --help 能跑而 /plan 不能，通常是輸入介面不對，不是 CLI 沒裝好。

參數不接受：確認一般半形連字號 --，不要使用文章排版的長破折號；空格與引號也要保留。不同子命令支援的旗標可能不同，主程式接受不表示每一個子命令都接受。

resume 找不到或接錯：回想是否在不同目錄、主機或 CLI 環境啟動，先看選擇器與說明。不要用刪除歷史來處理找不到的任務。這篇沒有修改原始碼，退出即可結束；退出或重開對話不會撤銷先前已經完成的檔案操作。

圖中的 01 是系統終端機，02 是 Codex 互動輸入，03 是需要核對的結果。

小練習與查證紀錄

自己做一張四列備忘：查說明、查狀態、提出唯讀需求、接續工作。每列寫「貼在哪裡」與預期結果，再親自各做一次。能解釋 codex resume 和 /resume 的介面差異，就比背下大量旗標更接近實際使用。

查證日為 2026-09-14，依官方 CLI 指令文件及本機 --help 核對。Windows 實測包含版本、主命令與 resume 說明；互動斜線、模型選單、macOS／Linux 依官方文件查證，未宣稱全部實測。需要完整操作範例可繼續Skills與測試及審查。

返回 Codex 教學總目錄

閱讀完整文字說明

Shell to Interactive / to Result

• AI 工具
• 教學
• Codex