開發者命令
Codex 開發者產品中的命令與斜槓命令參考
ChatGPT 網頁版命令
ChatGPT 網頁版有自己的輸入框命令選單。輸入 / 可檢視當前聊天中可用的操作。它不會提供 ChatGPT 桌面 App 或 CLI 的命令集；本參考中的 Codex 斜槓命令、CLI 子命令和 flags 不適用於 ChatGPT 網頁版。
ChatGPT 桌面 App 命令
通用的命令頁面涵蓋 App 導航、聊天快捷鍵、鍵盤自定義，以及聊天、設定、skills、定時任務、plugins 和 pets 的 deep links。
斜槓命令頁面涵蓋 App 輸入框中可用的命令，包括 /feedback、/goal、/init、/mcp、/plan、/review 和 /status。
Codex CLI 命令參考
如何閱讀本頁
本頁彙總了所有已文件化的 Codex CLI 命令和選項。你可以按命令名或說明來查詢。每個章節都會標明該功能是穩定還是實驗性，並指出哪些組合存在更高風險。
全域選項
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--add-dir |
path | 在主工作區之外，額外授予其他目錄寫權限。可重複傳入多個路徑。 |
--ask-for-approval, -a |
untrusted | on-request | never |
控制 Codex 在執行命令前何時暫停並請求人工核准。on-failure 已棄用；互動模式推薦 on-request，非互動模式推薦 never。 |
--cd, -C |
path | 在智能體開始處理請求前設定工作目錄。 |
--config, -c |
key=value |
覆蓋設定值。若可解析為 TOML，則按 TOML 解析；否則按字面字串處理。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean | 繞過所有審批與沙箱。只應在外部已加固的環境中使用。 |
--dangerously-bypass-hook-trust |
boolean | 本次呼叫執行已啟用的 hooks 時，不要求存在已持久化的 hook 信任記錄。僅適用於已經在 Codex 外部稽核 hook 來源的自動化環境。 |
--disable |
feature | 強制關閉某個功能開關（等價於 -c features.<name>=false）。可重複。 |
--enable |
feature | 強制開啟某個功能開關（等價於 -c features.<name>=true）。可重複。 |
--image, -i |
path[,path...] |
把一張或多張圖片附加到初始提示詞。可用逗號分隔多個路徑，也可重複傳 flag。 |
--local-provider |
lmstudio | ollama |
選擇與 --oss 一起使用的本機提供方，並在本次執行中覆蓋 oss_provider。 |
--model, -m |
string | 覆蓋設定中的 model，例如 gpt-5.6-terra。 |
--no-alt-screen |
boolean | 關閉 TUI 的 alternate screen mode（僅覆蓋本次執行中的 tui.alternate_screen）。 |
--oss |
boolean | 使用本機開源模型提供方。Codex 會依次使用 --local-provider、已設定的 oss_provider，或提示你在 LM Studio 與 Ollama 之間選擇。 |
--profile, -p |
string | 在使用者基礎設定之上疊加 $CODEX_HOME/profile-name.config.toml。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
通過 WebSocket 或 Unix socket 連線到遠端 app-server 端點。支援 codex、codex resume、codex fork、codex archive、codex delete 和 codex unarchive；其他子命令會拒絕 remote mode。 |
--remote-auth-token-env |
ENV_VAR |
從這個環境變數讀取 bearer token，並在通過 --remote 連線時傳送。要求同時使用 --remote；token 只會通過 wss:// URL 或 local-only ws:// URL 傳送。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
為模型生成的 shell 命令選擇沙箱策略。 |
--search |
boolean | 開啟即時 web search（把 web_search 從預設的 "cached" 切換為 "live"）。 |
--strict-config |
boolean | 當 config.toml 中包含當前 Codex 版本不認識的欄位時直接報錯。codex、exec、review、resume、fork、app-server、mcp-server 和 exec-server 等執行時命令支援該選項。 |
| PROMPT | string | 可選的初始提示詞。省略時只啟動 TUI，而不預填訊息。 |
這些選項適用於基礎 codex 命令，並會傳播給各個子命令，除非下文明確說明例外。執行子命令時，建議把全域選項寫在子命令後面，例如 codex exec --oss ...，這樣 Codex 才能按預期解析。
命令總覽
| 命令 | 成熟度 | 說明 |
|---|---|---|
| codex | 穩定 | 啟動終端 UI。接受上面的全域選項，以及可選提示詞或圖片附件。 |
| codex app | 穩定 | 在 macOS 或 Windows 上啟動 ChatGPT 桌面 App。macOS 可開啟工作區路徑；Windows 會列印要開啟的路徑。 |
| codex app-server | 實驗性 | 通過 stdio、WebSocket 或 Unix socket 啟動本機 Codex app-server，用於開發或除錯。 |
| codex apply | 穩定 | 把最近一次 Codex 雲端任務生成的 diff 應用到本機工作樹。別名：codex a。 |
| codex archive | 穩定 | 按 session ID 或 session 名稱歸檔已儲存的互動會話。 |
| codex cloud | 實驗性 | 在終端裡瀏覽或執行 Codex 雲端任務，而不必開啟 TUI。別名：codex cloud-tasks。 |
| codex completion | 穩定 | 為 Bash、Zsh、Fish 或 PowerShell 生成 shell 補全指令碼。 |
| codex debug app-server send-message-v2 | 實驗性 | 通過內建測試客戶端向 app-server 傳送單條 V2 訊息，便於除錯。 |
| codex debug models | 實驗性 | 列印 Codex 看到的原始 model catalog，也可只查看當前二進位制內建的 catalog。 |
| codex debug prompt-input | 實驗性 | 以 JSON 形式渲染模型可見的提示詞輸入列表，並可選擇附加提示詞和圖片。 |
| codex delete | 穩定 | 按 session ID 或 session 名稱永久刪除已儲存的互動會話。 |
| codex doctor | 穩定 | 為本機安裝、設定、認證、執行時、Git、終端、app-server 和對話執行緒清單問題生成診斷報告。 |
| codex exec | 穩定 | 以非互動模式執行 Codex。可輸出 stdout 或 JSONL，也可恢復歷史會話。別名：codex e。 |
| codex execpolicy | 實驗性 | 評估 execpolicy 規則檔案，檢視某條命令會被允許、要求核准還是被阻止。 |
| codex features | 穩定 | 列出功能開關，並把啟用 / 停用狀態持久寫入當前活動設定檔。 |
| codex fork | 穩定 | 把一個已有互動會話分叉成新對話執行緒，保留原始對話記錄。 |
| codex login | 穩定 | 通過 ChatGPT OAuth、裝置碼認證，或從 stdin 讀取 API key / access token 來認證 Codex。 |
| codex logout | 穩定 | 刪除已儲存的認證憑據。 |
| codex mcp | 穩定 | 管理 Model Context Protocol Server（列出、新增、刪除、認證）。 |
| codex mcp-server | 穩定 | 通過 stdio 把 Codex 自身作為 MCP server 執行，便於被其他智能體呼叫。 |
| codex plugin | 穩定 | 從已設定的 marketplace 來源安裝、列出或移除外掛。 |
| codex plugin marketplace | 穩定 | 從 Git 或本機來源新增、列出、升級或移除外掛市場。 |
| codex remote-control | 實驗性 | 確保本機 app-server daemon 正在執行，並啟用了 remote-control 支援。 |
| codex resume | 穩定 | 按 ID 恢復某個互動會話，或恢復最近一次對話。 |
| codex review | 穩定 | 對未提交改動、相對基礎分支的 diff、某個 commit，或按自定義審查指令執行非互動式程式碼審查。 |
| codex sandbox | 穩定 | 在 Codex 提供的 macOS、Linux 或 Windows 沙箱中執行任意命令。 |
| codex unarchive | 穩定 | 按 session ID 或 session 名稱恢復已歸檔的互動會話。 |
| codex update | 穩定 | 在已安裝版本支援 self-update 時，檢查並應用 Codex CLI 更新。 |
命令細節
codex（互動模式）
直接執行 codex 而不帶子命令時，會啟動互動式終端 UI（TUI）。智能體會接受前面列出的全域選項，也支援附加圖片。Web 搜尋預設使用 cached 模式；使用 --search 可切換到即時瀏覽。若要進行低摩擦本機工作，請使用 --sandbox workspace-write --ask-for-approval on-request。
如果要把 TUI 連線到遠端 app server，可使用 --remote ws://host:port、--remote wss://host:port、--remote unix:// 或 --remote unix://PATH，並將其指向通過 codex app-server --listen ... 啟動的服務端。如果服務端要求通過 WebSocket 使用 bearer token 認證，可額外傳入 --remote-auth-token-env <ENV_VAR>。
codex app-server
在本機啟動 Codex app-server。這個命令主要用於開發和除錯，未來可能會變更。
| 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--analytics-default-enabled |
boolean | false |
為第一方 app-server 客戶端預設啟用 analytics，除非使用者在設定中選擇退出。 |
--listen |
stdio:// | ws://IP:PORT | unix:// | unix://PATH | off |
stdio:// |
傳輸監聽 URL。用 stdio:// 表示 JSONL，ws://IP:PORT 表示 TCP WebSocket 端點，unix:// 表示預設 Unix socket，unix://PATH 表示自定義 Unix socket，off 表示停用本機傳輸。 |
--stdio |
boolean | false |
使用 stdio 傳輸。等價於 --listen stdio://，並且與 --listen 互斥。 |
--ws-audience |
string | 已簽名 bearer token 中預期的 aud 宣告值。要求同時使用 --ws-auth signed-bearer-token。 |
|
--ws-auth |
capability-token | signed-bearer-token |
為 app-server 的 WebSocket 客戶端指定認證模式。若省略，則不會啟用 WebSocket 認證；如果監聽地址不是本機地址，啟動時會給出警告。 | |
--ws-issuer |
string | 已簽名 bearer token 中預期的 iss 宣告值。要求同時使用 --ws-auth signed-bearer-token。 |
|
--ws-max-clock-skew-seconds |
number | 30 |
校驗已簽名 bearer token 的 exp 和 nbf 宣告時，允許的時鐘偏差秒數。要求同時使用 --ws-auth signed-bearer-token。 |
--ws-shared-secret-file |
absolute path | 包含 HMAC 共享金鑰的檔案路徑，用於校驗已簽名的 JWT bearer token。使用 --ws-auth signed-bearer-token 時必填。 |
|
--ws-token-file |
absolute path | 包含共享 capability token 的檔案路徑。使用 --ws-auth capability-token 時傳入，除非你改用 --ws-token-sha256。 |
|
--ws-token-sha256 |
hexadecimal SHA-256 digest | capability-token 認證所期望的 SHA-256 摘要。當客戶端 token 來自其他來源時，可用它代替 --ws-token-file。 |
codex app-server --listen stdio:// 會繼續使用預設的 JSONL-over-stdio 傳輸方式，codex app-server --stdio 是這個傳輸方式的別名。--listen ws://IP:PORT 會為 app-server 客戶端啟用 WebSocket 傳輸。服務端接受 ws:// 作為監聽 URL；如果客戶端通過 wss:// 連線，則應在前面設定 TLS 終止或安全代理。使用 --listen unix:// 可在 Codex 預設 Unix socket 上接受 WebSocket 握手；使用 --listen unix:///absolute/path.sock 可指定 socket 路徑。如果你要為客戶端繫結生成 schema，請額外加上 --experimental，這樣受門控的欄位和方法也會一併包含進去。
新增 --code-mode-host wss://code-mode.example.com/host，可讓 app-server 連線遠端 Code Mode host，而不是啟動本機 host。這條出站連線與 --listen 相互獨立，並由 app-server 程序中的所有 thread 共享。只有連線 localhost 或通過 SSH 轉發的 host 時才使用 ws://。
codex remote-control
執行 codex remote-control 會以前臺方式啟動遠端控制。使用 codex remote-control start 可啟動啟用了遠端控制的本機 app-server daemon，使用 codex remote-control stop 則可將其停止。託管 remote-control 客戶端和 SSH 遠端工作流程會使用這些命令；如果你正在建置本機協議客戶端，它們不能替代 codex app-server --listen。
daemon 執行後，使用 codex remote-control pair 可建立並列印一個短期有效的手動配對碼。為任意 remote-control 命令加上 --json 可獲得機器可讀輸出。對於 pair，JSON 響應包含 pairingCode、manualPairingCode、environmentId 和 expiresAt。
codex app
從終端啟動 ChatGPT 桌面 App（macOS 或 Windows）。在 macOS 上，Codex 可以直接開啟指定工作區路徑；在 Windows 上，Codex 會列印要開啟的路徑。
| 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--download-url |
url | 高階覆蓋項，用於替換安裝階段使用的 ChatGPT 桌面 App 安裝器 URL。 | |
PATH |
path | . |
ChatGPT 桌面 App 的工作區路徑。在 macOS 上，Codex 會開啟該路徑；在 Windows 上，Codex 會列印該路徑。 |
codex app 會開啟已安裝的 ChatGPT 桌面 App；如果尚未安裝，則啟動安裝器。在 macOS 上，Codex 會開啟給定工作區路徑；在 Windows 上，安裝後會列印要開啟的路徑。
codex debug app-server send-message-v2
使用內建 app-server 測試客戶端，通過 app-server 的 V2 對話執行緒 / 會話輪次流程傳送一條訊息。
| 參數 | 類型 / 可選值 | 說明 |
|---|---|---|
USER_MESSAGE |
string | 通過內建 V2 測試客戶端流程傳送給 app-server 的訊息文本。 |
這個除錯流程會以 experimentalApi: true 初始化，然後啟動對話執行緒、傳送會話輪次，並流式輸出服務端通知。適合在本機復現和觀察 app-server 協議行為。
codex debug models
以 JSON 形式列印 Codex 看到的原始 model catalog。
| 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--bundled |
boolean | false |
跳過重新整理，只打印當前 Codex 二進位制內建的 model catalog。 |
當你只想檢查當前二進位制打包的 catalog，而不從遠端 models endpoint 重新整理時，請使用 --bundled。
codex debug prompt-input
以 JSON 形式渲染模型實際可見的提示詞輸入列表。除錯指令發現、session 上下文或提示詞構造時，可以使用這個命令。
| 參數 / 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--image, -i |
path[,path...] |
把一張或多張圖片附加到使用者提示詞。可用逗號分隔多個路徑，也可重複傳入該選項。 |
PROMPT |
string | 可選的使用者提示詞，會追加到 session 上下文之後。 |
codex apply
把最近一次 Codex 雲端任務生成的 diff 應用到本機儲存庫。你必須已經認證，而且對該任務具有存取權限。
| 參數 | 類型 / 可選值 | 說明 |
|---|---|---|
TASK_ID |
string | 要應用其 diff 的 Codex 雲端任務 ID。 |
Codex 會列印被打補丁的檔案；如果 git apply 失敗（例如發生衝突），則以非零狀態碼退出。
codex review
以非互動方式執行程式碼審查。請只選擇一個審查目標，也可以把自定義審查指令作為提示詞傳入。
| 參數 / 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--base |
branch | 審查相對於指定基礎分支的改動。 | |
--commit |
SHA | 審查指定 commit 引入的改動。 | |
--strict-config |
boolean | false |
當 config.toml 中包含當前 Codex 版本無法識別的欄位時，直接報錯。 |
--title |
string | 設定審查摘要中顯示的 commit 標題。需要配合 --commit 使用。 |
|
--uncommitted |
boolean | false |
審查已暫存、未暫存和未追蹤的改動。 |
PROMPT |
string | -（从 stdin 读取） |
自定義審查指令。使用 - 可從 stdin 讀取指令。 |
--uncommitted、--base、--commit 和自定義 PROMPT 彼此衝突。--title 只能與 --commit 一起使用。
codex archive 與 codex unarchive
按 session ID 或 session 名稱歸檔或恢復已儲存的互動會話。當你想清理 session 選擇器、但不刪除 transcript 時，可以使用這兩個命令。session ID 的優先順序高於 session 名稱。
codex archive <SESSION>
codex unarchive <SESSION>| 參數 / 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
在改變歸檔狀態前，先連線到遠端 app-server 端點。 |
--remote-auth-token-env |
ENV_VAR |
當 --remote 要求認證時，從這個環境變數讀取 bearer token。 |
SESSION |
session ID | session name |
要歸檔或恢復的已儲存 session。session ID 的優先順序高於 session 名稱。 |
codex delete
永久刪除一個已儲存的互動會話，可按 session ID 或 session 名稱指定。只有當你想移除 transcript，而不是僅把它從活動 session 列表中隱藏時，才使用這個命令。
codex delete <SESSION>
codex delete <SESSION_UUID> --force| 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--force |
boolean | false |
不再提示確認就刪除。session 參數必須是 UUID；按名稱刪除仍需要互動確認。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
刪除 session 前先連線到遠端 app-server 端點。 | |
--remote-auth-token-env |
ENV_VAR |
當 --remote 要求認證時，從這個環境變數讀取 bearer token。 |
|
SESSION |
session ID | session name | 要刪除的已儲存 session。session ID 優先於 session 名稱。 |
只應對 session UUID 使用 --force。按名稱刪除仍會要求確認，避免 Codex 在名稱重複或含糊時直接刪除錯誤的 session。
codex cloud
在終端中操作 Codex 雲端任務。預設命令會開啟一個互動式選擇器；codex cloud exec 可直接提交任務；codex cloud list 則可返回最近任務，便於指令碼呼叫或快速檢視。
| 參數 | 類型 / 可選值 | 說明 |
|---|---|---|
--attempts |
1-4 |
Codex 雲端要執行的 assistant 嘗試次數（best-of-N）。 |
--env |
ENV_ID |
目標 Codex 雲端環境 ID（必填）。可先執行 codex cloud 檢視可用值。 |
| QUERY | string | 任務提示詞。若省略，Codex 會互動式提示你輸入。 |
認證沿用主 CLI 使用的同一套憑據。若任務提交失敗，Codex 會以非零狀態碼退出。
codex cloud list
列出最近的雲端任務，並支援過濾和分頁。
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--cursor |
string | 上一次請求返回的分頁游標。 |
--env |
ENV_ID |
按 environment ID 過濾任務。 |
--json |
boolean | 輸出機器可讀 JSON，而不是純文本。 |
--limit |
1-20 |
最多返回多少個任務。 |
純文本輸出會列印任務 URL 及狀態資訊；自動化場景請優先使用 --json。JSON 負載中包含 tasks 陣列和可選的 cursor 值。每個任務會帶有 id、url、title、status、updated_at、environment_id、environment_label、summary、is_review 和 attempt_total 欄位。
codex completion
生成 shell completion 指令碼，並把輸出重定向到合適位置，例如 codex completion zsh > "${fpath[1]}/_codex"。
| 參數 | 類型 / 可選值 | 說明 |
|---|---|---|
| SHELL | bash | zsh | fish | power-shell | elvish |
要生成 completion 的 shell 類型。輸出寫到 stdout。 |
codex doctor
生成經過脫敏的本機診斷報告，用於排查安裝、設定、認證、執行時、Git、終端、app-server 和對話執行緒清單問題。
| 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--all |
boolean | false |
在可讀報告中展開較長列表。 |
--ascii |
boolean | false |
在可讀輸出中使用 ASCII 狀態標籤和分隔符。 |
--json |
boolean | false |
輸出經過脫敏的機器可讀支援報告。 |
--no-color |
boolean | false |
在可讀輸出中停用 ANSI 顏色。 |
--summary |
boolean | false |
只顯示按組排列的檢查行和最終數量摘要。 |
codex features
管理儲存在 $CODEX_HOME/config.toml 中的功能開關。enable 與 disable 子命令會把變更持久寫入設定，以便對後續會話生效。
| 子命令 | 類型 / 可選值 | 說明 |
|---|---|---|
Disable subcommand |
codex features disable <feature> |
在 $CODEX_HOME/config.toml 中持久停用某個功能開關。 |
Enable subcommand |
codex features enable <feature> |
在 $CODEX_HOME/config.toml 中持久啟用某個功能開關。 |
List subcommand |
codex features list |
展示已知功能開關、成熟度階段以及當前生效狀態。 |
codex exec
對於指令碼式或 CI 風格的執行，請使用 codex exec（短命令是 codex e）。它會在無需人工互動的前提下完成任務。
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--cd, -C |
path | 在執行任務前設定工作區根目錄。 |
--color |
always | never | auto |
控制 stdout 中 ANSI 顏色的輸出。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean | 繞過審批與沙箱。風險極高，只能在隔離執行器中使用。 |
--dangerously-bypass-hook-trust |
boolean | 本次呼叫執行已啟用的 hooks 時，不要求存在已持久化的 hook 信任記錄。僅適用於已經在 Codex 外部稽核 hook 來源的自動化環境。 |
--ephemeral |
boolean | 執行時不把會話執行記錄檔案持久化到磁碟。 |
--full-auto |
boolean | 已棄用的相容 flag。請優先使用 --sandbox workspace-write；使用該 flag 時 Codex 會列印警告。 |
--ignore-rules |
boolean | 本次執行不載入使用者或專案 execpolicy .rules 檔案。 |
--ignore-user-config |
boolean | 不載入 $CODEX_HOME/config.toml。認證仍會使用 CODEX_HOME。 |
--image, -i |
path[,path...] |
給首條訊息附加圖片。可重複，也支援逗號分隔多個路徑。 |
--json, --experimental-json |
boolean | 輸出按行分隔的 JSON 事件，而不是格式化文本。 |
--local-provider |
lmstudio | ollama |
選擇與 --oss 一起使用的本機提供方，並在本次執行中覆蓋 oss_provider。 |
--model, -m |
string | 覆蓋本次執行所使用的 model。 |
--oss |
boolean | 使用本機開源提供方。Codex 會使用 --local-provider 或已設定的 oss_provider；如果兩者都未設定，則報錯退出。 |
--output-last-message, -o |
path | 把 assistant 的最終訊息寫入檔案，適合供下游指令碼讀取。 |
--output-schema |
path | 描述最終輸出結構的 JSON Schema 檔案。Codex 會按此校驗工具輸出。 |
--profile, -p |
string | 在使用者基礎設定之上疊加 $CODEX_HOME/profile-name.config.toml。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
模型生成命令所使用的沙箱策略。預設取設定值。 |
--skip-git-repo-check |
boolean | 允許在 Git 儲存庫之外執行（適合一次性目錄）。 |
-c, --config |
key=value |
為這次非互動執行內聯覆蓋設定（可重複）。 |
| PROMPT | string | - (read stdin) |
任務的初始提示詞。傳 - 表示從 stdin 讀取提示詞。 |
Resume subcommand |
codex exec resume [SESSION_ID] |
按 ID 恢復某個 exec 會話；或配合 --last 恢復當前工作目錄下最近一次會話；加 --all 可跨目錄查詢。也支援額外跟一條後續提示詞。 |
預設情況下，Codex 會輸出格式化文本。加上 --json 後，會改為輸出按行分隔的 JSON 事件（每個狀態變化一條）。可選的 resume 子命令用於續跑非互動任務。使用 --last 會選取當前工作目錄下最近的會話；如果要跨所有會話查詢，則再加上 --all：
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--all |
boolean | 在選擇最近會話時，把當前工作目錄之外的會話也納入候選。 |
--image, -i |
path[,path...] |
給後續提示詞附加一張或多張圖片。可重複，也支援逗號分隔路徑。 |
--last |
boolean | 恢復當前工作目錄下最近一次對話。 |
| PROMPT | string | - (read stdin) |
恢復後立即傳送的可選後續指令。 |
SESSION_ID |
uuid | 恢復指定會話。若省略，則需配合 --last 使用。 |
codex execpolicy
在儲存 execpolicy 規則檔案前先做檢查。codex execpolicy check 接受一個或多個 --rules flag（例如指向 ~/.codex/rules 下的檔案），並輸出 JSON，說明最嚴格的決策結果以及命中的規則。加上 --pretty 可格式化輸出。execpolicy 當前仍屬預覽功能。
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--pretty |
boolean | 以更易讀的格式列印 JSON 結果。 |
--rules, -r |
path (repeatable) |
要評估的 execpolicy 規則檔案路徑。可傳多個，組合多份規則一起判斷。 |
COMMAND... |
var-args |
要按指定策略進行檢查的命令。 |
codex login
使用 ChatGPT 賬號、API key 或 access token 對 CLI 進行認證。不加任何 flag 時，Codex 會開啟瀏覽器走 ChatGPT OAuth 流程。
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--device-auth |
boolean | 使用 OAuth 裝置碼流程，而不是直接拉起瀏覽器。 |
--with-access-token |
boolean | 從 stdin 讀取 access token，例如 printenv CODEX_ACCESS_TOKEN | codex login --with-access-token。 |
--with-api-key |
boolean | 從 stdin 讀取 API key，例如 printenv OPENAI_API_KEY | codex login --with-api-key。 |
status subcommand |
codex login status |
列印當前認證方式；若已登入則以退出碼 0 返回。 |
codex login status 在憑據存在時返回 0，因此很適合在自動化指令碼中做登入狀態檢查。
codex logout
刪除已儲存的 API key 與 ChatGPT 認證憑據。這個命令沒有額外 flag。
codex mcp
管理儲存在 ~/.codex/config.toml 中的模型上下文協議服務端設定。
| 子命令 | 類型 / 可選值 | 說明 |
|---|---|---|
add <name> |
-- <command...> | --url <value> |
使用 stdio 啟動命令或 streamable HTTP URL 註冊一個服務端。對 stdio 傳輸還支援 --env KEY=VALUE。 |
get <name> |
--json |
檢視某個服務端的設定。--json 會列印原始設定項。 |
| list | --json |
列出已設定的 MCP server。加 --json 可輸出機器可讀結果。 |
login <name> |
--scopes scope1,scope2 |
為某個 streamable HTTP 服務端發起 OAuth 登入（僅對支援 OAuth 的服務端有效）。 |
logout <name> |
刪除某個 streamable HTTP 服務端的已儲存 OAuth 憑據。 | |
remove <name> |
刪除已儲存的 MCP server 定義。 |
add 子命令同時支援 stdio 和 streamable HTTP 兩種傳輸方式：
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
連線 streamable HTTP 服務端時，取這個環境變數的值作為 bearer token。 |
--env KEY=VALUE |
repeatable | 啟動 stdio 服務端時附帶的環境變數。 |
--oauth-client-id |
CLIENT_ID |
streamable HTTP MCP server 的 OAuth client identifier。需要配合 --url 使用。 |
--oauth-resource |
RESOURCE |
登入 streamable HTTP MCP server 時附帶的 OAuth resource 參數。需要配合 --url 使用。 |
--url |
https://… |
註冊 streamable HTTP 服務端，而不是 stdio。與 COMMAND... 互斥。 |
COMMAND... |
stdio transport |
用於啟動 MCP server 的執行檔及參數。需要放在 -- 之後。 |
OAuth 相關動作（login、logout）只適用於 streamable HTTP 服務端，而且服務端本身也必須支援 OAuth。
codex plugin
從已設定的 marketplace 安裝、列出和移除外掛。
| 子命令 | 類型 / 可選值 | 說明 |
|---|---|---|
add <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
從已設定的 marketplace 安裝外掛。如果外掛參數沒有寫 @marketplace，可用 --marketplace 或 -m 指定 marketplace。 |
list |
[--marketplace, -m NAME] [--available --json] [--json] |
列出已安裝外掛。使用 --json 時，輸出包含 installed 和 available 陣列；--available 會包含尚未安裝的 marketplace 外掛，並且要求同時使用 --json。 |
marketplace |
管理已設定的 marketplace 來源。參見下面的 codex plugin marketplace。 |
|
remove <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
從本機設定和快取中移除已安裝外掛。使用 --json 可獲得便於自動化處理的輸出。 |
codex plugin add --json 會列印 pluginId、name、marketplaceName、version、installedPath 和 authPolicy。codex plugin list --json 會列印 installed 和 available 陣列；條目包含 pluginId、name、marketplaceName、version、installed、enabled、source、installPolicy、authPolicy，可用時還會包含 marketplaceSource，其中記錄已設定 marketplace 的來源類型和值。codex plugin remove --json 會列印 pluginId、name 和 marketplaceName。
codex plugin marketplace
管理 Codex 可瀏覽和安裝的外掛市場來源。
| 子命令 | 類型 / 可選值 | 說明 |
|---|---|---|
add <source> |
[--ref REF] [--sparse PATH] [--json] |
從 GitHub 簡寫、Git URL、SSH URL 或本機 marketplace 根目錄安裝外掛市場。--sparse 只支援 Git 來源，並且可重複傳入。 |
list |
[--json] |
顯示 Codex 當前會考慮的外掛市場，以及每個 marketplace 的根路徑。 |
remove <marketplace-name> |
[--json] |
移除一個已設定的外掛市場。 |
upgrade [marketplace-name] |
[--json] |
重新整理一個已設定的 Git 外掛市場；如果省略名稱，則重新整理所有已設定的 Git 外掛市場。 |
codex plugin marketplace add 接受 owner/repo 或 owner/repo@ref 這類 GitHub 簡寫、HTTP 或 HTTPS Git URL、SSH Git URL，以及本機 marketplace 根目錄。使用 --ref 可以固定 Git ref；對基於 Git 的 marketplace 儲存庫，可以重複傳入 --sparse PATH 來使用 sparse checkout。
codex plugin marketplace list 會列印當前作用域內的 marketplace 名稱和根路徑，包括隱式發現的預設 marketplace 和已設定的 marketplace 快照。
為 marketplace 的 add、list、upgrade 或 remove 命令加上 --json，可獲得便於自動化處理的輸出。marketplace add 的 JSON 包含 marketplaceName、installedRoot 和 alreadyAdded；list 的 JSON 包含 marketplaces 陣列，其中含 name、root 和可選的 marketplaceSource；upgrade 的 JSON 包含 selectedMarketplaces、upgradedRoots 和 errors；remove 的 JSON 包含 marketplaceName 和 installedRoot。
codex mcp-server
通過 stdio 把 Codex 自身作為 MCP server 執行，以便其他工具接入。這個命令會繼承全域設定覆蓋項，並在下游客戶端關閉連線時退出。
codex resume
按 ID 恢復某個互動會話，或恢復最近一次對話。codex resume 會把 --last 預設限制在當前工作目錄；如果你傳 --all，則會跨目錄查詢。它支援與 codex 相同的全域選項，包括 model 和沙箱覆蓋項。
如果當前工作目錄與會話儲存的目錄不同，Codex 會詢問要使用哪個目錄。將 tui.resume_cwd 設為 "current" 或 "session"，即可複用該選擇而不再提示。顯式傳入的 --cd（-C）會優先於 tui.resume_cwd。
| 選項 | 類型 / 可選值 | 預設值 | 說明 |
|---|---|---|---|
--all |
boolean | 在選擇最近對話時，把當前工作目錄之外的 session 一併納入候選。 | |
--include-non-interactive |
boolean | false |
在選擇器和 --last 的選擇範圍中包含非互動式 session。 |
--last |
boolean | 跳過選擇器，直接恢復當前工作目錄下最近一次對話。 | |
SESSION_ID |
uuid | 恢復指定會話。若省略，則需配合 --last 使用。 |
codex fork
把一個已有互動會話分叉成新對話執行緒。預設情況下，codex fork 會開啟會話選擇器；如果你加上 --last，則會直接分叉最近一次會話。
當前目錄與會話儲存的目錄不同時，codex fork 會使用與 codex resume 相同的工作目錄提示和 tui.resume_cwd 設定。
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--all |
boolean | 在選擇器中顯示當前工作目錄之外的會話。 |
--last |
boolean | 跳過選擇器，直接分叉最近一次對話。 |
SESSION_ID |
uuid | 分叉指定會話。若省略，則需配合 --last 使用。 |
codex sandbox
使用沙箱輔助工具，以與 Codex 內部一致的策略來執行某條命令。
macOS seatbelt
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--allow-unix-socket |
path | 允許沙箱內命令繫結或連線位於該路徑下的 Unix socket。可重複允許多個路徑。 |
--cd, -C |
DIR | 用於設定檔解析和命令執行的工作目錄。需要配合 --permission-profile 使用。 |
--config, -c |
key=value |
向沙箱執行注入設定覆蓋項（可重複）。 |
--include-managed-config |
boolean | 解析顯式權限設定檔時包含託管 requirements。需要配合 --permission-profile 使用。 |
--log-denials |
boolean | 命令執行期間用 log stream 捕獲 macOS sandbox deny 記錄，並在退出後列印。 |
--permission-profile, -P |
NAME | 從當前啟用設定棧中應用一個命名權限設定檔。 |
--profile, -p |
NAME | 把 $CODEX_HOME/NAME.config.toml 疊加到基礎使用者設定之上。 |
COMMAND... |
var-args |
在 macOS Seatbelt 中執行的 shell 命令。-- 之後的內容都會原樣轉發。 |
Linux Landlock
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--cd, -C |
DIR | 用於設定檔解析和命令執行的工作目錄。需要配合 --permission-profile 使用。 |
--config, -c |
key=value |
在啟動沙箱前應用設定覆蓋項（可重複）。 |
--include-managed-config |
boolean | 解析顯式權限設定檔時包含託管 requirements。需要配合 --permission-profile 使用。 |
--permission-profile, -P |
NAME | 從當前啟用設定棧中應用一個命名權限設定檔。 |
--profile, -p |
NAME | 把 $CODEX_HOME/NAME.config.toml 疊加到基礎使用者設定之上。 |
COMMAND... |
var-args |
在 Landlock + seccomp 中執行的命令。執行檔需放在 -- 之後。 |
Windows
| 選項 | 類型 / 可選值 | 說明 |
|---|---|---|
--cd, -C |
DIR | 用於設定檔解析和命令執行的工作目錄。需要配合 --permission-profile 使用。 |
--config, -c |
key=value |
在啟動沙箱前應用設定覆蓋項（可重複）。 |
--include-managed-config |
boolean | 解析顯式權限設定檔時包含託管 requirements。需要配合 --permission-profile 使用。 |
--permission-profile, -P |
NAME | 從當前啟用設定棧中應用一個命名權限設定檔。 |
--profile, -p |
NAME | 把 $CODEX_HOME/NAME.config.toml 疊加到基礎使用者設定之上。 |
COMMAND... |
var-args |
在原生 Windows sandbox 中執行的命令。執行檔需放在 -- 之後。 |
codex update
當已安裝版本支援 self-update 時，檢查並應用 Codex CLI 更新。Debug build 會列印提示，說明應安裝 release build。
選項組合與安全建議
- 對於可以保持在工作區內的無人值守本機工作，請使用
--sandbox workspace-write；除非已經處在專用 sandbox VM 中，否則避免使用--dangerously-bypass-approvals-and-sandbox。 - 如果需要給 Codex 更多目錄的寫權限，優先使用
--add-dir，而不是直接切到--sandbox danger-full-access。 - 在 CI 中把
--json與--output-last-message組合使用，可以同時捕獲機器可讀進度和最終自然語言摘要。
相關資源
互動式快捷操作
- 輸入
@可搜尋工作區檔案，並把路徑加入提示詞。 - 按 Up 或 Down 可恢復草稿歷史。
- 按 Ctrl+R 搜尋提示詞歷史，再按 Enter 使用匹配項，或按 Esc 取消。
- 按 Ctrl+O 或執行
/copy，複製最近一次已完成的 Codex 輸出。 - 在行首輸入
!，可按當前審批與沙箱設定執行本機 shell 命令。 - Codex 工作時按 Tab，可把後續提示詞、斜槓命令或 shell 命令排入下一 turn。
- Codex 工作時按 Enter，可向當前 turn 注入新指令。
- 輸入框為空時連續按兩次 Esc，可編輯上一條使用者訊息並從該處 fork。
- 按 Ctrl+C 或執行
/exit關閉會話。
Codex CLI 斜槓命令
斜槓命令讓你可以用鍵盤優先的方式快速控制 Codex。在輸入框中輸入 / 會開啟斜槓命令彈出選單；選中某個命令後，Codex 就能在不離開終端的情況下執行切換模型、調整權限、壓縮長對話等操作。
本頁會說明如何：
- 找到適合當前任務的內建斜槓命令
- 用
/model、/fast、/personality、/permissions、/approve、/raw、/agent、/status等命令調整正在進行中的會話
內建斜槓命令
Codex 內建了以下命令。開啟斜槓命令彈出選單後，開始輸入命令名即可過濾列表。
當某個任務已經在執行時，你可以輸入斜槓命令並按 Tab，把它排隊到下一輪執行。Codex 會在實際執行時再解析這些排隊的斜槓命令，因此命令選單和錯誤會在當前會話輪次結束後顯示。排隊前，斜槓補全仍然可用。
| 命令 | 用途 | 何時使用 |
|---|---|---|
/permissions |
設定 Codex 在不先詢問的情況下可以做什麼。 | 想在會話中途放寬或收緊審批要求時，例如在 Auto 和 Read Only 之間切換。 |
/ide |
包含開啟檔案、當前選區和其他 IDE 上下文。 | 想把編輯器上下文帶進下一條提示詞，而不重新解釋 IDE 裡打開了什麼時。 |
/keymap |
重新對映 TUI 快捷鍵。 | 想檢視自定義快捷鍵繫結並把它們持久寫入 config.toml 時。 |
/vim |
切換輸入框的 Vim 模式。 | 想在 Vim normal / insert 行為和預設輸入編輯模式之間切換時。 |
/setup-default-sandbox |
設定提權後的智能體沙箱（僅 Windows）。 | Codex 提供提權設定後，用它替換功能受限的 Windows 沙箱。 |
/sandbox-add-read-dir |
為額外目錄授予沙箱讀權限（僅 Windows）。 | 某些命令需要讀取當前可讀根目錄之外的絕對路徑時，用它解鎖。 |
/agent, /subagents |
切換當前啟用的智能體對話執行緒。 | 想檢視或繼續某個已生成的子智能體對話執行緒時。 |
/apps |
瀏覽 Apps（連接器），並把它們插入提示詞。 | 想先把某個 App 以 $app-slug 的形式附加進提示詞，再讓 Codex 呼叫它時使用。 |
/plugins |
瀏覽已安裝和可發現的外掛。 | 想檢查外掛工具、安裝建議外掛，或管理哪些外掛可用時使用。 |
/hooks |
檢視和管理生命週期 hooks。 | 想檢查設定的 hooks、信任新增或變更的 hooks，或在非託管 hooks 執行前停用它們時。 |
/clear |
清空終端，並開始一個新聊天。 | 想同時重置可見 UI 和當前對話時。 |
/rename |
重新命名當前聊天。 | 無需離開 TUI，即可為已儲存的 session 設定易於識別的名稱。 |
/archive |
歸檔當前會話並退出 Codex。 | 想把當前 session 從活動 session 列表中移除、但不刪除 transcript 時使用。 |
/delete |
永久刪除當前會話並退出 Codex。 | 當歸檔還不夠，需要移除 transcript 和派生 session 時使用。 |
/compact |
總結當前可見對話，以釋放 token。 | 長會話後壓縮對話記錄，保留重點並騰出上下文空間。 |
/copy |
複製最近一次已完成的 Codex 輸出。 | 想直接拿到最近一條完成回覆或計劃文本，而不手動選中複製；也可以按 Ctrl+O。 |
/diff |
顯示 Git diff，包括 Git 尚未追蹤的檔案。 | 在提交或執行測試前，先審查 Codex 改了什麼。 |
/exit |
退出 CLI（等價於 /quit）。 |
作為 /quit 的另一種寫法使用；兩者都會直接退出會話。 |
/experimental |
切換實驗性功能。 | 想在 CLI 中開啟可選能力，例如子智能體。 |
/approve |
核准最近一次自動審查拒絕後的重試。 | 想讓 Codex 重試被自動審查拒絕的命令或動作時。 |
/memories |
設定記憶使用和生成。 | 想在不離開 TUI 的情況下開啟或關閉記憶注入 / 生成時。 |
/skills |
瀏覽和使用技能。 | 想選擇相關本機技能來改善特定任務行為時。 |
/import |
匯入 Claude Code 設定、專案和最近聊天。 | 把支援的外部智能體產物遷移到 Codex 設定和本機檔案中。 |
/feedback |
向 Codex 維護團隊傳送日誌。 | 想報告問題或分享診斷資訊時。 |
/init |
在當前目錄生成 AGENTS.md 骨架。 |
想為儲存庫或子目錄留下長期生效的操作指令時。 |
/logout |
退出 Codex 登入狀態。 | 在共享機器上清理本機憑據。 |
/mcp |
列出已設定的 Model Context Protocol（MCP）工具。 | 想確認本會話可用的外部工具能力時；新增 verbose 可檢視 MCP server 詳情。 |
/mention |
把檔案附加到當前對話。 | 想讓 Codex 下一步重點檢視某個檔案或目錄。 |
/model |
選擇當前使用的模型，以及可用時的推理強度。 | 在執行任務前切換模型，例如 gpt-5.6-luna 或 gpt-5.6-terra。 |
/fast |
為受支援模型切換快速模式（Fast mode）。 | 開啟 / 關閉快速模式，或檢查當前對話執行緒是否處於快速模式。 |
/plan |
切換到計劃模式，並可選擇立即附帶一條提示詞。 | 想先讓 Codex 給出執行計劃，再進入實現階段時。 |
/goal |
設定、暫停、恢復、檢視或清除任務目標。 | 讓 Codex 在較大的任務執行期間持續跟蹤一個目標。 |
/personality |
設定響應風格。 | 想讓 Codex 更簡潔、更解釋型，或更偏協作式，而不改寫原提示詞。 |
/ps |
檢視實驗性的後臺終端及其最近輸出。 | 想不離開主對話記錄就檢視長任務進度時。 |
/stop |
停止所有後臺終端。 | 想取消當前會話啟動的後臺終端任務時。 |
/fork |
把當前對話分叉成新對話執行緒。 | 想在不丟失當前對話記錄的情況下平行探索另一種做法。 |
/app |
在 ChatGPT 桌面 App 中繼續當前 session。 | 在 macOS 或 Windows 上從 TUI 切換到桌面 App。 |
/side, /btw |
啟動一個臨時側邊會話（side conversation）。 | 想在不打斷主對話執行緒記錄的情況下提出一個聚焦追問。 |
/raw |
切換原始滾動回看（raw scrollback）模式。 | 想在檢視長輸出時讓終端選中和複製更少受格式化影響。 |
/resume |
從 session 列表中恢復某個已儲存對話。 | 想繼續之前的 CLI 會話，而不從頭開始時。 |
/new |
在同一個 CLI 會話裡開啟一個新對話。 | 想在同一儲存庫中切換新任務，但不退出 CLI。 |
/quit |
退出 CLI。 | 想立即離開當前會話時。 |
/review |
讓 Codex 審查當前工作樹。 | 當 Codex 完成任務後，或你想讓它再看一遍本機改動時。 |
/status |
顯示當前會話設定和 token 使用情況。 | 用來確認當前模型、審批策略、可寫目錄和上下文餘量。 |
/usage |
檢視賬戶 token 用量，或使用 rate-limit reset。 | 在 TUI 內檢視每日、每週或累計的 ChatGPT token 活動。 |
/debug-config |
列印設定層疊與 requirements 診斷資訊。 | 需要排查設定優先順序、策略要求或實驗性網路約束時。 |
/statusline |
互動式設定 TUI 底部狀態列項。 | 想挑選並重排底部狀態列中顯示的 model / context / limits / git / tokens / session 等資訊時。 |
/title |
互動式設定終端視窗或標籤標題項。 | 想把專案、狀態、對話執行緒、分支、模型或任務進度等資訊顯示到終端標題中時。 |
/theme |
選擇語法高亮主題。 | 想預覽並儲存終端語法高亮主題時。 |
/pets, /pet |
選擇或隱藏終端寵物。 | 使用內建或自定義的環境寵物來個人化 TUI。 |
/quit 和 /exit 都會退出 CLI。退出前請確認你已經儲存或提交了重要工作。
使用 /permissions 調整 Codex 在不先詢問的情況下可以做什麼。只有當你需要重試最近被自動審查拒絕的動作時，才使用 /approve。
用斜槓命令控制當前會話
下面這些工作流程可以幫助你在不重啟 Codex 的情況下持續調整會話。
用 /model 設定當前模型
- 啟動 Codex 並開啟輸入框。
- 輸入
/model並按 Enter。 - 從彈出選單中選擇
gpt-5.6-luna、gpt-5.6-terra等模型。
預期結果：Codex 會在對話記錄中確認模型已切換。你也可以執行 /status 再確認一次。
用 /fast 切換快速 service tier
- 輸入
/fast on、/fast off或/fast status。 - 如果你希望這個設定持久生效，可以在 Codex 提示儲存更新時確認。
預期結果：Codex 會說明當前模型的 Fast service tier 是否已在當前對話執行緒開啟。在 TUI 底部狀態列中，你也可以用 /statusline 顯示快速模式的狀態項。
Fast tier 命令由模型目錄驅動。如果當前模型沒有宣告 Fast tier，Codex 不會顯示 /fast。
用 /personality 設定溝通風格
使用 /personality 可以在不重寫提示詞的情況下調整 Codex 的表達方式。
- 在當前對話中輸入
/personality並按 Enter。 - 從彈出選單中選擇一種風格。
預期結果：Codex 會在對話記錄中確認新的風格，並在後續回覆中持續採用它。
Codex 支援 friendly、pragmatic 和 none 三種溝通風格（personality）。使用 none 可關閉溝通風格指令。
如果當前模型不支援溝通風格專用指令，Codex 會隱藏這個命令。
用 /plan 切換到計劃模式
- 輸入
/plan並按 Enter，把當前對話切換到計劃模式。 - 你也可以直接附帶一段內聯提示詞，例如
/plan Propose a migration plan for this service。 - 使用內聯
/plan參數時，你也可以貼上內容或附加圖片。
預期結果：Codex 會進入計劃模式，並把你可選提供的內聯提示詞作為第一條計劃請求。
當某個任務已經在執行時，/plan 會暫時不可用。
用 /goal 設定或檢視任務目標
- 輸入
/goal <objective>設定目標，例如/goal Finish the migration and keep tests green。 - 輸入
/goal檢視當前目標。 - 使用
/goal pause、/goal resume或/goal clear暫停、恢復或移除目標。
預期結果：Codex 會在工作繼續推進時，把該目標持續附加到活動對話執行緒上。
目標內容必須非空，且最多 4,000 個字元。對於更長的指令，請把細節放進檔案，並讓目標指向該檔案。
用 /experimental 切換實驗性功能
- 輸入
/experimental並按 Enter。 - 切換你想啟用的功能，例如 Apps 或 Guardian approval；如果 Codex 提示需要重啟，則按提示執行。
預期結果：Codex 會把你的功能選擇寫入設定，並在重啟後生效。
用 /approve 核准自動審查拒絕後的重試
當自動審查拒絕了最近一次動作，而你希望 Codex 重試一次時，可以使用 /approve。
- 輸入
/approve。 - 當 Codex 顯示相關被拒絕動作時，確認重試。
預期結果：Codex 會在當前會話策略下重試該被拒絕動作一次。
用 /memories 設定記憶
- 輸入
/memories。 - 選擇 Codex 應該使用已有記憶、生成新記憶，還是保持記憶行為關閉。
預期結果：Codex 會更新後續會話使用的相關記憶設定。
用 /skills 使用技能
- 輸入
/skills。 - 選擇你希望 Codex 應用的技能。
預期結果：Codex 會插入所選技能上下文，讓下一條請求遵循該技能的說明。
用 /import 匯入 Claude Code 設定
- 輸入
/import。 - 選擇 Claude Code。
- 選擇要遷移的設定、專案檔案或最近聊天。
預期結果：Codex 會開啟外部智能體匯入選擇器，並把選中的受支援產物匯入 Codex 設定和本機檔案。session 發現範圍包括最近 30 天內最多 50 個聊天。
/import 只能在本機 TUI session 中執行。任務執行中、遠端 session 中，以及連線到本機 app-server daemon 時不可用。
桌面 App 工作流程和支援的產物類型請參見從其他智能體匯入。
用 /clear 清空終端並開始新聊天
- 輸入
/clear並按 Enter。
預期結果：Codex 會清空終端、重置當前可見的對話記錄，並在同一個 CLI 會話中啟動一個全新的聊天。
若要在建立時為新對話命名，請執行 /clear release prep。
與 Ctrl+L 不同，/clear 會開啟一個新對話。
Ctrl+L 只會清空終端顯示，不會清空當前聊天。任務執行中時，這兩個動作都會被停用。
用 /archive 歸檔當前 session
- 輸入
/archive並按 Enter。 - 確認你要歸檔當前 session 並退出 Codex。
預期結果：Codex 會歸檔當前 session，並關閉互動式 TUI。Codex 會繼續在本機儲存 session transcript；之後可用 codex unarchive <SESSION> 恢復。
任務執行中時，/archive 不可用。
用 /delete 刪除當前 session
- 輸入
/delete並按 Enter。 - 確認你要刪除當前 session 並退出 Codex。
預期結果：Codex 會刪除當前 session transcript，並關閉互動式 TUI。刪除是永久性的，也會移除派生出的後代 sessions。
任務執行中或處於側邊會話時，/delete 不可用。
用 /permissions 更新權限
- 輸入
/permissions並按 Enter。 - 選擇與你當前風險偏好匹配的審批預設，例如無人值守執行時可選
Auto，想先審查改動時可選Read Only。啟用具名權限設定檔時，選擇器也會顯示已設定的自定義設定檔及其說明。
預期結果：Codex 會公佈新的策略，後續動作都會遵守更新後的審批模式，直到你再次修改。
用 /ide 包含 IDE 上下文
- 輸入
/ide。 - 如果你想解釋 Codex 應如何使用當前 IDE 選區或開啟檔案，可以追加可選行內文本。
預期結果：Codex 會把可用 IDE 上下文加入下一條提示詞。
用 /vim 切換 Vim 模式
- 輸入
/vim。 - 繼續在輸入框中編輯。
預期結果：Codex 會為當前會話切換輸入框 Vim 模式。若要讓新會話預設使用 Vim 模式，請在 config.toml 中設定 tui.vim_mode_default = true。
用 /setup-default-sandbox 設定提權後的 Windows 沙箱
這個命令僅在 Windows 上 Codex 正使用功能受限的 restricted-token 沙箱時顯示。
- 輸入
/setup-default-sandbox。 - 按照管理員設定流程操作。
預期結果：Codex 會設定提權後的 Windows 沙箱，並選擇相應的自動審批預設。
用 /copy 複製最新回覆
- 輸入
/copy並按 Enter。
預期結果：Codex 會把最近一條已完成的輸出複製到剪貼簿。
如果當前會話輪次仍在執行，/copy 會複製最近一條已完成的輸出，而不是正在生成中的回覆。在第一條完整輸出產生之前，以及回滾剛結束後，這個命令不可用。
你也可以在主 TUI 中按 Ctrl+O，不開啟斜槓命令選單也能複製最近一次已完成回覆。
用 /raw 切換原始滾動回看
- 輸入
/raw、/raw on或/raw off。
預期結果：Codex 會切換原始滾動回看（raw scrollback）模式，讓終端選中和複製更直接。你也可以使用預設 Alt+R 繫結，或通過 tui.raw_output_mode = true 持久化預設值。
用 /sandbox-add-read-dir 授予沙箱讀權限
這個命令只在 Windows 原生 CLI 中可用。
- 輸入
/sandbox-add-read-dir C:\absolute\directory\path並按 Enter。 - 確認該路徑是一個存在的絕對目錄。
預期結果：Codex 會重新整理 Windows 沙箱策略，併為後續在沙箱中執行的命令授予該目錄的讀權限。
用 /status 檢視當前會話
- 在任意對話中輸入
/status。 - 檢視輸出中的當前模型、審批策略、可寫根目錄和 token 使用情況。TUI 遠端連線時，輸出還會顯示遠端地址和服務端版本。
預期結果：Codex 會列印摘要，用來確認它正在你預期的位置和設定下執行。
用 /usage 檢視賬戶用量
- 輸入
/usage開啟用量選單。 - 選擇檢視 token 活動，或使用可用的 earned reset。
- 若要直接開啟 token 活動檢視，可以輸入
/usage daily、/usage weekly或/usage cumulative。
預期結果：Codex 會開啟用量動作，或展示所選檢視下的賬戶 token 活動。如果當前 session 沒有 Codex service account auth，Codex 會提示需要登入。
用 /debug-config 檢視設定層
- 輸入
/debug-config。 - 檢視輸出中的設定層順序、啟用狀態和策略來源。
預期結果：Codex 會列印各層設定診斷，以及策略細節，例如 allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency 和 experimental_network（若已設定）。
當某個生效設定與你在 config.toml 中看到的不一致時，這份輸出很適合拿來排查原因。
用 /statusline 設定底部狀態列專案
- 輸入
/statusline。 - 用選擇器切換並重排專案，然後確認。
預期結果：底部狀態列會立刻更新，並把設定持久寫入 config.toml 中的 tui.status_line。
可顯示的狀態列項包括 model、model+reasoning、context 統計、rate limits、Git branch、token 計數、session id、當前目錄 / 專案根，以及 Codex 版本。
用 /title 設定終端標題項
- 輸入
/title。 - 用選擇器切換並重排專案，然後確認。
預期結果：終端視窗或標籤標題會立刻更新，並把設定持久寫入 config.toml 中的 tui.terminal_title。
可顯示的標題項包括 app 名稱、專案、載入指示器、狀態、對話執行緒、Git 分支、模型和任務進度。
用 /theme 選擇語法主題
- 輸入
/theme。 - 從選擇器中預覽主題，然後確認。
預期結果：Codex 會更新語法高亮，並把選擇持久寫入 config.toml 中的 tui.theme。
用 /pets 選擇終端寵物
- 輸入
/pets（或/pet）開啟寵物選擇器。 - 選擇內建或自定義寵物，也可以關閉寵物顯示。
預期結果：Codex 會在支援的終端中顯示所選環境寵物，並持久儲存該選擇。你也可以輸入 /pets off 將其隱藏。
用 /keymap 重新對映 TUI 快捷鍵
使用 /keymap 可以檢視、更新並持久儲存 TUI 的快捷鍵繫結。
- 輸入
/keymap。 - 選擇要修改的快捷鍵 context 和 action。
- 輸入新的繫結，或移除現有繫結。
預期結果：Codex 會更新當前 keymap，並把自定義繫結寫入 config.toml 中的 tui.keymap。
快捷鍵繫結使用 ctrl-a、shift-enter、page-down 這類名稱。特定上下文的繫結會覆蓋 tui.keymap.global；空繫結列表表示解除該動作繫結。
用 /ps 檢視後臺終端
- 輸入
/ps。 - 檢視後臺終端列表及其狀態。
預期結果：Codex 會展示每個後臺終端的命令，以及最多三行最近、非空輸出，方便你快速判斷進度。
只有在啟用了 unified_exec 時才會出現後臺終端；否則列表可能為空。
用 /stop 停止後臺終端
- 輸入
/stop。 - 如果 Codex 在停止前要求確認，就按提示確認。
預期結果：Codex 會停止當前會話中的所有後臺終端。/clean 仍可作為 /stop 的別名使用。
用 /compact 精簡對話記錄
- 在一次較長的對話後輸入
/compact。 - 當 Codex 提示是否要總結當前對話時，確認即可。
預期結果：Codex 會用一段簡潔摘要替換較早的會話輪次，在保留關鍵細節的同時釋放上下文。
用 /diff 審查改動
- 輸入
/diff檢視 Git diff。 - 在 CLI 內滾動輸出，審查改動和新增檔案。
預期結果：Codex 會顯示已暫存的改動、未暫存的改動，以及 Git 尚未開始追蹤的檔案，幫助你決定要保留什麼。
用 /mention 高亮檔案
- 輸入
/mention後跟路徑，例如/mention src/lib/api.ts。 - 從彈出選單中選擇匹配結果。
預期結果：Codex 會把該檔案加入當前對話，使後續會話輪次能直接引用它。
用 /new 開啟新對話
- 輸入
/new並按 Enter。
預期結果：Codex 會在同一個 CLI 會話中開啟一個全新對話，讓你無需退出終端就能切換到另一項任務。
若要在建立時為新對話命名，請執行 /new bug bash。
與 /clear 不同，/new 不會先清空當前終端顯示。
用 /rename 重新命名當前聊天
- 輸入
/rename <name>；也可以只輸入/rename，開啟命名提示。 - 輸入一個便於日後找到該聊天的簡短名稱。
預期結果：Codex 會更新已儲存的聊天名稱，但不會更改 transcript。
用 /resume 恢復已儲存對話
- 輸入
/resume並按 Enter。 - 從儲存的會話選擇器中選中你要恢復的對話。
預期結果：Codex 會載入你所選對話的完整記錄，讓你從原來的進度繼續，而不會丟掉歷史內容。
用 /fork 分叉當前對話
- 輸入
/fork並按 Enter。
預期結果：Codex 會把當前對話複製成一個帶有新 ID 的對話執行緒，原始對話記錄保持不變，因此你可以並行探索另一種方案。
如果你要 fork 的不是當前對話，而是某個已儲存 session，請在終端中執行 codex fork，開啟 session picker。
用 /app 在桌面 App 中繼續
在 macOS 和 Windows 上，輸入 /app 可在 ChatGPT 桌面 App 中開啟當前 session。如果 App 尚未安裝或沒有執行，Codex 會顯示錯誤，提示你安裝或啟動它。
預期結果：桌面 App 會開啟同一個已儲存的聊天，你可以在那裡繼續。
用 /side 啟動側邊會話（side conversation）
使用 /side 可以從當前對話啟動一個臨時分叉，而不離開主任務。
- 輸入
/side開啟側邊會話。 - 也可以附帶行內文本，例如
/side Check whether this plan has an obvious risk。 - 這個聚焦插曲結束後，返回父對話執行緒。
預期結果：Codex 會開啟一個轉錄記錄與父對話執行緒分離的側邊會話。處於側邊模式時，TUI 仍會顯示父對話執行緒狀態，方便你確認主任務是否仍在執行。
/side 不能在另一個側邊會話內使用，也不能在審查模式中使用。
用 /init 生成 AGENTS.md
- 在你希望 Codex 查詢長期指令的目錄中執行
/init。 - 檢視生成的
AGENTS.md，再按儲存庫約定繼續編輯。
預期結果：Codex 會建立一個可繼續完善並提交、供後續會話使用的 AGENTS.md 骨架。
用 /review 審查工作樹
- 輸入
/review。 - 如果你還想檢視精確的檔案改動，可繼續執行
/diff。
預期結果：Codex 會總結它在當前工作樹中發現的問題，重點關注行為變化與缺失測試。預設使用當前 session 的 model，除非你在 config.toml 中單獨設定了 review_model。
用 /mcp 列出 MCP 工具
- 輸入
/mcp。 - 檢視列表，確認當前有哪些 MCP server 和工具可用。
預期結果：你會看到當前會話中 Codex 可呼叫的 MCP 工具列表。
使用 /mcp verbose 可以包含詳細的服務端診斷資訊。如果傳入的參數不是 verbose，Codex 會顯示命令用法。
用 /apps 瀏覽 Apps
- 輸入
/apps。 - 從列表中選擇一個 App。
預期結果：Codex 會把 App mention 以 $app-slug 的形式插入輸入框，這樣你就可以立刻要求 Codex 呼叫它。
用 /plugins 瀏覽外掛
- 輸入
/plugins。 - 選擇一個外掛市場標籤頁，然後選中某個外掛，檢視它的能力或可用動作。
預期結果：Codex 會開啟外掛瀏覽器，讓你檢視已安裝外掛、當前設定允許發現的外掛，以及已安裝外掛狀態。在已安裝外掛上按 Space 可以切換它的啟用狀態。
用 /hooks 檢視和管理生命週期 hooks
- 輸入
/hooks。 - 檢視當前會話中已載入的生命週期 hook 設定。
預期結果：Codex 會顯示當前會話可執行的 hooks。
用 /agent 切換智能體對話執行緒
- 輸入
/agent並按 Enter。 - 從選擇器中選中你要檢視或繼續的對話執行緒。
預期結果：Codex 會切換當前啟用對話執行緒，讓你檢視或繼續該智能體的工作。
用 /feedback 傳送回饋
- 輸入
/feedback並按 Enter。 - 按提示選擇是否附帶日誌或其他診斷資訊。
預期結果：Codex 會收集所需診斷資訊，並把它提交給維護團隊。
用 /logout 退出登入
- 輸入
/logout並按 Enter。
預期結果：Codex 會清除當前使用者會話在本機儲存的憑據。
用 /quit 或 /exit 退出 CLI
- 輸入
/quit或/exit並按 Enter。
預期結果：Codex 會立即退出。退出前請先儲存或提交重要工作。
IDE 擴充套件命令
你可以通過 VS Code 的 Command Palette（命令面板）呼叫這些命令來控制 Codex，也可以把它們繫結到快捷鍵。
分配快捷鍵
- 開啟 Command Palette：macOS 使用 Cmd+Shift+P，Windows / Linux 使用 Ctrl+Shift+P。
- 執行 Preferences: Open Keyboard Shortcuts。
- 搜尋
Codex或命令 ID，例如chatgpt.newChat。 - 選擇鉛筆圖示，然後輸入所需快捷鍵。
擴充套件命令
| 命令 | 預設快捷鍵 | 說明 |
|---|---|---|
chatgpt.addToThread |
- | 將選中的文本範圍作為上下文加入當前聊天 |
chatgpt.addFileToThread |
- | 將整個檔案作為上下文加入當前聊天 |
chatgpt.newChat |
macOS: Cmd+N Windows / Linux: Ctrl+N |
建立新聊天 |
chatgpt.newCodexPanel |
- | 建立新的 Codex 面板 |
chatgpt.openCommandMenu |
- | 開啟 Codex 命令選單 |
chatgpt.openSidebar |
- | 開啟 Codex 側邊欄面板 |
IDE 擴充套件斜槓命令
斜槓命令讓你無需離開輸入框即可控制 Codex，用於檢查狀態、切換本機或雲端模式，以及傳送回饋。
使用斜槓命令
- 在 Codex 輸入框中鍵入
/。 - 從列表中選擇命令，或繼續輸入進行篩選，例如
/status。 - 按 Enter。
可用的斜槓命令
| 斜槓命令 | 說明 |
|---|---|
/approve |
自動審查啟用時，核准一次最近被拒操作的重試。 |
/cloud |
雲端執行可用時，在雲端執行聊天。 |
/cloud-environment |
為聊天選擇雲端環境。 |
/compact |
壓縮當前聊天的上下文。 |
/fast |
可用時開啟或關閉 catalog 提供的 Fast service tier。 |
/feedback |
開啟回饋對話方塊，可選擇附帶日誌。 |
/fork |
將本機聊天複製為新的本機聊天。 |
/goal |
設定一個讓 Codex 持續推進的目標。 |
/ide-context |
開啟或關閉自動 IDE 上下文。 |
/init |
為當前專案生成 AGENTS.md 框架。 |
/local |
在本機工作區中執行聊天。 |
/mcp |
開啟 MCP 狀態並檢視已連線的 server。 |
/memories |
設定 Memories 可用時，是否允許聊天使用或生成記憶。 |
/model |
為當前聊天選擇模型。 |
/personality |
當前模型支援時，選擇 Codex 的回應風格。 |
/plan |
切換計劃模式。 |
/project |
為新聊天選擇專案。 |
/reasoning |
為當前聊天選擇推理強度。 |
/review |
啟動程式碼審查模式。 |
/side |
啟動臨時 side chat，不中斷主聊天。 |
/status |
顯示聊天 ID、上下文用量與速率限制。 |
/worktree |
在新的 Git 工作樹中執行聊天。 |