使用 CLI 斜杠命令

Slash commands 让你用键盘快速控制 Codex CLI。你可以在 composer（输入区）里输入 / 打开 slash popup，然后选择命令

Slash commands 让你用键盘快速控制 Codex CLI。你可以在 composer（输入区）里输入 / 打开 slash popup，然后选择命令。Codex 会执行切换模型、调整权限、总结长对话等动作，而不需要离开 terminal（终端）。

本篇覆盖两件事：

如何找到适合当前任务的 built-in slash command（内置斜杠命令）。
如何用 /model、/fast、/personality、/permissions、/agent、/status 等命令控制 active session（当前会话）。

Built-in slash commands

Codex CLI 内置下面这些命令。打开 slash popup 后输入 command name，可以过滤列表。

当一个任务正在运行时，你也可以输入 slash command 并按 Tab，把它 queue（排队）到下一轮。Codex 会在当前 turn 完成后解析这些 queued slash commands，所以命令菜单或错误会在当前 turn 结束后出现。排队前，slash completion（斜杠补全）仍然可用。

Command	Purpose	When to use it
`/permissions`	设置 Codex 可以在不先询问的情况下做什么。	在会话中途放宽或收紧 approval requirements，例如在 Auto 和 Read Only 之间切换。
`/sandbox-add-read-dir`	给额外目录授予 sandbox read access。仅 Windows。	当命令需要读取当前 readable roots 外的 absolute directory path（绝对目录路径）时使用。
`/agent`	切换 active agent thread。	查看或继续 spawned subagent thread（派生子 Agent 线程）的工作。
`/apps`	浏览 apps / connectors，并插入 prompt。	在要求 Codex 使用某个 app 前，把它作为 `$app-slug` 附加进 prompt。
`/plugins`	浏览已安装和可发现 plugins。	查看 plugin tools、安装推荐 plugins，或管理 plugin availability。
`/clear`	清空 terminal，并开始 fresh chat。	想同时重置可见 UI 和 conversation 时使用。
`/compact`	总结可见 conversation，释放 tokens。	长时间运行后使用，让 Codex 保留关键点，同时避免 context window 被撑满。
`/copy`	复制最新完成的 Codex 输出。	不想手动选择文本时，复制最新完成的 response 或 plan。也可以按 `Ctrl+O`。
`/diff`	显示 Git diff，包括 Git 尚未跟踪的文件。	commit 或测试前 review Codex 的改动。
`/exit`	退出 CLI，等同 `/quit`。	退出会话的另一种写法。
`/experimental`	开关 experimental features。	从 CLI 启用 subagents 等可选功能。
`/feedback`	向 Codex maintainers 发送 logs。	报告问题或提交 diagnostics（诊断信息）。
`/init`	在当前目录生成 `AGENTS.md` scaffold（脚手架）。	为 repository 或子目录沉淀 persistent instructions（持久指令）。
`/logout`	登出 Codex。	在共享机器上清理本地 credentials。
`/mcp`	列出已配置的 MCP tools。	检查当前 session 中 Codex 能调用哪些外部工具；加 `verbose` 查看 server 细节。
`/mention`	把文件附加到 conversation。	指定希望 Codex 接下来检查的文件或文件夹。
`/model`	选择 active model，以及可用时的 reasoning effort。	任务前在 general-purpose models 和 deeper reasoning models 之间切换。
`/fast`	切换支持模型的 Fast mode。	打开、关闭 Fast mode，或查看当前 thread 是否正在使用 Fast mode。
`/plan`	切换到 plan mode，并可附带 prompt。	在开始实现前，让 Codex 先给 execution plan（执行计划）。
`/personality`	设置 response communication style（沟通风格）。	不改系统指令，也能让 Codex 更简洁、更解释型或更协作。
`/ps`	查看 experimental background terminals 及最近输出。	不离开主 transcript，就能检查长时间命令状态。
`/stop`	停止所有 background terminals。	取消当前 session 启动的后台终端任务。
`/fork`	把当前 conversation fork 成新 thread。	不丢当前 transcript，同时探索另一种方案。
`/side`	开始 ephemeral side conversation（临时侧边对话）。	做一个聚焦追问，同时不打断 main thread 的 transcript。
`/resume`	从 session list 恢复 saved conversation。	从旧 CLI session 继续工作。
`/new`	在同一个 CLI session 中开始 new conversation。	不退出 CLI，也能重置 chat context。
`/quit`	退出 CLI。	立即离开当前 session。
`/review`	让 Codex review working tree。	Codex 完成工作后，或你想让它检查本地改动时使用。
`/status`	显示 session configuration 和 token usage。	确认 active model、approval policy、writable roots 和剩余 context。
`/debug-config`	打印 config layer 和 requirements diagnostics。	排查配置优先级和 policy requirements，包括 experimental network constraints。
`/statusline`	交互式配置 TUI status-line fields。	选择、排序 footer items，并持久化到 `config.toml`。
`/title`	配置 terminal window 或 tab title fields。	选择、排序 title items，例如 project、status、thread、branch、model、task progress。
`/keymap`	重映射 TUI keyboard shortcuts。	查看并持久化自定义快捷键到 `config.toml`。

/quit 和 /exit 都会退出 CLI。只有在重要工作已经保存或 commit 后再使用。

/approvals 仍然是可用 alias（别名），但不再出现在 slash popup list 中。

Control your session with slash commands

下面这些流程可以让你不中断 Codex，就把 active session 调整到正确状态。

Set the active model with `/model`

启动 Codex，打开 composer。
输入 /model，按 Enter。
从 popup 里选择模型，例如 gpt-4.1-mini 或 gpt-4.1。

预期结果：Codex 会在 transcript 中确认新模型。运行 /status 可以再次验证。

Toggle Fast mode with `/fast`

输入 /fast on、/fast off 或 /fast status。
如果你希望设置持久化，Codex 提示保存时确认更新。

预期结果：Codex 会报告当前 thread 的 Fast mode 是 on 还是 off。你也可以用 /statusline 在 TUI footer 中显示 Fast mode 状态项。

Set a communication style with `/personality`

/personality 可以在不重写 prompt 的情况下调整 Codex 的沟通方式。

在 active conversation 中输入 /personality，按 Enter。
从 popup 里选择 style。

预期结果：Codex 会在 transcript 中确认新 style，并在后续 responses 中使用。

Codex 支持 friendly、pragmatic 和 none。使用 none 可以关闭 personality instructions。

如果 active model 不支持 personality-specific instructions，Codex 会隐藏这个命令。

Switch to plan mode with `/plan`

输入 /plan 并按 Enter，把 active conversation 切到 plan mode。
可选：直接附带 inline prompt text，例如：

/plan Propose a migration plan for this service

使用 inline /plan arguments 时，你也可以粘贴内容或附加 images。

预期结果：Codex 进入 plan mode，并把你的可选 inline prompt 当作第一个 planning request。

当任务已经在运行时，/plan 会暂时不可用。

Toggle experimental features with `/experimental`

输入 /experimental 并按 Enter。
切换你想启用的 features，例如 Apps 或 Smart Approvals。如果提示需要 restart Codex，就按提示重启。

预期结果：Codex 会把 feature choices 保存到 config，并在重启后应用。

Clear the terminal and start a new chat with `/clear`

输入 /clear 并按 Enter。

预期结果：Codex 清空 terminal，重置可见 transcript，并在同一个 CLI session 中开始 fresh chat。

/clear 和 Ctrl+L 不同。/clear 会开始新 conversation；Ctrl+L 只清空 terminal view，并保留当前 chat。

当任务正在运行时，Codex 会禁用这两个动作。

Update permissions with `/permissions`

输入 /permissions 并按 Enter。
选择符合你风险偏好的 approval preset，例如 Auto 用于更自动化的执行，或 Read Only 用于只读 review。

预期结果：Codex 宣布 updated policy。之后的 actions 会遵守新 approval mode，直到你再次修改。

Copy the latest response with `/copy`

输入 /copy 并按 Enter。

预期结果：Codex 会把最新完成的 Codex output 复制到 clipboard（剪贴板）。

如果某一轮仍在运行，/copy 会使用 latest completed output，而不是进行中的 response。在第一个 Codex output 完成前，以及刚 rollback 后，这个命令不可用。

你也可以在 main TUI 中按 Ctrl+O，不打开 slash command menu 就复制最新完成的 response。

Grant sandbox read access with `/sandbox-add-read-dir`

这个命令只在 Windows 原生运行 CLI 时可用。

输入 /sandbox-add-read-dir C:\absolute\directory\path 并按 Enter。
确认该 path 是已存在的 absolute directory。

预期结果：Codex 刷新 Windows sandbox policy，并为后续 sandbox 内运行的命令授予该目录的 read access。

Inspect the session with `/status`

在任何 conversation 中输入 /status。
查看 active model、approval policy、writable roots 和 current token usage。

预期结果：你会看到类似 shell 中 codex status 的摘要，确认 Codex 正在你预期的位置运行。

Inspect config layers with `/debug-config`

输入 /debug-config。
查看 config layer order（配置层顺序，最低优先级在前）、on/off state 和 policy sources。

预期结果：Codex 打印 layer diagnostics 和 policy details，例如 allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency、experimental_network。

当 effective setting 和 config.toml 不一致时，用这个输出排查原因。

输入 /statusline。
在 picker 中 toggle（开关）和 reorder（排序）items，然后确认。

预期结果：footer status line 会立即更新，并持久化到 config.toml 的 tui.status_line。

可用 status-line items 包括：

model
model + reasoning
context stats
rate limits
git branch
token counters
session id
current directory / project root
Codex version

Configure terminal title items with `/title`

输入 /title。
在 picker 中 toggle 和 reorder items，然后确认。

预期结果：terminal window 或 tab title 会立即更新，并持久化到 config.toml 的 tui.terminal_title。

可用 title items 包括 app name、project、spinner、status、thread、git branch、model 和 task progress。

Remap TUI shortcuts with `/keymap`

/keymap 用于查看、更新并持久化 TUI keyboard shortcut bindings。

输入 /keymap。
选择要修改的 shortcut context 和 action。
输入新的 binding，或移除已有 binding。

预期结果：Codex 更新 active keymap，并把 custom binding 写入 config.toml 的 tui.keymap。

Key bindings 使用 ctrl-a、shift-enter、page-down 这类名称。Context-specific bindings 会覆盖 tui.keymap.global；空 binding list 会 unbind（解绑）该 action。

Check background terminals with `/ps`

输入 /ps。
查看 background terminals 列表和状态。

预期结果：Codex 展示每个 background terminal 的 command，以及最多三行最近的非空输出，方便你快速判断进度。

当 unified_exec 启用时会出现 background terminals；否则列表可能为空。

Stop background terminals with `/stop`

输入 /stop。
如果 Codex 在停止列出的 terminals 前要求确认，按提示确认。

预期结果：Codex 停止当前 session 的所有 background terminals。/clean 仍然可作为 /stop 的 alias。

Keep transcripts lean with `/compact`

长对话之后，输入 /compact。
Codex 提示总结目前 conversation 时，确认操作。

预期结果：Codex 用 concise summary（简洁摘要）替换早期 turns，释放 context，同时保留关键细节。

Review changes with `/diff`

输入 /diff 查看 Git diff。
在 CLI 中滚动输出，review edits 和 added files。

预期结果：Codex 显示 staged changes、unstaged changes，以及 Git 尚未开始 tracking 的文件，帮助你决定保留什么。

Highlight files with `/mention`

输入 /mention 加 path，例如：

/mention src/lib/api.ts

从 popup 中选择匹配结果。

预期结果：Codex 把该文件加入 conversation，确保后续 turns 会直接引用它。

Start a new conversation with `/new`

输入 /new 并按 Enter。

预期结果：Codex 在同一个 CLI session 中开始 fresh conversation，让你不用离开 terminal 就切换任务。

和 /clear 不同，/new 不会先清空当前 terminal view。

Resume a saved conversation with `/resume`

输入 /resume 并按 Enter。
从 saved-session picker 中选择要恢复的 session。

预期结果：Codex 重新加载所选 conversation 的 transcript，让你从之前的位置继续，并保留原始 history。

Fork the current conversation with `/fork`

输入 /fork 并按 Enter。

预期结果：Codex 把当前 conversation clone 成一个带 fresh ID 的 new thread。原始 transcript 不会被修改，你可以并行探索 alternative approach（替代方案）。

如果你要 fork saved session，而不是当前 session，在 terminal 里运行：

codex fork

然后从 session picker 中选择。

Start a side conversation with `/side`

/side 会从当前 conversation 开一个 ephemeral fork（临时分支），但不会切走 main task。

输入 /side 打开 side conversation。
可选：添加 inline text，例如：

/side Check whether this plan has an obvious risk

聚焦问题处理完后，回到 parent thread。

预期结果：Codex 打开一个 transcript 独立于 parent thread 的 side conversation。在 side mode 中，TUI 仍会显示 parent-thread status，所以你能看到 main task 是否仍在运行。

/side 在另一个 side conversation 内不可用，review mode 期间也不可用。

Generate `AGENTS.md` with `/init`

在希望 Codex 查找 persistent instructions 的目录运行 /init。
Review 生成的 AGENTS.md，再按 repository conventions（仓库约定）修改它。

预期结果：Codex 创建一个 AGENTS.md scaffold，你可以继续完善，并 commit 给未来 sessions 使用。

Ask for a working tree review with `/review`

输入 /review。
如果你想检查确切文件变化，再跟进 /diff。

预期结果：Codex 总结它在 working tree 中发现的问题，重点关注 behavior changes（行为变化）和 missing tests（缺失测试）。除非你在 config.toml 中设置了 review_model，否则它使用当前 session model。

List MCP tools with `/mcp`

输入 /mcp。
查看列表，确认当前有哪些 MCP servers 和 tools 可用。

预期结果：你会看到本 session 中 Codex 可以调用的 Model Context Protocol (MCP) tools。

使用 /mcp verbose 可以包含详细 server diagnostics。如果传入的不是 verbose，Codex 会显示 command usage。

Browse apps with `/apps`

输入 /apps。
从列表中选择 app。

预期结果：Codex 把 app mention 以 $app-slug 插入 composer，这样你可以立刻要求 Codex 使用它。

Browse plugins with `/plugins`

输入 /plugins。
选择 marketplace tab，然后选择 plugin，查看它的 capabilities（能力）或 available actions（可用动作）。

预期结果：Codex 打开 plugin browser，你可以 review installed plugins、配置允许发现的 discoverable plugins，以及 installed plugin state。在已安装 plugin 上按 Space 可以切换 enabled state。

Switch agent threads with `/agent`

输入 /agent 并按 Enter。
从 picker 中选择 thread。

预期结果：Codex 切换 active thread，这样你可以 inspect（检查）或 continue（继续）该 agent 的工作。

Send feedback with `/feedback`

输入 /feedback 并按 Enter。
按提示包含 logs 或 diagnostics。

预期结果：Codex 收集所需 diagnostics，并提交给 maintainers。

Sign out with `/logout`

输入 /logout 并按 Enter。

预期结果：Codex 清除当前 user session 的 local credentials。

Exit the CLI with `/quit` or `/exit`

输入 /quit 或 /exit，按 Enter。

预期结果：Codex 立即退出。退出前先保存或 commit 重要工作。