# 斜杠命令

> 交互会话中的全部斜杠命令（按用途分组），常用快捷键与输入技巧，以及全屏对话记录的操作

- 作者：David（道雾轩）
- 专栏：Codex 中文手册（https://daiw.org/manual/codex.md）
- 最后更新：2026-09-29
- 原文：https://daiw.org/manual/codex/slash-commands
- 转载与引用：请注明出处并附原文链接（https://daiw.org/about/copyright）

在输入框**开头**输入 `/` 会弹出命令菜单，继续输入会按命令名的前缀筛选（不分大小写，与输入完全相同的命令排在最前）；支持参数的命令把参数写在同一行，例如 `/review 只看权限相关的改动`。本页已核对至 Codex CLI v0.160.1；CLI 文档没有列出的命令会在备注中注明。

Codex 正在工作时，输入斜杠命令后按 `Tab` 可以把它排到下一轮执行。排队的命令在真正执行时才解析，所以菜单和报错会在当前这一轮结束后才出现。

## 模型与模式

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/model` | 选择模型与推理强度 | | 选择器里按 `Enter` 保存为默认值，按 `s` 只用于当前会话（v0.156.0 起） |
| `/fast` | 开关当前模型的 Fast 服务档位，并记住选择 | | 只有模型目录为当前模型提供该档位时才出现；随附目录里的 GPT-6 Sol 与 GPT-6 Luna 在没有设置 `service_tier` 时默认就用 Fast，见[模型与推理](https://daiw.org/manual/codex/models) |
| `/plan` | 切换到计划模式 | 可选，作为第一条规划请求 | `Shift+Tab` 也可以切换协作模式 |
| `/goal` | 设置或查看长任务的目标 | `<目标>`，或 `edit`、`pause`、`resume`、`clear` | 目标最长 4000 字符；不带参数时打开目标菜单 |
| `/voice` | 开始或结束实时语音对话 | 可选：`settings`（选择之后语音对话使用的声音）、`mute`（开关麦克风）或 `stop`（结束对话）；不带参数时在开始与结束之间切换 | 快捷键 `F8`。v0.156.0 起默认开启（功能开关 `realtime_conversation`）；只在附带语音运行时的安装包里出现，macOS、Linux 与 Windows 的发布包都已附带；旁支对话中不可用；CLI 文档未列出 |

`/personality` 已在 v0.156.0 移除（官方 CLI 文档仍列着它）：`friendly`、`pragmatic` 两种沟通风格已经退役，配置项 `personality` 只剩 `none` 还有作用，见[模型与推理](https://daiw.org/manual/codex/models)。

## 权限与沙箱

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/permissions` | 选择 Codex 无需询问即可执行的操作（如 Auto、Read Only 预设） | | 配置了命名权限配置档时也会列出 |
| `/approve` | 对最近一次被自动审查拒绝的操作批准重试一次 | | 配合自动审查（Auto-review）使用 |
| `/setup-default-sandbox` | 设置提权版 Windows 沙箱 | | 仅 Windows，且正在使用降级的受限令牌沙箱时出现 |

原来仅限原生 Windows、让沙箱额外读取一个目录的 `/sandbox-add-read-dir` 已在 v0.155.0 移除，官方 CLI 参考目前仍列着它。沙箱与审批的完整说明见 [沙箱、审批与安全](https://daiw.org/manual/codex/sandbox-approvals)。

## 会话

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/new` | 在同一个 CLI 进程里开始新对话 | 可选，新对话名称 | 不清屏；在本地 Git 仓库里会先询问在当前检出还是新 worktree 中运行（v0.156.0 起 worktrees 默认开启） |
| `/clear` | 清屏并开始新对话 | 可选，新对话名称 | `Ctrl+L` 只清屏、不换对话 |
| `/resume` | 恢复一个已保存的会话 | 可选，会话 ID 或名称；省略则打开选择器 | |
| `/fork` | 把当前对话复制为新对话（新 ID），原记录不变 | 可选，新对话名称 | 在本地 Git 仓库里同样先询问放在哪个检出；派生其他已保存会话用 `codex fork` |
| `/rename` | 重命名当前对话 | 可选，新名称；省略则弹出输入框 | |
| `/archive` | 归档当前会话 | | 需确认；用 `codex unarchive` 恢复。使用内嵌服务时归档后退出；v0.155.0 起，连接本机守护进程或远程 app server 时不再退出，而是回到代理总览 |
| `/delete` | 永久删除当前会话 | | 需确认；派生的子代理线程一并删除。使用内嵌服务时删除后退出；v0.156.0 起，连接本机守护进程或远程 app server 时回到代理总览 |
| `/compact` | 总结对话以释放上下文 | | |
| `/recap` | 立即生成当前对话的摘要 | | CLI 文档未列出 |
| `/side`、`/btw` | 在临时分叉中开一个旁支对话，不影响主对话记录 | 可选，直接跟问题 | `Ctrl+/` 切换旁支对话，`Ctrl+C` 返回主线程 |
| `/export` | 把对话导出为 Markdown | 可选，输出文件路径；省略则弹出导出选项 | CLI 文档未列出 |
| `/copy` | 复制最近一条已完成的回复，可以只复制其中一部分 | | 快捷键 `Ctrl+O` |
| `/worktree` | 在新的 Git worktree 中开始或继续对话 | | v0.156.0 起功能开关 `worktrees` 默认开启；CLI 文档未列出 |
| `/cd` | 切换当前工作目录 | 可选，路径；省略时为 `~` | CLI 文档未列出 |
| `/pwd` | 显示当前工作目录 | | 别名 `/cwd`；CLI 文档未列出 |
| `/app` | 在 ChatGPT 桌面应用中继续当前会话 | | 仅 macOS、Windows |
| `/quit`、`/exit` | 退出 Codex | | |

会话的存储位置与命令行管理见 [会话管理](https://daiw.org/manual/codex/sessions)。

## 代码与上下文

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/review` | 审查当前改动并找出问题 | 可选，自定义审查说明；省略则打开预设菜单 | 见 [代码审查](https://daiw.org/manual/codex/review) |
| `/diff` | 显示 git diff，包括未跟踪的文件 | | |
| `/mention` | 插入 `@` 并打开文件搜索 | | 等同直接输入 `@` |
| `/init` | 让 Codex 在当前目录生成 `AGENTS.md` | | 见 [AGENTS.md 项目指令](https://daiw.org/manual/codex/agents-md) |
| `/ide` | 把 IDE 的当前选区、打开的文件等上下文带入对话 | 可选，`on`、`off` 或 `status` | |
| `/status` | 显示会话配置（模型、审批策略、可写目录）与 token 用量 | | v0.156.0 起，连接本机守护进程时 Server 一行显示 Local background server |
| `/usage` | 查看账号用量分析，或使用一次额度重置 | 可选，`daily`、`weekly` 或 `cumulative`，直接打开对应的 token 活动视图 | 需用 ChatGPT 账号登录。v0.156.0 起菜单里的 View analytics 打开全屏的用量分析面板，分概览、用量、消息、插件、技能、对话等标签页 |
| `/debug-config` | 显示配置层顺序与 requirements 来源，排查配置为何不生效 | | 不在弹出菜单中显示，但可以直接输入 |
| `/warnings` | 查看保留下来的警告与诊断详情（启动、运行时、MCP、弃用提示等），可逐条复制 | | v0.156.0 新增，快捷键 `F2`，底部状态栏显示去重后的警告数；CLI 文档未列出 |

## 扩展与集成

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/mcp` | 列出已配置的 MCP 工具 | 可选，`verbose` 显示服务器详情 | 见 [MCP 集成](https://daiw.org/manual/codex/mcp) |
| `/skills` | 选择一个技能用于接下来的请求 | | 也可以输入 `$` 提及技能，见 [Skills 技能](https://daiw.org/manual/codex/skills) |
| `/plugins` | 浏览已安装和可发现的插件 | | 在已安装插件上按 `Space` 启用或停用 |
| `/apps` | 管理应用（连接器），选中后以 `$app-slug` 插入输入框 | | 需 ChatGPT 登录；不在弹出菜单中显示 |
| `/hooks` | 查看生命周期 hooks，信任、停用或重新启用非托管 hooks | | 见 [Hooks](https://daiw.org/manual/codex/hooks) |
| `/memories` | 配置是否使用、生成记忆 | | |
| `/import` | 从 Claude Code 或 Cursor 导入配置、项目和近期对话 | | v0.157.0 起远程会话与连接本机守护进程的会话也能用 |

## 多代理与后台终端

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/agents` | 打开代理总览（agent command center），查看、筛选并切换所有 agent 会话 | | 连接本机守护进程时，输入框为空按 `←` 也能打开；文档写作 `/agent`，v0.158.0 中没有这个名字；见[子代理](https://daiw.org/manual/codex/subagents) |
| `/daemon` | 管理本机的后台服务（app-server 守护进程）：显示正在运行的版本，可选择安装最新稳定版，或改用当前 CLI 的安装包并固定版本 | | v0.156.0 新增；确认后 Codex 退出并在当前终端执行更新，完成后重新启动即可；连接远程 app server 时不可用。见 [SDK 与 App Server](https://daiw.org/manual/codex/sdk-app-server)；CLI 文档未列出 |
| `/subagents` | 在本会话的子代理线程之间切换 | | 见 [子代理](https://daiw.org/manual/codex/subagents) |
| `/ps` | 列出后台终端及其最近几行输出 | | 使用 `unified_exec` 时才会有后台终端；v0.158.0 起多行命令的预览不再只显示第一行，换行显示为 `↵`，整条预览最多 80 个字符 |
| `/stop` | 停止本会话的所有后台终端 | | 别名 `/clean` |

## 界面、账户与其他

| 命令 | 作用 | 参数 | 备注 |
| --- | --- | --- | --- |
| `/keymap` | 查看并重映射快捷键，保存到 `tui.keymap` | 可选，`debug` 打开按键调试视图 | |
| `/vim` | 开关输入框的 Vim 模式 | | 默认开启可设 `tui.vim_mode_default = true` |
| `/raw` | 开关原始回滚模式，方便在终端里选中复制 | 可选，`on` 或 `off` | 快捷键 `Alt+R`；默认值用 `tui.raw_output_mode` |
| `/tui` | 选择下次启动时的界面模式：Fullscreen（全屏对话记录）或 Scrollback（使用终端自己的回滚记录） | | v0.156.0 新增，需确认，保存为 `tui.fullscreen_transcript`，重启后生效；`--no-alt-screen` 等启动参数仍然优先；CLI 文档未列出 |
| `/theme` | 选择语法高亮主题，保存到 `tui.theme` | | v0.156.0 起新增 `ada`、`babbage`、`curie`、`cushman`、`dali`、`davinci` 六个内置主题，界面的强调色也跟随主题；自定义 `.tmTheme` 放在 `$CODEX_HOME/themes` |
| `/statusline` | 配置底部状态栏显示哪些项，保存到 `tui.status_line` | | |
| `/title` | 配置终端标题显示哪些项，保存到 `tui.terminal_title` | | |
| `/pets` | 选择或隐藏终端宠物 | 可选，宠物 ID，或 `off` 隐藏 | 别名 `/pet` |
| `/experimental` | 开关实验功能（如网络代理、运行时防止休眠） | | 保存到配置，部分需重启生效；语音对话、worktree 与自动启动后台服务已转为默认开启，不再列在这里 |
| `/logout` | 退出登录，清除本地凭据 | | |
| `/feedback` | 把日志与诊断信息发送给维护者 | | 先选反馈类别，再决定是否上传日志；v0.158.0 起，同意上传日志时还会附上 TUI 客户端最近 1 MiB 的日志（`client-logs.txt`）。诊断日志写不进本地数据库时，Codex 会发出一次警告，提醒退出前用 `/feedback` 附带日志上传，或运行 `codex doctor` |

此外还有只在开发构建中出现的 `/rollout`（打印会话记录文件路径）和 `/test-approval`，以及源码中标注“请勿使用”的 `/debug-m-drop`、`/debug-m-update`。

<Callout type="info">
  **哪些情况下命令不可用：**

  - **任务进行中**：`/new`、`/clear`、`/resume`、`/fork`、`/archive`、`/delete`、`/worktree`、`/init`、`/compact`、`/recap`、`/export`、`/review`、`/plan`、`/cd`、`/import`、`/memories`、`/experimental`、`/keymap`、`/tui`、`/vim`、`/theme`、`/pets`、`/logout` 以及 Windows 的 `/setup-default-sandbox` 会提示当前不可用，其余命令随时可用。v0.156.0 起，MCP 服务器仍在启动时也能使用 `/review`。
  - **旁支对话中**：只能用 `/ide`、`/agents`、`/copy`、`/export`、`/raw`、`/diff`、`/mention`、`/status`、`/daemon`、`/warnings`、`/pwd`、`/usage`；代码审查进行中不能开旁支对话。
  - **按功能开关显示**：`/goal`、`/plugins`、`/worktree`、`/voice` 默认可用，关闭对应的功能开关（`goals`、`plugins`、`worktrees`、`realtime_conversation`）后隐藏；`/voice` 另外只在附带语音运行时的安装包里出现。
</Callout>

## 快捷键与输入技巧

| 按键或输入 | 作用 |
| --- | --- |
| `/` | 打开斜杠命令菜单（仅在消息开头） |
| `@` | 在工作区中搜索文件，并把路径插入输入框 |
| 行首 `!` | 把这一行当作本地 shell 命令直接执行：不经审批、不进沙箱（相当于完全访问），也不走会话的网络代理 |
| `$` | 提及技能或应用，例如 `$skill-creator` |
| `Ctrl+V`、`Ctrl+Alt+V` | 粘贴剪贴板中的图片；直接粘贴图片文件的路径也会变成图片附件 |
| `Enter` | 发送；Codex 正在工作时发送，会把新指令注入当前这一轮 |
| `Tab` | Codex 正在工作时，把消息、斜杠命令或 shell 命令排到下一轮 |
| `Ctrl+J` | 插入换行（终端支持时也可以用 `Shift+Enter`、`Alt+Enter`） |
| `Esc` | Codex 正在工作时中断当前这一轮 |
| 输入框为空时按两次 `Esc` | 浏览之前的提示词：`←`、`→` 选择，`Enter` 把当前会话回退到所选提示词之前，并把它放回输入框重新编辑。v0.156.0 起在原会话中回退，不再分叉出新会话；已经发生的文件改动不会撤销 |
| `Up`、`Down` | 翻阅草稿历史 |
| `Ctrl+R`、`Ctrl+S` | 向前、向后搜索提示历史；`Enter` 采用，`Esc` 取消 |
| `Ctrl+G` | 用 `VISUAL`（未设置时用 `EDITOR`）指定的编辑器编写长提示词，保存并关闭后回到输入框 |
| `Ctrl+O` | 复制最近一条已完成的回复 |
| `Ctrl+T` | 打开完整的对话记录视图；浏览之前的提示词时用来展开或收起详情 |
| `Ctrl+L` | 清屏，保留当前对话 |
| `Alt+R` | 开关原始回滚模式 |
| `F8` | 开始或结束语音对话（v0.156.0 起，对应 `tui.keymap.chat.toggle_voice`） |
| `Ctrl+X` | 语音对话进行中开关麦克风（v0.155.0 起；自定义快捷键已占用 `ctrl-x` 时不启用这个默认键） |
| `F2` | 打开警告查看器，同 `/warnings`（v0.156.0 起） |
| `F3`、`F4` | 在对话记录中查找；聚焦某组工具活动查看详情（v0.156.0 起，见下文“全屏对话记录”） |
| `Ctrl+/` | 切换旁支对话 |
| `Shift+Tab` | 在协作模式（如计划模式）之间切换 |
| `Alt+,`、`Alt+.` | 在当前模型支持的档位间降低、提高推理强度，只对当前会话生效（也可以用 `Shift+Down`、`Shift+Up`）。v0.158.0 起可以一直调到 `max`，`ultra` 仍要在 `/model` 选中模型后的 More reasoning… 里选择 |
| `Shift+Left` | 编辑已排队的消息（也可以用 `Alt+Up`）。v0.158.0 起不再按终端挑选，界面提示统一显示 `Shift+Left`（此前多数终端里提示的是 `Alt+Up`） |
| `Alt+Left`、`Alt+Right` | 切换到上一个、下一个 agent |
| 输入框为空时按 `←` | 打开代理总览（连接本机守护进程时）。v0.158.0 起，对话正在另一个应用中打开、这里只能只读查看时，除了 `Esc` 也可以按 `←` 回到代理总览 |
| 空输入框中按 `?` | 显示快捷键提示 |
| `Ctrl+C` | 中断当前任务；空闲时再按一次退出（`Ctrl+D` 同样可以退出） |

除 `/`、`@`、`!`、`$`、`Esc`（回溯）、`Ctrl+C`、`Ctrl+D`、`Ctrl+V`、`Ctrl+Alt+V`、`Shift+Tab`、`Alt+Left`、`Alt+Right`、`F2` 与空输入框里的 `←`（把 `editor.move_left` 改成不含 `left` 后它就不再打开代理总览）这些固定按键外，上表中的快捷键都可以用 `/keymap` 或 `config.toml` 中的 `tui.keymap` 重新绑定。键名写作 `ctrl-a`、`shift-enter`、`page-down` 这样的形式；针对具体场景的绑定会覆盖 `tui.keymap.global`，绑定为空列表表示解绑。v0.156.0 新增的默认键（`F2`、`F3`、`F4`、`F8`）如果已经被你绑定给了别的操作，会自动让位，不会冲突。

## 全屏对话记录

v0.157.0 起，交互界面默认使用“全屏对话记录”（`tui.fullscreen_transcript = true`，v0.156.0 可以用 `/tui` 手动开启）：对话记录画在终端的备用屏幕里，滚动、选择与搜索都由 Codex 自己处理，不再依赖终端的回滚记录。

| 操作 | 作用 |
| --- | --- |
| `PgUp`、`PgDn`、鼠标滚轮 | 滚动对话记录 |
| `Ctrl+Home`、`Ctrl+End` | 跳到开头、回到最新（也可以用 `Alt+Shift+,`、`Alt+Shift+.`） |
| 鼠标拖动、双击、三击 | 选择文本，双击选中整个词，三击选中整行；按住 `Shift` 单击可以扩展已有的选区（v0.157.0 起） |
| 松开鼠标 | v0.158.0 起，用鼠标选中文字后一松开就自动复制，选区保留，由 `tui.copy_on_select` 控制（见下文） |
| `Ctrl+Space` | 用键盘开始选择，再用方向键调整选区 |
| 有选区时按 `Ctrl+C`、`Enter` | 复制选中的文本（`Ctrl+Shift+C`，以及终端转发过来的 `Cmd+C` 也可以），`Enter` 复制后回到最新；`Esc` 取消选择 |
| 右键 | 有选区时复制选中的文本（在输入框里同样可用）；v0.158.0 起，没有选区时把剪贴板里的文本粘贴到输入框，由 `tui.right_click_paste` 控制 |
| 单击链接 | 打开链接，Markdown 链接和裸 URL 都可以 |
| `F3` | 在整个对话记录中查找，不区分大小写，需要时会加载更早的历史；对话记录视图里也可以按 `/` |
| `F4` | 聚焦某组工具活动，查看它的详细内容 |

v0.158.0 起，从对话记录里复制选区会保留 Markdown 格式：粗体、斜体、行内代码、链接、标题、列表、引用和表格都按 Markdown 写出，只选中代码等原样内容时仍按原文复制；想要整条回复的 Markdown 原文，用 `/copy` 或 `Ctrl+O`。松开即复制与右键粘贴各有一个配置：

- `tui.copy_on_select`：`auto`（默认）、`always` 或 `never`，对 `Ctrl+T` 打开的对话记录视图和恢复、派生会话时的预览同样生效。`auto` 下大多数终端松开即复制，在 tmux、Zellij 里也是；只有直接在 Ghostty 1.2 及以上、macOS 上的 Kitty、Windows Terminal、Windows 上的 VS Code 中运行时不自动复制，因为这些终端的复制快捷键在终端自己没有选区时会转发给 Codex，直接按它即可。`never` 表示只用上表的按键或右键复制。
- `tui.right_click_paste`：`auto`（默认）、`on` 或 `off`。`auto` 在 Windows、Linux（含 WSL）上启用，`on` 另外在 macOS 上启用；两者在 SSH 会话和 VS Code 的终端里都不读取剪贴板，也只在输入框可以编辑、没有选区、没在查找时才粘贴。`off` 则不做这种粘贴，右键粘贴留给终端自己处理。

同样从 v0.158.0 起，新会话的标题改成精简样式并带一句随机问候语，全屏模式下空白处的花朵动画点一下会重播（受 `tui.animations` 与 `tui.effects.welcome` 控制）。全屏模式也不再显示启动提示，输入框上方不再轮换显示使用提示（那里只留给额度提醒），改为：一轮运行超过 30 秒时，工作状态指示下方会出现一条随机提示；从第三轮起，部分成功完成的回复后面也会出现一条（每次启动最多两条）。提示里的快捷键按你当前的绑定显示，也不会被选中或查找到；`tui.show_tooltips = false` 可以关掉。

想换回终端自己的回滚记录（例如习惯用终端的搜索与复制），在 `/tui` 里选 Scrollback 后重启，或在配置里写 `tui.fullscreen_transcript = false`。不使用备用屏幕时（`--no-alt-screen` 或 `tui.alternate_screen = "never"`）也是回滚记录模式；`tui.alternate_screen = "auto"` 时，通过 SSH 使用 macOS 自带的 Terminal.app 会自动改用回滚记录。v0.157.0 起，tmux 中设置了 `mouse off` 时，Codex 不再捕获鼠标。