OpenAI Codex 中文文档（4.14更新）
联系我 ↗
官方文档 ↗

Codex CLI 中的斜杠命令

在交互会话中即时控制 Codex

斜杠命令让你可以用键盘优先的方式快速控制 Codex。在输入框中输入 / 会打开斜杠命令弹出菜单；选中某个命令后，Codex 就能在不离开终端的情况下执行切换模型、调整权限、压缩长对话等操作。

本页会说明如何：

  • 找到适合当前任务的内置斜杠命令
  • 用 /model、/fast、/personality、/permissions、/agent、/status 等命令调整正在进行中的会话

内置斜杠命令

Codex 内置了以下命令。打开斜杠命令弹出菜单后，开始输入命令名即可过滤列表。

命令 用途 何时使用
/permissions 设置 Codex 在不先询问的情况下可以做什么。 想在会话中途放宽或收紧审批要求时，例如在 Auto 和 Read Only 之间切换。
/sandbox-add-read-dir 为额外目录授予沙箱读权限（仅 Windows）。 某些命令需要读取当前可读根目录之外的绝对路径时，用它解锁。
/agent 切换当前激活的智能体线程。 想查看或继续某个已生成的子智能体线程时。
/apps 浏览 Apps（连接器），并把它们插入提示词。 想先把某个 App 以 $app-slug 的形式附加进提示词，再让 Codex 调用它时使用。
/plugins 浏览已安装和可发现的插件。 想检查插件工具、安装建议插件，或管理哪些插件可用时使用。
/clear 清空终端，并开始一个新聊天。 想同时重置可见 UI 和当前对话时。
/compact 总结当前可见对话，以释放 token。 长会话后压缩对话记录，保留重点并腾出上下文空间。
/copy 复制最近一次已完成的 Codex 输出。 想直接拿到最近一条完成回复或计划文本，而不手动选中复制。
/diff 显示 Git diff，包括 Git 尚未追踪的文件。 在提交或运行测试前，先审查 Codex 改了什么。
/exit 退出 CLI（等价于 /quit）。 作为 /quit 的另一种写法使用；两者都会直接退出会话。
/experimental 切换实验性功能。 想在 CLI 中开启可选能力，例如子智能体。
/feedback 向 Codex 维护团队发送日志。 想报告问题或分享诊断信息时。
/init 在当前目录生成 AGENTS.md 骨架。 想为仓库或子目录留下长期生效的操作指令时。
/logout 退出 Codex 登录状态。 在共享机器上清理本地凭据。
/mcp 列出已配置的 Model Context Protocol（MCP）工具。 想确认本会话可用的外部工具能力时。
/mention 把文件附加到当前对话。 想让 Codex 下一步重点查看某个文件或目录。
/model 选择当前使用的模型，以及可用时的推理强度。 在执行任务前切换模型，例如在通用模型和深度推理模型之间切换。
/fast 为 GPT-5.4 切换 Fast mode。 打开 / 关闭 Fast mode，或检查当前线程是否处于 Fast mode。
/plan 切换到规划模式，并可选择立即附带一条提示词。 想先让 Codex 给出执行计划，再进入实现阶段时。
/personality 设定响应风格。 想让 Codex 更简洁、更解释型，或更偏协作式，而不改写原提示词。
/ps 查看实验性的后台终端及其最近输出。 想不离开主对话记录就查看长任务进度时。
/stop 停止所有后台终端。 想取消当前会话启动的后台终端任务时。
/fork 把当前对话分叉成新线程。 想在不丢失当前对话记录的情况下平行探索另一种做法。
/resume 从 session 列表中恢复某个已保存对话。 想继续之前的 CLI 会话，而不从头开始时。
/new 在同一个 CLI 会话里开启一个新对话。 想在同一仓库中切换新任务，但不退出 CLI。
/quit 退出 CLI。 想立即离开当前会话时。
/review 让 Codex 审查当前工作树。 当 Codex 完成任务后，或你想让它再看一遍本地改动时。
/status 显示当前会话配置和 token 使用情况。 用来确认当前模型、审批策略、可写目录和上下文余量。
/debug-config 打印配置层叠与 requirements 诊断信息。 需要排查配置优先级、策略要求或实验性网络约束时。
/statusline 交互式配置 TUI 底部状态栏项。 想挑选并重排底部状态栏中显示的 model / context / limits / git / tokens / session 等信息时。
/title 交互式配置终端窗口或标签标题项。 想把项目、状态、线程、分支、模型或任务进度等信息显示到终端标题中时。

/quit 和 /exit 都会退出 CLI。退出前请确认你已经保存或提交了重要工作。

/approvals 仍可作为别名使用，但它不会再出现在斜杠命令弹出菜单里。

用斜杠命令控制当前会话

下面这些工作流可以帮助你在不重启 Codex 的情况下持续调整会话。

用 /model 设置当前模型

  1. 启动 Codex 并打开输入框。
  2. 输入 /model 并按 Enter。
  3. 从弹出菜单中选择 gpt-4.1-mini、gpt-4.1 等模型。

预期结果：Codex 会在对话记录中确认模型已切换。你也可以运行 /status 再确认一次。

用 /fast 切换 Fast mode

  1. 输入 /fast on、/fast off 或 /fast status。
  2. 如果你希望这个设置持久生效，可以在 Codex 提示保存更新时确认。

预期结果：Codex 会说明当前线程是否开启 Fast mode。在 TUI 底部状态栏中，你也可以用 /statusline 显示 Fast mode 的状态项。

用 /personality 设置沟通风格

使用 /personality 可以在不重写提示词的情况下调整 Codex 的表达方式。

  1. 在当前对话中输入 /personality 并按 Enter。
  2. 从弹出菜单中选择一种风格。

预期结果：Codex 会在对话记录中确认新的风格，并在后续回复中持续采用它。

Codex 支持 friendly、pragmatic 和 none 三种 personality。使用 none 可关闭 personality 指令。

如果当前模型不支持 personality 专用指令，Codex 会隐藏这个命令。

用 /plan 切换到规划模式

  1. 输入 /plan 并按 Enter，把当前对话切换到规划模式。
  2. 你也可以直接附带一段内联提示词，例如 /plan Propose a migration plan for this service。
  3. 使用内联 /plan 参数时，你也可以粘贴内容或附加图片。

预期结果：Codex 会进入规划模式，并把你可选提供的内联提示词作为第一条规划请求。

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

用 /experimental 切换实验性功能

  1. 输入 /experimental 并按 Enter。
  2. 切换你想启用的功能，例如 Apps 或 Smart Approvals；如果 Codex 提示需要重启，则按提示执行。

预期结果：Codex 会把你的功能选择写入配置，并在重启后生效。

用 /clear 清空终端并开始新聊天

  1. 输入 /clear 并按 Enter。

预期结果：Codex 会清空终端、重置当前可见的对话记录，并在同一个 CLI 会话中启动一个全新的聊天。

与 Ctrl+L 不同，/clear 会开启一个新对话。

Ctrl+L 只会清空终端显示，不会清空当前聊天。任务运行中时，这两个动作都会被禁用。

用 /permissions 更新权限

  1. 输入 /permissions 并按 Enter。
  2. 选择与你当前风险偏好匹配的审批预设，例如无人值守运行时可选 Auto，想先审查改动时可选 Read Only。

预期结果：Codex 会公布新的策略，后续动作都会遵守更新后的审批模式，直到你再次修改。

用 /copy 复制最新回复

  1. 输入 /copy 并按 Enter。

预期结果：Codex 会把最近一条已完成的输出复制到剪贴板。

如果当前 turn 仍在运行，/copy 会复制最近一条已完成的输出，而不是正在生成中的回复。在第一条完整输出产生之前，以及 rollback 刚结束后，这个命令不可用。

用 /sandbox-add-read-dir 授予沙箱读权限

这个命令只在 Windows 原生 CLI 中可用。

  1. 输入 /sandbox-add-read-dir C:\absolute\directory\path 并按 Enter。
  2. 确认该路径是一个存在的绝对目录。

预期结果：Codex 会刷新 Windows 沙箱策略，并为后续在沙箱中运行的命令授予该目录的读权限。

用 /status 查看当前会话

  1. 在任意对话中输入 /status。
  2. 查看输出中的当前模型、审批策略、可写根目录和 token 使用情况。

预期结果：你会看到一段类似 codex status 的摘要，用来确认 Codex 正在你预期的位置和配置下运行。

用 /debug-config 查看配置层

  1. 输入 /debug-config。
  2. 查看输出中的配置层顺序、启用状态和策略来源。

预期结果：Codex 会打印各层配置诊断，以及策略细节，例如 allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency 和 experimental_network（若已配置）。

当某个生效设置与你在 config.toml 中看到的不一致时，这份输出很适合拿来排查原因。

用 /statusline 配置底部状态栏项目

  1. 输入 /statusline。
  2. 用选择器切换并重排项目，然后确认。

预期结果：底部状态栏会立刻更新，并把配置持久写入 config.toml 中的 tui.status_line。

可显示的状态栏项包括 model、model+reasoning、context 统计、rate limits、Git branch、token 计数、session id、当前目录 / 项目根，以及 Codex 版本。

用 /title 配置终端标题项

  1. 输入 /title。
  2. 用选择器切换并重排项目，然后确认。

预期结果：终端窗口或标签标题会立刻更新，并把配置持久写入 config.toml 中的 tui.terminal_title。

可显示的标题项包括 app 名称、项目、spinner、状态、线程、Git branch、model 和任务进度。

用 /ps 查看后台终端

  1. 输入 /ps。
  2. 查看后台终端列表及其状态。

预期结果：Codex 会展示每个后台终端的命令，以及最多三行最近、非空输出，方便你快速判断进度。

只有在启用了 unified_exec 时才会出现后台终端；否则列表可能为空。

用 /stop 停止后台终端

  1. 输入 /stop。
  2. 如果 Codex 在停止前要求确认，就按提示确认。

预期结果：Codex 会停止当前会话中的所有后台终端。/clean 仍可作为 /stop 的别名使用。

用 /compact 精简对话记录

  1. 在一次较长的对话后输入 /compact。
  2. 当 Codex 提示是否要总结当前对话时，确认即可。

预期结果：Codex 会用一段简洁摘要替换较早的 turns，在保留关键细节的同时释放上下文。

用 /diff 审查改动

  1. 输入 /diff 查看 Git diff。
  2. 在 CLI 内滚动输出，审查改动和新增文件。

预期结果：Codex 会显示已暂存的改动、未暂存的改动，以及 Git 尚未开始追踪的文件，帮助你决定要保留什么。

用 /mention 高亮文件

  1. 输入 /mention 后跟路径，例如 /mention src/lib/api.ts。
  2. 从弹出菜单中选择匹配结果。

预期结果：Codex 会把该文件加入当前对话，使后续 turn 能直接引用它。

用 /new 开启新对话

  1. 输入 /new 并按 Enter。

预期结果：Codex 会在同一个 CLI 会话中开启一个全新对话，让你无需退出终端就能切换到另一项任务。

与 /clear 不同，/new 不会先清空当前终端显示。

用 /resume 恢复已保存对话

  1. 输入 /resume 并按 Enter。
  2. 从保存的会话选择器中选中你要恢复的对话。

预期结果：Codex 会载入你所选对话的完整记录，让你从原来的进度继续，而不会丢掉历史内容。

用 /fork 分叉当前对话

  1. 输入 /fork 并按 Enter。

预期结果：Codex 会把当前对话复制成一个带有新 ID 的线程，原始对话记录保持不变，因此你可以并行探索另一种方案。

如果你要 fork 的不是当前对话，而是某个已保存 session，请在终端中运行 codex fork，打开 session picker。

用 /init 生成 AGENTS.md

  1. 在你希望 Codex 查找长期指令的目录中运行 /init。
  2. 查看生成的 AGENTS.md，再按仓库约定继续编辑。

预期结果：Codex 会创建一个可继续完善并提交、供后续会话使用的 AGENTS.md 骨架。

用 /review 审查工作树

  1. 输入 /review。
  2. 如果你还想查看精确的文件改动，可继续运行 /diff。

预期结果：Codex 会总结它在当前工作树中发现的问题，重点关注行为变化与缺失测试。默认使用当前 session 的 model，除非你在 config.toml 中单独设置了 review_model。

用 /mcp 列出 MCP 工具

  1. 输入 /mcp。
  2. 查看列表，确认当前有哪些 MCP 服务端和工具可用。

预期结果：你会看到当前会话中 Codex 可调用的 MCP 工具列表。

用 /apps 浏览 Apps

  1. 输入 /apps。
  2. 从列表中选择一个 App。

预期结果：Codex 会把 App mention 以 $app-slug 的形式插入输入框，这样你就可以立刻要求 Codex 调用它。

用 /plugins 浏览插件

  1. 输入 /plugins。
  2. 从列表中选择某个插件，查看它的能力或可用动作。

预期结果：Codex 会打开插件浏览器，让你查看已安装插件，以及当前配置允许发现的插件。

用 /agent 切换智能体线程

  1. 输入 /agent 并按 Enter。
  2. 从选择器中选中你要查看或继续的线程。

预期结果：Codex 会切换当前激活线程，让你查看或继续该智能体的工作。

用 /feedback 发送反馈

  1. 输入 /feedback 并按 Enter。
  2. 按提示选择是否附带日志或其他诊断信息。

预期结果：Codex 会收集所需诊断信息，并把它提交给维护团队。

用 /logout 退出登录

  1. 输入 /logout 并按 Enter。

预期结果：Codex 会清除当前用户会话在本地保存的凭据。

用 /quit 或 /exit 退出 CLI

  1. 输入 /quit 或 /exit 并按 Enter。

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

来源：https://developers.openai.com/codex/cli/slash-commands