開發者命令
開發者命令
ChatGPT 桌面應用、Codex CLI 和 Codex IDE 擴充套件的命令與斜槓命令參考。
ChatGPT 網頁版命令
ChatGPT 網頁版有自己的輸入框命令選單。輸入 / 可檢視當前聊天中
可用的操作。它不提供 ChatGPT 桌面應用或 CLI
命令集；本參考中的 Codex 斜槓命令、CLI 子命令和標誌
不適用於 ChatGPT 網頁版。
ChatGPT 桌面應用命令
通用的命令頁面涵蓋應用導航、 聊天快捷鍵、鍵盤自定義，以及聊天、設定、 技能、計劃任務、外掛和寵物的深層連結。
斜槓命令頁面介紹輸入框中
可用的命令，包括 /feedback、/goal、/init、
/mcp、/plan、/review 和 /status。
Codex CLI 命令參考
如何閱讀本參考
本頁面列出了所有已記錄的 Codex CLI 命令和標誌。使用互動式表格可按鍵名或說明搜尋。每個部分都會指出選項是穩定功能還是實驗性功能，並特別說明有風險的組合。
全域標誌
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--add-dir |
path |
除主工作區外，再授予其他目錄寫入權限。可重複使用以指定多個路徑。 |
--ask-for-approval, -a |
untrusted | on-request | never |
控制 Codex 在執行命令前何時暫停並請求人工核准。 |
--cd, -C |
path |
設定智能體開始處理請求前的工作目錄。 |
--config, -c |
key=value |
覆蓋設定值。可以解析為 TOML 時按 TOML 解析，否則使用原始字串。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
執行所有命令時跳過核准和沙箱。僅可在經過外部強化的環境中使用。 |
--dangerously-bypass-hook-trust |
boolean |
在本次呼叫中執行已啟用的鉤子，無需持久儲存鉤子信任。僅適用於已審查鉤子來源的自動化流程。 |
--disable |
feature |
強制停用功能標誌（轉換為 -c features.<name>=false）。可重複使用。 |
--enable |
feature |
強制啟用功能標誌（轉換為 -c features.<name>=true）。可重複使用。 |
--image, -i |
path[,path...] |
將一個或多個圖片檔案附加到初始提示詞。多個路徑可用逗號分隔，也可重複使用該標誌。 |
--local-provider |
lmstudio | ollama |
選擇與 --oss 搭配使用的本機供應商，並在本次執行中覆蓋 oss_provider。 |
--model, -m |
string |
覆蓋設定中設定的模型（例如 gpt-5.6-terra）。 |
--no-alt-screen |
boolean |
停用 TUI 的備用螢幕模式（在本次執行中覆蓋 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 套接字連線遠端 app-server 端點。codex、codex resume、codex fork、codex archive、codex delete 和 codex unarchive 支援此功能；其他子命令會拒絕遠端模式。 |
--remote-auth-token-env |
ENV_VAR |
從此環境變數讀取持有者令牌，並在通過 --remote 連線時傳送。需要 --remote；令牌僅通過 wss:// URL 或僅限本機的 ws:// URL 傳送。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
選擇模型生成的 shell 命令所採用的沙箱策略。 |
--search |
boolean |
啟用即時網頁搜尋（設定 web_search = "live"，而非預設的 "cached"）。 |
--strict-config |
boolean |
當 config.toml 包含此 Codex 版本無法識別的欄位時報錯。codex、exec、review、resume、fork、app-server、mcp-server 和 exec-server 等執行時命令支援此功能。 |
PROMPT |
string |
用於啟動會話的可選文本指令。省略時將啟動 TUI，且不預填訊息。 |
這些選項適用於基礎 codex 命令。大多數選項會傳播到其他命令；
例外情況請參閱上面的說明或相關命令的幫助。對於傳播的
標誌，請遵循相關命令的幫助。例如，codex exec --oss ...
會將 --oss 應用於 exec。
命令概覽
| 鍵 | 成熟度 | 詳情 |
|---|---|---|
codex |
穩定 | 啟動終端介面。接受上述全域標誌，以及可選的提示詞或圖片附件。 |
codex app |
穩定 | 在 macOS 或 Windows 上啟動 ChatGPT 桌面應用。在 macOS 上，Codex 可以開啟工作區路徑；在 Windows 上，Codex 會輸出要開啟的路徑。 |
codex app-server |
實驗性 | 啟動 Codex app server，以便通過 stdio、WebSocket 或 Unix 套接字進行本機開發或除錯。 |
codex apply |
穩定 | 將 Codex 雲端聊天生成的最新差異應用到本機工作樹。別名：codex a。 |
codex archive |
穩定 | 按會話 ID 或會話名稱歸檔已儲存的互動式會話。 |
codex cloud |
實驗性 | 無需開啟 TUI，即可從終端瀏覽或執行 Codex 雲端聊天。別名：codex cloud-tasks。 |
codex completion |
穩定 | 為 Bash、Zsh、Fish 或 PowerShell 生成 shell 補全指令碼。 |
codex debug app-server send-message-v2 |
實驗性 | 通過內建測試客戶端傳送一條 V2 訊息來除錯 app-server。 |
codex debug models |
實驗性 | 輸出 Codex 所看到的原始模型目錄，並可選擇僅檢查內建目錄。 |
codex debug prompt-input |
實驗性 | 將模型可見的提示詞輸入列表呈現為 JSON，可選擇附帶提示詞和圖片。 |
codex delete |
穩定 | 按會話 ID 或會話名稱永久刪除已儲存的互動式會話。 |
codex doctor |
穩定 | 針對本機安裝、設定、身份驗證、執行時、Git、終端、app-server 和執行緒清單問題生成診斷報告。 |
codex exec |
穩定 | 以非互動方式執行 Codex。別名：codex e。將結果流式傳輸到 stdout 或 JSONL，並可選擇恢復之前的會話。 |
codex execpolicy |
實驗性 | 評估 execpolicy 規則檔案，檢視命令會被允許、要求確認還是阻止。 |
codex features |
穩定 | 列出功能標誌，並在 config.toml 中持久啟用或停用它們。 |
codex fork |
穩定 | 將之前的互動式會話分叉為新聊天，同時保留原始對話記錄。 |
codex login |
穩定 | 使用 ChatGPT OAuth、裝置身份驗證、API key 或通過 stdin 傳入的存取令牌對 Codex 進行身份驗證。 |
codex logout |
穩定 | 刪除已儲存的身份驗證憑據。 |
codex mcp |
穩定 | 管理 Model Context Protocol 伺服器（列出、新增、刪除、身份驗證）。 |
codex mcp-server |
已棄用 | 通過 stdio 將 Codex 作為 MCP server 執行的已棄用介面。請改用 Codex app server。若要在 Claude Code 中呼叫 Codex，請使用 Codex plugin for Claude Code。 |
codex plugin |
穩定 | 從已設定的市場源安裝、列出和刪除外掛。 |
codex plugin marketplace |
穩定 | 從 Git 或本機源新增、列出、升級或刪除外掛市場。 |
codex remote-control |
實驗性 | 執行或管理本機 app-server 的遠端控制，或建立短期有效的配對碼。 |
codex resume |
穩定 | 按 ID 繼續之前的互動式會話，或恢復最近的聊天。 |
codex review |
穩定 | 以非互動方式審查未提交的更改、相對於基礎分支的差異、某次提交或自定義審查指令。 |
codex sandbox |
穩定 | 在 Codex 提供的 macOS、Linux 或 Windows 沙箱內執行任意命令。 |
codex unarchive |
穩定 | 按會話 ID 或會話名稱恢復已歸檔的互動式會話。 |
codex update |
穩定 | 當已安裝版本支援自更新時，檢查並應用 Codex CLI 更新。 |
命令詳情
codex（互動式）
不帶子命令執行 codex 會啟動互動式終端介面（TUI）。智能體接受上述全域標誌和圖片附件。網頁搜尋預設為快取模式；使用 --search 可切換到即時瀏覽。若要順暢地處理本機工作，請使用 --sandbox workspace-write --ask-for-approval on-request。
使用 --remote ws://host:port 或 --remote wss://host:port 將 TUI 連線到通過 codex app-server --listen ws://IP:PORT 啟動的 app server。對於本機 Unix 套接字，使用 --remote unix:// 連線預設套接字，或使用 --remote unix://PATH 指定明確路徑。當伺服器要求通過持有者令牌進行 WebSocket 身份驗證時，請新增 --remote-auth-token-env <ENV_VAR>。
codex app-server
在本機啟動 Codex app server。此功能主要用於開發和除錯，可能會隨時更改，恕不另行通知。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--analytics-default-enabled |
boolean |
對第一方 app-server 客戶端預設啟用分析，除非使用者在設定中選擇退出。 |
--listen |
stdio:// | ws://IP:PORT | unix:// | unix://PATH | off |
傳輸監聽器 URL。使用 stdio:// 處理 JSONL，使用 ws://IP:PORT 指定 TCP WebSocket 端點，使用 unix:// 指定預設 Unix 套接字，使用 unix://PATH 指定自定義 Unix 套接字，或使用 off 停用本機傳輸。 |
--stdio |
boolean |
使用 stdio 傳輸。等同於 --listen stdio://，並與 --listen 互斥。 |
--ws-audience |
string |
簽名持有者令牌預期的 aud 宣告。需要 --ws-auth signed-bearer-token。 |
--ws-auth |
capability-token | signed-bearer-token |
app-server WebSocket 客戶端的身份驗證模式。省略時會停用 WebSocket 身份驗證；非本機監聽器將在啟動期間發出警告。 |
--ws-issuer |
string |
簽名持有者令牌預期的 iss 宣告。需要 --ws-auth signed-bearer-token。 |
--ws-max-clock-skew-seconds |
number |
驗證簽名持有者令牌的 exp 和 nbf 宣告時允許的時鐘偏差。需要 --ws-auth signed-bearer-token。 |
--ws-shared-secret-file |
absolute path |
包含用於驗證簽名 JWT 持有者令牌的 HMAC 共享金鑰的檔案。與 --ws-auth signed-bearer-token 搭配使用時必需。 |
--ws-token-file |
absolute path |
包含共享能力令牌的檔案。與 --ws-auth capability-token 搭配使用，除非改為提供 --ws-token-sha256。 |
--ws-token-sha256 |
hexadecimal SHA-256 digest |
能力令牌身份驗證預期的 SHA-256 摘要。當客戶端令牌來自其他來源時，用它代替 --ws-token-file。 |
codex app-server --listen stdio:// 保留預設的基於 stdio 的 JSONL 行為，codex app-server --stdio 是該傳輸方式的別名。--listen ws://IP:PORT 為 app-server 客戶端啟用 WebSocket 傳輸。伺服器接受 ws:// 監聽 URL；當客戶端通過 wss:// 連線時，請使用 TLS 終止或安全代理。使用 --listen unix:// 可在 Codex 的預設 Unix 套接字上接受 WebSocket 握手，使用 --listen unix:///absolute/path.sock 可選擇套接字路徑。如果要為客戶端繫結生成 schema，請新增 --experimental 以包含受限欄位和方法。
新增 --code-mode-host wss://code-mode.example.com/host 可將 app-server 連線到
遠端 Code Mode 主機，而不是啟動本機主機。此出站
連線獨立於 --listen，並由 app-server 程序中的每個執行緒
共享。ws:// 僅可用於 localhost 或通過 SSH 轉發的主機。
codex remote-control
執行 codex remote-control 可在前臺啟動遠端控制。使用
codex remote-control start 可啟動已啟用遠端
控制的本機 app-server 守護程序，使用 codex remote-control stop 可將其停止。託管的
遠端控制客戶端和 SSH 遠端工作流程會使用這些命令；當你要建置本機
協議客戶端時，它們不能替代 codex app-server --listen。
守護程序執行後，使用 codex remote-control pair 建立並
輸出短期有效的手動配對碼。將 --json 新增到任何遠端控制
命令可獲得機器可讀輸出。對於 pair，JSON 響應包含
pairingCode、manualPairingCode、environmentId 和 expiresAt。
codex app
從終端在 macOS 或 Windows 上啟動 ChatGPT 桌面應用。在 macOS 上， Codex 可以開啟指定的工作區路徑；在 Windows 上，Codex 會輸出要 開啟的路徑。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--download-url |
url |
安裝期間使用的 ChatGPT 桌面應用安裝程式 URL 的高階覆蓋項。 |
PATH |
path |
ChatGPT 桌面應用的工作區路徑。在 macOS 上，Codex 會開啟此路徑；在 Windows 上，Codex 會輸出此路徑。 |
codex app 會開啟已安裝的 ChatGPT 桌面應用；如果應用不存在，
則啟動安裝程式。在 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 所看到的原始模型目錄。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--bundled |
boolean |
跳過重新整理，僅輸出當前 Codex 二進位制檔案內建的模型目錄。 |
如果只想檢查當前二進位制檔案內建的目錄，而不從遠端模型端點重新整理，請使用 --bundled。
codex debug prompt-input
將模型實際可見的提示詞輸入列表呈現為 JSON。可在 除錯指令發現、會話上下文或提示詞構造時使用此命令。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--image, -i |
path[,path...] |
將一張或多張圖片附加到使用者提示詞。多個路徑可用逗號分隔，也可重複使用該標誌。 |
PROMPT |
string |
追加到會話上下文之後的可選使用者提示詞。 |
codex apply
將 Codex 雲端聊天中的最新差異應用到本機儲存庫。你必須完成身份驗證並擁有該聊天的存取權限。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
TASK_ID |
string |
要應用其差異的 Codex 雲端聊天識別符。 |
Codex 會輸出已修補的檔案；如果 git apply 失敗（例如發生衝突），則以非零狀態退出。
codex review
以非互動方式執行程式碼審查。請恰好選擇一個審查目標，或將 自定義審查指令作為提示詞傳入。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--base |
branch |
審查相對於指定基礎分支的更改。 |
--commit |
SHA |
審查指定提交引入的更改。 |
--strict-config |
boolean |
當 config.toml 包含此 Codex 版本無法識別的欄位時報錯。 |
--title |
string |
設定審查摘要中顯示的提交標題。需要 --commit。 |
--uncommitted |
boolean |
審查已暫存、未暫存和未跟蹤的更改。 |
PROMPT |
string | - (read stdin) |
自定義審查指令。使用 - 可從 stdin 讀取指令。 |
--uncommitted、--base、--commit 和自定義 PROMPT 彼此
衝突。--title 只能與 --commit 搭配使用。
codex archive 和 codex unarchive
按會話 ID 或會話名稱歸檔或恢復已儲存的互動式會話。 如果你想整理會話選擇器但不刪除 對話記錄，請使用這些命令。會話 ID 的優先順序高於會話名稱。
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 要求身份驗證時，從此環境變數讀取持有者令牌。 |
SESSION |
session ID | session name |
要歸檔或恢復的已儲存會話。會話 ID 的優先順序高於會話名稱。 |
codex delete
按會話 ID 或會話名稱永久刪除已儲存的互動式會話。 僅當你想刪除對話記錄，而不是將其從 活動會話列表中隱藏時，才使用此命令。
codex delete <SESSION>
codex delete <SESSION_UUID> --force| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--force |
boolean |
不提示直接刪除。會話參數必須是 UUID；使用名稱時仍需互動式確認。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
刪除會話前連線到遠端 app-server 端點。 |
--remote-auth-token-env |
ENV_VAR |
當 --remote 要求身份驗證時，從此環境變數讀取持有者令牌。 |
SESSION |
session ID | session name |
要刪除的已儲存會話。會話 ID 的優先順序高於會話名稱。 |
--force 只能與會話 UUID 搭配使用。使用名稱的會話仍需
確認，以免 Codex 未經提示就刪除重名或含義不明確的名稱。
codex cloud
從終端與 Codex 雲端聊天互動。預設命令會開啟互動式選擇器；codex cloud exec 會直接提交任務，codex cloud list 會傳回最近的聊天，供指令碼處理或快速檢查。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--attempts |
1-4 |
Codex 雲端應執行的助手嘗試次數（best-of-N）。 |
--env |
ENV_ID |
目標 Codex 雲端環境識別符（必需）。使用 codex cloud 可列出選項。 |
QUERY |
string |
任務提示詞。如果省略，Codex 會以互動方式提示你提供詳細資訊。 |
身份驗證使用與主 CLI 相同的憑據。如果任務提交失敗，Codex 將以非零狀態退出。
codex cloud list
列出最近的雲端聊天，可選擇進行篩選和分頁。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--cursor |
string |
上一次請求傳回的分頁游標。 |
--env |
ENV_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 補全指令碼並將輸出重定向到適當位置，例如 codex completion zsh > "${fpath[1]}/_codex"。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
SHELL |
bash | zsh | fish | power-shell | elvish |
要為其生成補全的 shell。輸出將寫入 stdout。 |
codex doctor
在提交支援問題之前或 調查損壞的 Codex 安裝時，生成本機診斷報告。該報告會檢查安裝、 設定、身份驗證、執行時、Git、終端、app-server 和執行緒 清單的健康狀況。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--all |
boolean |
在詳細的可讀報告中展開長列表。 |
--ascii |
boolean |
在可讀輸出中使用 ASCII 狀態標籤和分隔符。 |
--json |
boolean |
輸出經過脫敏的機器可讀支援報告。 |
--no-color |
boolean |
在可讀輸出中停用 ANSI 顏色。 |
--summary |
boolean |
僅顯示分組的檢查行和最終計數摘要。 |
codex features
管理儲存在 $CODEX_HOME/config.toml 中的功能標誌。enable 和
disable 命令會持久儲存更改，使其應用於未來會話。
features 子命令不接受 --profile。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
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 |
在本次呼叫中執行已啟用的鉤子，無需持久儲存鉤子信任。僅適用於已審查鉤子來源的自動化流程。 |
--ephemeral |
boolean |
執行時不將會話 rollout 檔案持久儲存到磁碟。 |
--full-auto |
boolean |
已棄用的相容性標誌。請優先使用 --sandbox workspace-write；使用此標誌時 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 |
在本次執行中覆蓋已設定的模型。 |
--oss |
boolean |
使用本機開源供應商。Codex 會使用 --local-provider 或你設定的 oss_provider；如果兩者均未設定，則報錯退出。 |
--output-last-message, -o |
path |
將助手的最終訊息寫入檔案。適用於下游指令碼處理。 |
--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 | session name |
恢復指定會話。省略該參數並使用 --last 可繼續最近的會話。 |
codex execpolicy
儲存 execpolicy 規則檔案前對其進行檢查。codex execpolicy check 接受一個或多個 --rules 標誌（例如 ~/.codex/rules 下的檔案），並輸出 JSON，其中會顯示最嚴格的決策及所有匹配的規則。新增 --pretty 可格式化輸出。execpolicy 命令目前處於預覽階段。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--pretty |
boolean |
美化輸出 JSON 結果。 |
--rules, -r |
path (repeatable) |
要評估的 execpolicy 規則檔案路徑。提供多個標誌可合並多個檔案中的規則。 |
COMMAND... |
var-args |
要依據指定策略進行檢查的命令。 |
codex login
使用 ChatGPT 帳戶、API key 或存取令牌對 CLI 進行身份驗證。不帶標誌時，Codex 會開啟瀏覽器並啟動 ChatGPT OAuth 流程。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--device-auth |
boolean |
使用 OAuth 裝置程式碼流程，而不是啟動瀏覽器視窗。 |
--with-access-token |
boolean |
從 stdin 讀取存取令牌（例如 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 身份驗證的已儲存憑據。此命令沒有標誌。
codex mcp
管理儲存在 ~/.codex/config.toml 中的 Model Context Protocol 伺服器條目。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
add <name> |
-- <command...> | --url <value> |
使用 stdio 啟動器命令或可流式傳輸的 HTTP URL 註冊伺服器。stdio 傳輸支援 --env KEY=VALUE。 |
get <name> |
--json |
顯示指定伺服器的設定。--json 會輸出原始設定條目。 |
list |
--json |
列出已設定的 MCP 伺服器。新增 --json 可獲得機器可讀輸出。 |
login <name> |
--scopes scope1,scope2 |
為可流式傳輸的 HTTP 伺服器啟動 OAuth 登入（僅限支援 OAuth 的伺服器）。 |
logout <name> |
刪除可流式傳輸的 HTTP 伺服器已儲存的 OAuth 憑據。 | |
remove <name> |
刪除已儲存的 MCP 伺服器定義。 |
add 子命令同時支援 stdio 和可流式傳輸的 HTTP 傳輸：
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
連線可流式傳輸的 HTTP 伺服器時，其值將作為持有者令牌傳送的環境變數。 |
--env KEY=VALUE |
repeatable |
啟動 stdio 伺服器時應用的環境變數賦值。 |
--oauth-client-id |
CLIENT_ID |
可流式傳輸的 HTTP MCP 伺服器的 OAuth 客戶端識別符。需要 --url。 |
--oauth-resource |
RESOURCE |
登入可流式傳輸的 HTTP MCP 伺服器時要包含的 OAuth resource 參數。需要 --url。 |
--url |
https://… |
註冊可流式傳輸的 HTTP 伺服器，而不是 stdio 伺服器。與 COMMAND... 互斥。 |
COMMAND... |
stdio transport |
用於啟動 MCP 伺服器的執行檔及參數。請在 -- 之後提供。 |
OAuth 操作（login、logout）僅適用於可流式傳輸的 HTTP 伺服器（且僅限伺服器支援 OAuth 時）。
codex plugin
從已設定的市場安裝、列出和刪除外掛。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
add <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
從已設定的市場安裝外掛。當外掛參數省略 @marketplace 時，使用 --marketplace 或 -m。 |
list |
[--marketplace, -m NAME] [--available --json] [--json] |
列出已安裝的外掛。使用 --json 時，輸出包含 installed 和 available 陣列；--available 會包含市場中未安裝的外掛，並且需要 --json。 |
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。
codex plugin remove --json 會輸出
pluginId、name 和 marketplaceName。
codex plugin marketplace
管理 Codex 可以瀏覽並從中安裝外掛的外掛市場源。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
add <source> |
[--ref REF] [--sparse PATH] [--json] |
從 GitHub 簡寫、Git URL、SSH URL 或本機市場根目錄安裝外掛市場。--sparse 僅支援 Git 源，並可重複使用。 |
list |
[--json] |
顯示 Codex 當前考慮的外掛市場及每個市場的根路徑。 |
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，以及本機市場
根目錄。使用 --ref 可固定 Git ref，重複使用 --sparse PATH 可
對 Git 支援的市場儲存庫使用稀疏檢出。
codex plugin marketplace list 會輸出範圍內的市場名稱和根目錄，
包括隱式發現的預設市場和已設定的市場
快照。
將 --json 新增到市場新增、列出、升級或刪除命令，可獲得
便於自動化處理的輸出。市場新增 JSON 包含 marketplaceName、
installedRoot 和 alreadyAdded；列表 JSON 包含一個 marketplaces 陣列，
其中有 name、root 和可選的 marketplaceSource；升級 JSON 包含
selectedMarketplaces、upgradedRoots 和 errors；刪除 JSON 包含
marketplaceName 和 installedRoot。
codex mcp-server
對於現有整合，該命令會通過 stdio 將 Codex 作為 MCP server 執行，以便其他工具連線。它會繼承全域設定覆蓋項，並在下游客戶端關閉連線時退出。
codex resume
按 ID 繼續互動式會話，或恢復最近的聊天。除非傳入 --all，否則 codex resume 會將 --last 的範圍限定為當前工作目錄。它接受與 codex 相同的全域標誌，包括模型和沙箱覆蓋項。
如果當前工作目錄與會話儲存的目錄不同，
Codex 會詢問要使用哪個目錄。將
tui.resume_cwd 設定為 "current" 或
"session"，可在不提示的情況下複用該選擇。顯式的 --cd（-C）
覆蓋項優先於 tui.resume_cwd。
| 鍵 | 類型/值 | 詳情 |
|---|---|---|
--all |
boolean |
選擇最近的會話時，包含當前工作目錄之外的會話。 |
--include-non-interactive |
boolean |
在選擇器和 --last 選擇中包含非互動式會話。 |
--last |
boolean |
跳過選擇器，恢復當前工作目錄中最近的聊天。 |
SESSION_ID |
uuid | session name |
恢復指定會話。省略該參數並使用 --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 套接字。可重複使用以允許多個路徑。 |
--cd, -C |
DIR |
用於設定檔解析和命令執行的工作目錄。需要 --permission-profile。 |
--config, -c |
key=value |
將設定覆蓋項傳入沙箱執行（可重複使用）。 |
--include-managed-config |
boolean |
解析顯式權限設定檔時包含託管要求。需要 --permission-profile。 |
--log-denials |
boolean |
命令執行時使用 log stream 捕獲 macOS 沙箱拒絕事件，並在退出後輸出。 |
--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 |
解析顯式權限設定檔時包含託管要求。需要 --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 |
解析顯式權限設定檔時包含託管要求。需要 --permission-profile。 |
--permission-profile, -P |
NAME |
應用當前設定棧中的指定權限設定檔。 |
--profile, -p |
NAME |
在基礎使用者設定之上疊加 $CODEX_HOME/NAME.config.toml。 |
COMMAND... |
var-args |
要在原生 Windows 沙箱下執行的命令。請在 -- 之後提供執行檔。 |
codex update
當已安裝版本支援自更新時，檢查並應用 Codex CLI 更新。除錯版本會輸出訊息，提示你改為安裝發布版本。
標誌組合與安全提示
- 對於可限制在工作區內的無人值守本機工作，請使用
--sandbox workspace-write；除非位於專用沙箱虛擬機器內，否則應避免使用--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 命令排入下一輪。
- Codex 工作時按 Enter，可向當前輪次注入新指令。
- 輸入框為空時連續按兩次 Esc，可編輯上一條使用者訊息，並從該處分叉聊天。
- 按 Ctrl+C 或執行
/exit可關閉會話。
相關資源
- Codex CLI 概覽：安裝、升級和快速提示。
- 設定基礎：持久儲存模型和供應商等預設值。
- 高階設定：設定檔、供應商、沙箱調優和整合。
- AGENTS.md：Codex 智能體功能和最佳實踐的概念性概覽。
斜槓命令讓你能夠以鍵盤優先的方式快速控制 Codex。在
輸入框中輸入 / 可開啟斜槓命令彈窗，選擇命令後，Codex 將執行
切換模型、調整權限或總結長對話等操作，
無需離開終端。
本指南將介紹如何：
- 為任務找到合適的內建斜槓命令
- 使用
/model、/fast、/personality、/permissions、/approve、/raw、/agent和/status等命令引導活動會話
Codex CLI 斜槓命令
內建斜槓命令
Codex 隨附以下命令。開啟斜槓命令彈窗並開始輸入 命令名稱，即可篩選列表。
聊天已在執行時，你可以輸入斜槓命令並按 Tab，將其
排入下一輪。Codex 會在執行排隊的斜槓命令時解析它們，因此
命令選單和錯誤會在當前輪次結束後顯示。將命令加入佇列前，斜槓命令
補全仍然有效。
| 命令 | 用途 | 使用時機 |
|---|---|---|
/permissions |
設定 Codex 無需事先詢問即可執行的操作。 | 在會話期間放寬或收緊審批要求，例如在 Auto 和 Read Only 之間切換。 |
/ide |
包含開啟的檔案、當前選擇及其他 IDE 上下文。 | 將編輯器上下文帶入下一個提示，無需再次說明 IDE 中打開了哪些內容。 |
/keymap |
重新對映 TUI 鍵盤快捷鍵。 | 檢查自定義快捷鍵繫結並將其持久化到 config.toml。 |
/vim |
切換輸入框的 Vim 模式。 | 在 Vim 的普通/插入行為與預設輸入框編輯模式之間切換。 |
/setup-default-sandbox |
設定提升權限的智能體沙箱（僅限 Windows）。 | 在 Codex 提供提升權限的設定後，替換功能受限的 Windows 沙箱。 |
/sandbox-add-read-dir |
授予沙箱對額外目錄的讀取權限（僅限 Windows）。 | 當命令需要讀取當前可讀根目錄之外的絕對目錄路徑時解除阻塞。 |
/agent, /subagents |
切換活動智能體執行緒。 | 檢查派生的子智能體執行緒或在其中繼續工作。 |
/apps |
瀏覽應用（連接器）並將其插入提示中。 | 在要求 Codex 使用應用之前，將其以 $app-slug 形式附加。 |
/plugins |
瀏覽已安裝和可發現的外掛。 | 檢查外掛工具、安裝建議的外掛或管理外掛可用性。 |
/hooks |
檢視和管理生命週期鉤子。 | 檢查已設定的鉤子、信任新增或已更改的鉤子，或在非託管鉤子執行前將其停用。 |
/clear |
清空終端並開始新聊天。 | 想要重新開始時，同時重置可見 UI 和聊天上下文。 |
/rename |
重新命名當前聊天。 | 無需離開 TUI，即可為儲存的會話設定一個易於識別的名稱。 |
/archive |
歸檔當前會話並退出 Codex。 | 從活動會話列表中移除當前會話，但不刪除其記錄。 |
/delete |
永久刪除當前會話並退出 Codex。 | 當歸檔仍不夠時，移除記錄及其派生會話。 |
/compact |
總結可見聊天以釋放 token。 | 在長時間執行後使用，讓 Codex 保留要點而不超出上下文視窗。 |
/copy |
複製 Codex 最新完成的輸出。 | 無需手動選擇，即可取得最新完成的回覆或計劃文本。也可以按 Ctrl+O。 |
/diff |
顯示 Git diff，包括 Git 尚未跟蹤的檔案。 | 在提交或執行測試之前檢查 Codex 的編輯。 |
/exit |
退出 CLI（與 /quit 相同）。 |
另一種命令寫法；兩者都會退出會話。 |
/experimental |
切換實驗性功能。 | 啟用 Network proxy 或 Prevent sleep while running 等選項。 |
/approve |
核准重試一次最近被自動審查拒絕的操作。 | 重試被自動審查器拒絕的命令或操作。 |
/memories |
設定記憶的使用和生成。 | 無需離開 TUI 即可開啟或關閉記憶注入或記憶生成。 |
/skills |
瀏覽和使用技能。 | 通過選擇相關的本機技能，改善針對特定任務的行為。 |
/import |
匯入 Claude Code 或 Cursor 的設定、專案和聊天。 | 將支援的外部智能體構件遷移到 Codex 設定和本機檔案中。 |
/feedback |
向 Codex 維護者傳送日誌。 | 報告問題或與支援人員共享診斷資訊。 |
/init |
在當前目錄中生成 AGENTS.md 腳手架。 |
記錄適用於當前儲存庫或子目錄的持久指令。 |
/logout |
退出 Codex 登入。 | 使用共享計算機時清除本機憑據。 |
/mcp |
列出已設定的 Model Context Protocol (MCP) 工具。 | 檢查 Codex 在會話期間可以呼叫哪些外部工具；新增 verbose 可檢視伺服器詳情。 |
/mention |
將檔案附加到聊天。 | 指定希望 Codex 接下來檢查的特定檔案或資料夾。 |
/model |
選擇活動模型（以及可用時的推理強度）。 | 在執行任務前，在 gpt-5.6-luna 和 gpt-5.6-terra 等模型之間切換。 |
/fast |
在模型目錄提供 Fast 服務層級時切換該層級。 | 開啟或關閉當前模型的 Fast 層級，並持久化該選擇。 |
/plan |
切換到計劃模式，並可選擇傳送提示。 | 在開始實施工作之前，讓 Codex 提出執行計劃。 |
/goal |
設定、編輯、暫停、恢復、檢視或清除任務目標。 | 為 Codex 設定一個持久目標，以便在較大任務執行期間持續跟蹤。 |
/personality |
選擇回覆的溝通風格。 | 無需更改指令，即可讓 Codex 更簡潔、更具解釋性或更注重協作。 |
/ps |
顯示後臺終端及其最近的輸出。 | 無需離開主記錄即可檢查長時間執行的命令。 |
/stop |
停止所有後臺終端。 | 取消當前會話啟動的後臺終端工作。 |
/fork |
將當前聊天分叉為新聊天。 | 從活動會話建立分支以探索新方法，同時保留當前記錄。 |
/app |
在 ChatGPT 桌面應用中繼續當前會話。 | 在 macOS 或 Windows 上從 TUI 轉到桌面應用。 |
/side, /btw |
開始臨時側邊聊天。 | 進行聚焦的後續提問，而不打亂主聊天的記錄。 |
/raw |
切換原始回滾緩衝區模式。 | 檢視長輸出時，讓終端中的選擇和複製減少格式化。 |
/resume |
從會話列表恢復已儲存的聊天。 | 從之前的 CLI 會話繼續工作，無需重新開始。 |
/new |
在同一 CLI 會話中開始新聊天。 | 想要在同一儲存庫中使用全新提示時，無需離開 CLI 即可重置聊天上下文。 |
/quit |
退出 CLI。 | 立即離開會話。 |
/review |
讓 Codex 審查你的工作樹。 | 在 Codex 完成工作後執行，或在希望再次檢查本機更改時執行。 |
/status |
顯示會話設定和 token 使用情況。 | 確認活動模型、審批策略、可寫根目錄和剩餘上下文容量。 |
/usage |
檢視帳戶 token 使用情況或使用速率限制重置。 | 在 TUI 中檢查每日、每週或累計的 ChatGPT token 活動。 |
/debug-config |
輸出設定層和要求診斷資訊。 | 除錯優先順序和策略要求，包括實驗性網路約束。 |
/statusline |
以互動方式設定 TUI 狀態行欄位。 | 選擇並重新排列頁尾專案（模型/上下文/限制/git/token/會話），並將其持久化到 config.toml。 |
/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 切換 Fast 模式
- 輸入
/fast，開啟當前模型的 Fast 服務層級。 - 再次輸入
/fast將其關閉。
預期結果：Codex 切換該層級並儲存選擇。在 TUI 頁尾中，
你還可以使用 /statusline 顯示 Fast 模式狀態行專案。
Fast 層級命令由目錄驅動。如果當前模型未宣告支援
Fast 層級，Codex 將不會顯示 /fast。
使用 /personality 設定溝通風格
使用 /personality 更改 Codex 的溝通方式，無需重寫提示。
- 在活動聊天中輸入
/personality，然後按 Enter。 - 從彈出視窗中選擇一種風格。
預期結果：Codex 在記錄中確認新風格，並將其用於聊天中的後續 回覆。
Codex 支援 friendly、pragmatic 和 none 個性。使用 none
可停用個性指令。
如果活動模型不支援個性專用指令，Codex 會隱藏此命令。
使用 /plan 切換到計劃模式
- 輸入
/plan並按 Enter，將活動聊天切換到計劃 模式。 - 可選：提供內聯提示文本（例如
/plan Propose a migration plan for this service）。 - 使用內聯
/plan參數時，可以貼上內容或附加圖片。
預期結果：Codex 進入計劃模式，並將可選的內聯提示用作第一個規劃請求。
Codex 已在工作時，/plan 會暫時不可用。
使用 /goal 設定或檢視任務目標
- 輸入
/goal <objective>設定目標，例如/goal Finish the migration and keep tests green。 - 輸入
/goal檢視當前目標。 - 使用
/goal edit修改目標。使用/goal pause、/goal resume或/goal clear暫停、恢復或移除目標。
預期結果：工作繼續進行時，Codex 會讓該目標始終關聯到活動聊天。
目標內容不得為空，且最多為 4,000 個字元。對於更長的 指令，請將詳細資訊放入檔案，並讓目標指向該檔案。
使用 /experimental 切換實驗性功能
- 輸入
/experimental，然後按 Enter。 - 切換所需功能（例如 Network proxy 或 Prevent sleep while running），如果提示要求，請重啟 Codex。
預期結果：Codex 將功能選擇儲存到設定中，並在重啟後應用。
使用 /approve 核准被自動審查拒絕的操作
當自動審查器拒絕了最近的操作，而你希望 Codex 重試一次時，請使用
/approve。
- 輸入
/approve。 - Codex 顯示相關的被拒操作時，確認重試。
預期結果：Codex 按當前會話策略重試該被拒操作一次。
使用 /memories 設定記憶
- 輸入
/memories。 - 選擇讓 Codex 使用現有記憶、生成新記憶，或 保持停用記憶行為。
預期結果：Codex 更新相關記憶設定，供未來會話使用。
使用 /skills 使用技能
- 輸入
/skills。 - 選擇希望 Codex 應用的技能。
預期結果：Codex 插入所選技能的上下文，使下一個請求遵循 該技能的指令。
使用 /import 匯入 Claude Code 或 Cursor 設定
- 輸入
/import。 - 選擇 Claude Code 或 Cursor。
- 選擇要遷移的設定、專案檔案或最近聊天。
預期結果：Codex 開啟外部智能體匯入選擇器，並將選定的 受支援構件匯入 Codex 設定和本機檔案。會話發現功能 最多包含過去 30 天內的 50 個聊天。
請從本機 TUI 會話執行 /import。任務執行期間、
遠端會話中以及連線到本機 app-server 守護程序時，此功能不可用。
有關桌面應用工作流程和支援的構件類型，請參閱從 其他智能體匯入。
使用 /clear 清空終端並開始新聊天
- 輸入
/clear，然後按 Enter。
預期結果：Codex 清空終端、重置可見記錄，並在 同一 CLI 會話中開始新聊天。
要在建立新聊天時為其命名，請執行 /clear release prep。
與 Ctrl+L 不同，/clear 會開始新聊天。
Ctrl+L 只會清空終端檢視，並保留當前 聊天。任務進行期間，Codex 會停用這兩個操作。
使用 /archive 歸檔當前會話
- 輸入
/archive，然後按 Enter。 - 確認要歸檔當前會話並退出 Codex。
預期結果：Codex 歸檔當前會話並關閉互動式 TUI。
Codex 會將會話記錄儲存在本機；稍後可使用
codex unarchive <SESSION> 將其恢復。
任務執行期間，/archive 不可用。
使用 /delete 刪除當前會話
- 輸入
/delete，然後按 Enter。 - 確認要刪除當前會話並退出 Codex。
預期結果：Codex 刪除當前會話記錄並關閉 互動式 TUI。刪除操作不可撤銷，還會移除派生的後代 會話。
聊天執行期間或處於側邊聊天中時，/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 沙箱
僅當 Codex 在 Windows 上使用功能受限的 受限 token 沙箱時，此命令才會出現。
- 輸入
/setup-default-sandbox。 - 按照管理員設定流程操作。
預期結果：Codex 設定提升權限的 Windows 沙箱，並選擇 對應的自動審批預設。
使用 /copy 複製最新回覆
- 輸入
/copy，然後按 Enter。
預期結果：Codex 將最新完成的 Codex 輸出複製到剪貼簿。
如果某個輪次仍在執行，/copy 會使用最新完成的輸出，而非
正在生成的回覆。在第一個 Codex 輸出完成之前以及回滾後立即執行時，
該命令不可用。
也可以在主 TUI 中按 Ctrl+O，無需開啟斜槓命令選單即可複製 最新完成的回覆。
使用 /raw 切換原始回滾緩衝區
- 輸入
/raw、/raw on或/raw off。
預期結果：Codex 切換原始回滾緩衝區模式，讓終端中的選擇和
複製更直接。也可以使用預設的 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 活動或兌換可用的已賺取重置。
- 要直接開啟 token 活動，請輸入
/usage daily、/usage weekly或/usage cumulative。
預期結果：Codex 開啟用量操作或顯示所選檢視的帳戶 token 活動。 如果會話沒有 Codex 服務帳戶身份驗證，Codex 會顯示登入要求。
使用 /debug-config 檢查設定層
- 輸入
/debug-config。 - 檢視設定層順序（優先順序從低到高）、開關 狀態和策略來源。
預期結果：Codex 輸出設定層診斷資訊，以及設定後出現的
allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules
和 experimental_network 等策略詳情。
使用此輸出除錯有效設定為何與 config.toml 不同。
使用 /statusline 設定頁尾專案
- 輸入
/statusline。 - 使用選擇器切換和重新排列專案，然後確認。
預期結果：頁尾狀態行立即更新，並持久化到
config.toml 中的 tui.status_line。
可用的狀態行專案包括模型、模型+推理、上下文統計資訊、速率 限制、git 分支、token 計數器、會話 id、當前目錄/專案根目錄 和 Codex 版本。
使用 /title 設定終端標題專案
- 輸入
/title。 - 使用選擇器切換和重新排列專案，然後確認。
預期結果：終端視窗或標籤頁標題立即更新，並持久化到
config.toml 中的 tui.terminal_title。
可用的標題專案包括應用名稱、專案、旋轉指示器、狀態、執行緒、git 分支、模型和任務進度。
使用 /theme 選擇語法主題
- 輸入
/theme。 - 從選擇器中預覽主題，然後確認。
預期結果：Codex 更新語法高亮，並將選擇持久化到
config.toml 中的 tui.theme。
使用 /pets 選擇終端寵物
- 輸入
/pets（或/pet）開啟寵物選擇器。 - 選擇內建或自定義寵物，或關閉寵物。
預期結果：Codex 在支援的終端中顯示所選環境寵物，並
持久化該選擇。也可以輸入 /pets off 將其隱藏。
使用 /keymap 重新對映 TUI 快捷鍵
使用 /keymap 檢查、更新並持久化 TUI 的鍵盤快捷鍵繫結。
- 輸入
/keymap。 - 選擇要更改的快捷鍵上下文和操作。
- 輸入新繫結或移除現有繫結。
預期結果：Codex 更新活動鍵位對映，並將自定義繫結寫入 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 更新儲存的聊天名稱，而不更改其記錄。
使用 /resume 恢復已儲存的聊天
- 輸入
/resume，然後按 Enter。 - 從已儲存會話選擇器中選擇所需會話。
預期結果：Codex 重新載入所選聊天的記錄，讓你可以從上次 中斷處繼續，同時完整保留原始歷史記錄。
使用 /fork 分叉當前聊天
- 輸入
/fork，然後按 Enter。
預期結果：Codex 將當前聊天克隆為具有全新 ID 的新聊天，並保留原始記錄不變，讓你可以並行探索另一種 方法。
如果需要分叉已儲存的會話而非當前會話，請在
終端中執行 codex fork 以開啟會話選擇器。
使用 /app 在桌面應用中繼續
在 macOS 和 Windows 上，輸入 /app 可在 ChatGPT
桌面應用中開啟當前會話。如果應用未安裝或未執行，Codex 會顯示錯誤，要求
你安裝或啟動它。
預期結果：桌面應用開啟同一已儲存聊天，讓你可以在那裡繼續。
使用 /side 開始側邊聊天
使用 /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 總結在工作樹中發現的問題，重點關注
行為更改和缺失的測試。除非你在 config.toml 中設定
review_model，否則它會使用當前會話模型。
使用 /mcp 列出 MCP 工具
- 輸入
/mcp。 - 檢視列表，確認有哪些 MCP 伺服器和工具可用。
預期結果：你會看到 Codex 在此會話中可以呼叫的已設定 Model Context Protocol (MCP) 工具。
使用 /mcp verbose 可包含詳細的伺服器診斷資訊。如果傳入 verbose 以外的任何內容，Codex 會顯示命令用法。
使用 /apps 瀏覽應用
- 輸入
/apps。 - 從列表中選擇一個應用。
預期結果：Codex 將應用提及以 $app-slug 形式插入輸入框，
你可以立即要求 Codex 使用它。
使用 /plugins 瀏覽外掛
- 輸入
/plugins。 - 選擇一個市場標籤頁，然後選擇外掛以檢查其功能或可用操作。
預期結果：Codex 開啟外掛瀏覽器，讓你可以檢視已安裝的外掛、 設定允許發現的外掛以及已安裝外掛的狀態。 在已安裝外掛上按 Space 可切換其啟用狀態。
使用 /hooks 檢視和管理生命週期鉤子
- 輸入
/hooks。 - 選擇一個鉤子事件以檢查匹配的處理程序。
- 根據需要信任、停用或重新啟用非託管鉤子。
預期結果：Codex 開啟鉤子瀏覽器，讓你可以檢視已設定的生命週期 鉤子。託管鉤子會顯示為託管狀態，無法從使用者鉤子 瀏覽器中停用。
使用 /agent 切換智能體執行緒
- 輸入
/agent或/subagents，然後按 Enter。 - 從選擇器中選擇所需執行緒。
預期結果：Codex 切換活動執行緒，讓你可以檢查該 智能體的工作或繼續處理。
使用 /feedback 傳送回饋
- 輸入
/feedback，然後按 Enter。 - 按提示選擇是否包含日誌或診斷資訊。
預期結果：Codex 收集請求的診斷資訊並提交給 維護者。
使用 /logout 退出登入
- 輸入
/logout，然後按 Enter。
預期結果：Codex 清除當前使用者會話的本機憑據。
使用 /quit 或 /exit 退出 CLI
- 輸入
/quit（或/exit），然後按 Enter。
預期結果：Codex 立即退出。請先儲存或提交所有重要工作。
IDE 擴充套件命令
使用這些命令可從 VS Code Command Palette 控制 Codex。你也可以為它們繫結鍵盤快捷鍵。
分配鍵繫結
要為 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 |
可用時，開啟或關閉目錄提供的 Fast 服務層級。 |
/feedback |
開啟回饋對話方塊以提交回饋，並可選擇包含日誌。 |
/fork |
將本機聊天複製為新的本機聊天。 |
/goal |
設定一個供 Codex 持續處理的持久目標。 |
/ide-context |
開啟或關閉自動 IDE 上下文。 |
/init |
為當前專案生成 AGENTS.md 腳手架。 |
/local |
在本機工作區中執行聊天。 |
/mcp |
開啟 MCP 狀態以檢視已連線的伺服器。 |
/memories |
Memories 可用時，設定聊天是否可以使用或生成記憶。 |
/model |
選擇當前聊天使用的模型。 |
/personality |
當前模型支援個性時，選擇 Codex 的回覆方式。 |
/plan |
切換用於多步驟規劃的計劃模式。 |
/project |
為新聊天選擇專案。 |
/reasoning |
選擇當前聊天的推理強度。 |
/review |
啟動程式碼審查模式，以審查未提交的更改或與基礎分支比較。 |
/side |
啟動臨時側邊聊天，而不中斷主聊天。 |
/status |
顯示聊天 ID、上下文用量和速率限制。 |
/worktree |
在新的 Git worktree 中執行聊天。 |