---
title: "使用 CLI 斜槓命令"
description: "理解 Codex CLI slash commands 的控制面：會話、模型、許可權、上下文、審查和分支探索。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

> [!NOTE]
> 斜槓命令不是要背的命令表，而是 CLI 的控制面。具體可見命令會隨版本、feature flag、登入狀態和當前任務狀態變化；長期可靠的做法是記住“什麼時候該控制會話、什麼時候該控制許可權、什麼時候該審查結果”。

在 Codex CLI 的 composer 裡輸入 `/`，會開啟 slash command popup。官方 CLI features 文件說明，Codex 的互動模式可以讀儲存庫、改檔案、跑命令，也能用 `/clear`、`/copy`、`/theme` 等命令控制 TUI。執行中按 `Tab` 還可以把後續文本、斜槓命令或 `!` shell 命令排隊到下一輪。

```mermaid
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
```

## 先按用途記

<Cards>
  <Card title="會話控制" description="新開、恢復、壓縮或清空對話，避免上下文無限膨脹。" href="#会话控制" />
  <Card title="許可權控制" description="用 permissions 和 status 確認當前 sandbox、approval、writable roots 和 token 狀態。" href="#权限控制" />
  <Card title="任務控制" description="用 plan、review、diff 把實現、審查和驗證拆開。" href="#任务控制" />
  <Card title="探索控制" description="用 fork、side、agent 探索不同方案或檢視子執行緒工作。" href="#探索控制" />
</Cards>

## 會話控制

這些命令解決“當前對話要不要繼續沿用”的問題：

- `/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 等實際生效來源。

> [!WARNING]
> 如果你不確定 Codex 現在是否能寫檔案、跑命令或聯網，先用 `/status`。不要靠記憶判斷當前許可權，因為 profile、專案級配置和 managed requirements 都可能改變實際行為。

## 任務控制

這些命令把“做事”和“檢查結果”拆開：

- `/plan`：進入 plan mode，適合複雜實現前先出執行方案。
- `/review`：讓 Codex review working tree、commit 或自定義 diff 範圍。
- `/diff`：直接檢視當前 Git diff，包括未跟蹤檔案。
- `/copy`：複製最新完成的 Codex 輸出；也可以用 `Ctrl+O`。

推薦流程：

1. 複雜任務先 `/plan`，不要直接讓 Codex 改。
2. 改完先 `/diff` 看範圍。
3. 再 `/review` 找風險。
4. 最後跑專案測試和構建。

## 探索控制

這些命令適合“同一上下文下臨時分叉”：

- `/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](https://developers.openai.com/codex/cli/features)
- Agent approvals & security：[https://developers.openai.com/codex/agent-approvals-security](https://developers.openai.com/codex/agent-approvals-security)
- Configuration Reference：[https://developers.openai.com/codex/config-reference](https://developers.openai.com/codex/config-reference)

## 接下來去哪

<Cards>
  <Card title="CLI 功能總覽" description="理解 interactive、resume、exec、cloud、MCP、web search 和 approval modes。" href="/zh-Hant/docs/codex/official/01-products/26-cli-features" />
  <Card title="CLI 引數" description="需要指令碼化或啟動時指定模型、路徑、sandbox 時，再查引數頁。" href="/zh-Hant/docs/codex/official/01-products/27-cli-args" />
  <Card title="審批與安全" description="斜槓命令能改許可權；先理解 sandbox 和 approval 的底層含義。" href="/zh-Hant/docs/codex/official/02-config-security/07-approval-security" />
  <Card title="非互動執行" description="把 Codex 放進指令碼或 CI 前，先理解 exec 的輸入輸出和退出碼。" href="/zh-Hant/docs/codex/official/01-products/28-non-interactive" />
</Cards>
