第 03 章

Slash Commands

一个 / 前缀命令，让 Codex CLI 的操盘柄从"聊天"变成"指令"

50+ 内置命令，覆盖会话管理、模型切换、权限控制、信息查询

重复操作太累

你已经会用 Codex 写代码，但每次都要把操作指令写进聊天里

每次切模型都要重启

你觉得默认模型不够聪明，于是退出、重开、-m gpt-5.6……为什么不能会话中途直接切？

对话太长只能硬扛

聊了半小时后 Codex 开始记不住前面说的。你发现 token 快用完了，却不知道哪里可以压缩，只能开新会话重新描述需求。

想要审查只能靠运气

你改完一个文件，想要 code review。你不知道有 /review，于是说"帮我 review 一下"——效果看运气，格式也不稳定。

Slash Commands 就是解决这些问题的：Codex CLI 内置了一组以 / 开头的命令。它们不是给 AI 的提示词，而是直接给 CLI 的指令。

开始之前

适合谁

  • 已经会用命令行、想提升交互效率的开发者
  • 知道 /model、/compact、/review 这几个词但没系统用过的人
  • 想自定义命令、打造个人工作流的进阶用户

读完你应该能

  • 解释 slash command 是什么、怎么触发、怎么补全
  • 用命令管理会话、切换模型、压缩上下文、查看用量
  • 用 /plan + /review 组合提升代码质量
  • 用 /skills 和自定义命令扩展能力

本章先不讲

  • MCP 服务器配置（第 06 章）
  • Hooks 触发器（第 08 章）
  • Subagents 编排（第 07 章）
  • Thread 管理（第 10 章）
阅读节奏：本章约 18 张幻灯片。前半讲概念和触发方式，中间是分类命令速查，后半是实战技巧和小结。

什么是 Slash Command

一句话：以 / 开头的输入被解析为内置命令，不是发送给 AI 的提示词

核心区别

普通输入 → 发送给 LLM 推理 → 消耗 token
/model → CLI 直接执行 → 不消耗 AI token（除非命令本身触发 AI 动作）

触发方式

在 TUI 中输入 / 打开命令弹窗，支持 Tab 自动补全。输入 /m 按 Tab 即可补全为 /model。

数量规模

Codex CLI 内置 50+ 个 slash command，覆盖会话管理、模型配置、权限控制、信息查询、IDE 集成等场景。

记住这个规则：看到 / 开头，想到的是"操作 CLI"，不是"跟 AI 说话"。这能帮你省大量 token。

怎么触发

TUI 中的命令弹窗与补全机制

触发流程：/ → 弹窗 → 补全 → 执行
弹窗排序规则：命令按使用频率排列（高频在前），不是字母序。源码注释："DO NOT ALPHA-SORT! More frequently used commands should be listed first."

会话管理

9 个命令，掌控你的对话生命周期

命令作用使用场景
/new新建会话（可命名）开个新话题并随手起名，历史仍可查
/clear清空并新建（可命名）清掉旧上下文重新开始，顺带给新会话命名
/resume恢复历史会话回到昨天没做完的工作
/fork分叉当前会话A/B 测试两套方案，互不干扰
/archive归档并退出这个话题结束了，标记完成
/delete永久删除并退出彻底清理不需要的会话
/compact压缩上下文对话太长，总结历史释放 token
/rename重命名会话给会话起个有意义的名字
/title设置终端标题在终端标签页中识别当前会话
最常用：/new、/resume、/compact——这三个覆盖了 80% 的会话管理需求。

给会话起名

0.146：/new 和 /clear 现在能直接命名新会话

> /new 用户登录模块
# 新建一个名为「用户登录模块」的会话，旧的保留在历史里

> /clear 调试内存泄漏
# 清空当前上下文，开启名为「调试内存泄漏」的新会话

为什么重要

以前新建会话只有自动编号，翻历史时一片"会话 1、2、3"分不清。现在能固定关键线程、命名后快速检索，多任务并行也不乱。

/new vs /clear

/new 保留旧会话另起一个；/clear 则清掉当前上下文再开始。两者现在都能带名字。

配合分页历史：命名的会话会出现在分页历史里，支持搜索、固定（pin）。会话管理细节见第 10 章。

/import 迁移

0.145：从 Cursor / Claude Code 一键搬设置

> /import
# 选择来源 → 扫描可迁移项 → 确认写入

能搬什么

  • 设置项（审批策略、模型偏好）
  • MCP servers 配置
  • 已装的 Plugins
  • Memories（长期记忆 / 规则）

为什么放在这

迁移本质上是"批量改配置"，和会话/命令管理同属工作流配置范畴。详细实战见第 05 章。

换工具的最大阻力是重配。/import 把"重配一天"压成一条命令。

/compact：上下文压缩

对话太长记不住了？让 Codex 帮你"总结过去"

它做了什么

将当前对话历史总结为一段精简摘要，替换原始消息。释放 token 空间，让 Codex 继续工作而不丢失关键上下文。

什么时候用

  • 用 /status 查看 token 用量偏高时
  • Codex 回应质量下降，疑似上下文饱和
  • 切换子任务前，压缩已完成部分的上下文

注意事项

压缩是有损的——细节会被丢弃。压缩前先把重要代码片段或决策手动复制到笔记中。

注意：压缩后无法恢复原始对话。如果后续需要引用早期细节，先 /fork 备份当前状态。

模型与配置

4 个命令，切换模型、设定目标、调整人格

命令作用示例
/model切换模型和推理力度（选模型时会一并让你选 reasoning effort）/model gpt-5.6-terra → 再选 low / high / max
/plan进入计划模式先列计划再动手，适合复杂任务
/goal设置长期任务目标/goal 完成用户模块的单元测试
/personality设置沟通风格正式 / 简洁 / 教学式
/model 的强度：推理力度在弹窗中一并选择——复杂任务切 high/max，简单问答切 low 省钱。常规可用sol-medium 规划，用luna-xhigh编码

/plan：计划模式

让 Codex 先想清楚再动手

工作机制

切换到 Plan 模式后，Codex 只输出执行计划，不修改任何文件。你确认计划无误后，再让它执行。

适合场景

  • 涉及多文件修改的重构
  • 不确定实现方案，想先看思路
  • 团队协作，需要 review 计划再动手

黄金组合

/plan → 确认计划 → 执行 → /review
计划 → 执行 → 检查，三步闭环。

权限与安全

3 个命令，控制 Codex 能做什么

命令作用使用场景
/permissions权限设置控制 Codex 是否需要确认才能执行命令
/setup-default-sandbox提升沙箱权限 Windows 专用仅 Windows + 降级版受限令牌沙盒时可用
/approve批准重试批准一次最近被拒绝的 auto-review 重试
关于 /setup-default-sandbox：这是 Windows 专用命令，仅当 Codex 在 Windows 上运行降级版的受限令牌沙盒时才会出现。它通常不会出现在 / 自动补全列表里。

信息与调试

7 个命令，查看状态、用量、配置

命令作用你会看到
/status查看状态当前会话配置 + token 用量
/usage查看用量账户用量或用量限制重置
/debug-config调试配置配置层级和需求来源
/raw原始输出切换原始滚动模式，便于终端选择复制
/diff查看差异git diff（含未跟踪文件）
/ps查看进程列出后台终端
/mcpMCP 状态列出已配置的 MCP 工具（/mcp verbose 显示详情）
排查问题三板斧：/status 看配置 → /mcp 看工具 → /debug-config 看配置来源。

IDE 集成

让 Codex 看到你编辑器里的上下文

/ide

包含当前编辑器中的选中内容、打开的文件和其他 IDE 上下文。让 Codex 不需要你复制粘贴就能理解你在看什么。

典型场景

  • 在 VS Code 里选中一段代码，切到 Codex 输入 /ide
  • Codex 自动获取你的选中文件和光标位置
  • 无需手动描述"这个文件第 30 行的函数"
  • 测试：在IDE中选择一段话，在codex中输入“我在ide中选中了哪些文字？”
前提条件：需要在 IDE 中安装 Codex 插件并连接。

其他命令（上）

Hooks、Skills、Memories、Review、Init

命令作用一句话
/hooksHook 管理查看和管理生命周期钩子
/skillsSkill 管理用 Skill 提升特定任务的表现
/memories记忆管理配置记忆的使用和生成
/review代码审查审查当前修改并找出问题
/init初始化创建包含项目指导的 AGENTS.md 文件
/import导入从 Claude Code 导入设置、项目和最近会话
/copy复制将最新回复复制为 Markdown（也可按 Ctrl+O）

其他命令（中）

Side、Agent、Mention、Theme、Keymap、Vim

命令作用一句话
/side / /btw侧边代理在临时分叉中开启侧边对话，不污染主线
/agent / /subagents代理切换活跃的代理线程
/mention提及提及一个文件，将其加入上下文
/theme主题选择语法高亮主题
/keymap键位图重新映射 TUI 快捷键
/vimVim 模式切换编辑器的 Vim 模式
/experimental实验性功能切换实验性功能开关

其他命令（下）

退出、反馈、杂项

命令作用一句话
/logout / /quit / /exit退出退出 Codex（三个命令效果相同）
/feedback反馈发送日志给维护者
/rollout发布打印 rollout 文件路径
/clear清屏清除终端并开启新聊天
/test-approval测试审批测试审批请求流程
/pets宠物选择或隐藏终端宠物
/apps应用管理应用
/plugins插件浏览插件
/statusline状态栏配置状态栏显示内容

高频命令速查表

10 个命令覆盖日常 90% 的需求

你想做什么用哪个命令效果
换个更聪明的模型/model gpt-5.6立即切换到 gpt-5.6 模型
让 Codex 先列计划再动手/plan进入计划模式
改完代码后做审查/review审查当前修改并找出问题
对话太长记不住了/compact总结历史，释放 token
开个新话题/new开启新会话，保留历史
回到昨天的工作/resume恢复历史会话
A/B 测试两套方案/fork分叉当前会话
查一下 token 用了多少/usage查看账户用量
看 Connected MCP 通不通/mcp列出已配置的 MCP 工具
让 Codex 记住这个约定/memories配置记忆的使用和生成

效率技巧

老用户才知道的 4 个窍门

切换前先判断：同任务还是新任务

同一大任务的阶段切换（重构→测试）用 /compact，保留因果链；完全不同的任务用 /new，零上下文污染最省 token。别无脑 /compact。

Fork 比 New 更安全

不确定新思路是否可行？先 /fork 再尝试。不满意就删掉 fork，主线毫发无伤。比 /new 更可控。

/plan + /review 黄金组合

复杂任务：/plan 列计划 → 执行 → /review 检查。三步闭环，代码质量提升一个档次。

第 03 章 总结

Slash Commands 回顾

四句话记住这一章

Slash Command 是什么

以 / 开头的命令直接控制 CLI，不消耗 AI token（除非触发 AI 动作）。50+ 内置命令覆盖 6 大类。

高频命令

/model、/plan、/review、/compact、/new、/resume——这 6 个覆盖日常 90% 需求。

怎么触发

输入 / 打开命令弹窗，Tab 自动补全，Enter 执行。按使用频率排序，高频命令在前。

效率心法

切换前判断同任务还是新任务、先 fork 再实验、plan + review 闭环、用 /status 查 token。

下一步：第 04 章 Skills —— 命令是入口，Skills 是能力。学会把高频命令组合打包成可复用的能力包，让 Codex 一键执行复杂流程。