AI 编程教程中文版
官方教程中文版产品入口

使用 CLI 斜杠命令

理解 Codex CLI slash commands 的控制面:会话、模型、权限、上下文、审查和分支探索。

斜杠命令不是要背的命令表,而是 CLI 的控制面。具体可见命令会随版本、feature flag、登录状态和当前任务状态变化;长期可靠的做法是记住“什么时候该控制会话、什么时候该控制权限、什么时候该审查结果”。

在 Codex CLI 的 composer 里输入 /,会打开 slash command popup。官方 CLI features 文档说明,Codex 的交互模式可以读仓库、改文件、跑命令,也能用 /clear/copy/theme 等命令控制 TUI。运行中按 Tab 还可以把后续文本、斜杠命令或 ! shell 命令排队到下一轮。

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

先按用途记

会话控制

这些命令解决“当前对话要不要继续沿用”的问题:

  • /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 等实际生效来源。

如果你不确定 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 可以打开由 VISUALEDITOR 指定的 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 入口。

官方资料

接下来去哪

本页目录