---
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="/docs/codex/official/01-products/26-cli-features" />
  <Card title="CLI 参数" description="需要脚本化或启动时指定模型、路径、sandbox 时，再查参数页。" href="/docs/codex/official/01-products/27-cli-args" />
  <Card title="审批与安全" description="斜杠命令能改权限；先理解 sandbox 和 approval 的底层含义。" href="/docs/codex/official/02-config-security/07-approval-security" />
  <Card title="非交互运行" description="把 Codex 放进脚本或 CI 前，先理解 exec 的输入输出和退出码。" href="/docs/codex/official/01-products/28-non-interactive" />
</Cards>
