使用 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
先按用途记
会话控制
新开、恢复、压缩或清空对话,避免上下文无限膨胀。
权限控制
用 permissions 和 status 确认当前 sandbox、approval、writable roots 和 token 状态。
任务控制
用 plan、review、diff 把实现、审查和验证拆开。
探索控制
用 fork、side、agent 探索不同方案或查看子线程工作。
会话控制
这些命令解决“当前对话要不要继续沿用”的问题:
/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。
推荐流程:
- 复杂任务先
/plan,不要直接让 Codex 改。 - 改完先
/diff看范围。 - 再
/review找风险。 - 最后跑项目测试和构建。
探索控制
这些命令适合“同一上下文下临时分叉”:
/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
- Agent approvals & security:https://developers.openai.com/codex/agent-approvals-security
- Configuration Reference:https://developers.openai.com/codex/config-reference