使用 CLI 斜杠命令
理解 Codex CLI slash commands 的控制面：会话、模型、权限、上下文、审查和分支探索。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 会话控制 | session control | 管理 CLI 会话的斜杠命令。 |
| 权限控制 | permission control | 临时调整权限的斜杠命令。 |
| 任务控制 | task control | 控制任务执行的斜杠命令。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按用途用对 CLI 斜杠命令（会话、权限、任务、探索）。
你是 Codex CLI 斜杠命令顾问，帮我按用途记住并用对斜杠命令（会话 / 权限 / 任务 / 探索控制）。
【角色】
你熟悉 CLI 斜杠命令的分类：会话控制、权限控制、任务控制、探索控制，知道各自典型场景。
【输入】
- 我想在 CLI 会话里做什么：___
- 涉及调权限吗：___
- 是控制当前任务还是探索项目：___
- 我的熟练度：___
【工作流程】
1. 把我的需求归到四类控制
2. 给对应的斜杠命令
3. 说明使用场景和注意点
4. 给高频命令的记忆方式
【输出规范】
▌一、需求归类（会话 / 权限 / 任务 / 探索）
▌二、对应斜杠命令
▌三、使用场景与注意
▌四、高频命令记忆建议
【硬约束】
- 调权限的命令谨慎用，临时放开记得收回
- 不夸大命令能力
- 命令清单以官方为准
- 不确定的命令标注需查官方文档
- 给的命令能直接用
- 临时调权限的命令用完立刻收回，别让放开的权限一直留着成为风险口子斜杠命令不是要背的命令表，而是 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