跳到主要内容

本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/cli/slash-commands

Codex CLI 中的斜杠命令

在交互式会话期间控制 Codex

斜杠命令让你可以通过快速、以键盘为主的方式控制 Codex。在输入框中键入 / 以打开斜杠弹窗，选择一个命令后，Codex 就会执行诸如切换模型、调整权限或总结长对话之类的操作，而无需离开终端。

本指南将向你展示如何：

  • 为任务找到合适的内置斜杠命令
  • 使用 /model、/fast、/personality、/permissions、/approve、/raw、/agent 和 /status 等命令引导当前会话

内置斜杠命令​

Codex 附带以下命令。打开斜杠弹窗并开始输入命令名称，以筛选列表。

当某个任务已经在运行时，你可以输入斜杠命令并按 Tab，将其加入下一轮的队列。Codex 会在这些已排队的斜杠命令运行时对其进行解析，因此命令菜单和错误会在当前轮完成后出现。在你将命令加入队列之前，斜杠补全仍然可用。

CommandPurposeWhen to use it
/permissions设置 Codex 无需事先询问即可执行的操作。在会话中途放宽或收紧批准要求，例如在 Auto 和 Read Only 之间切换。
/ide包含打开的文件、当前选择内容和其他 IDE 上下文。将编辑器上下文拉入下一条提示中，而无需重新说明 IDE 中当前打开了什么。
/keymap重新映射 TUI 键盘快捷键。检查并将自定义快捷键绑定持久化到 config.toml 中。
/vim为输入框切换 Vim 模式。在 Vim normal/insert 行为与默认输入框编辑模式之间切换。
/sandbox-add-read-dir授予沙箱对额外目录的读取权限（仅限 Windows）。解除对需要读取当前可读根目录之外的绝对目录路径的命令的阻塞。
/agent切换活动 agent 线程。检查或继续在已生成的 subagent 线程中的工作。
/apps浏览 apps（连接器）并将其插入到提示中。在要求 Codex 使用某个 app 之前，将其作为 $app-slug 附加。
/plugins浏览已安装和可发现的插件。检查插件工具、安装建议的插件，或管理插件可用性。
/hooks审查生命周期 hooks。检查已配置的 hooks、信任新的或已更改的 hooks，或在其运行前禁用非托管 hooks。
/clear清空终端并开始新的聊天。当你想重新开始时，同时重置可见 UI 和对话。
/compact总结可见对话以释放 token。在长时间运行后使用，这样 Codex 能保留关键点而不会撑爆上下文窗口。
/copy复制最近一次已完成的 Codex 输出。获取最近完成的响应或计划文本，而无需手动选择。你也可以按 Ctrl+O。
/diff显示 Git diff，包括 Git 尚未跟踪的文件。在提交或运行测试之前审查 Codex 的编辑。
/exit退出 CLI（与 /quit 相同）。另一种拼写；两个命令都会退出会话。
/experimental切换实验性功能。从 CLI 启用诸如 subagents 之类的可选功能。
/approve批准对最近一次自动审查拒绝进行一次重试。重试被自动审查器拒绝的命令或操作。
/memories配置 memory 的使用和生成。无需离开 TUI 即可开启或关闭 memory 注入或 memory 生成。
/skills浏览并使用 Skills。通过选择相关的本地 skill 改进特定任务的行为。
/hooks查看并管理生命周期 hooks。检查已加载到当前会话中的 hook 配置。
/feedback将日志发送给 Codex 维护者。报告问题或与支持团队共享诊断信息。
/init在当前目录中生成一个 AGENTS.md 脚手架。为你正在处理的仓库或子目录记录持久化指令。
/logout退出 Codex 登录。在使用共享机器时清除本地凭据。
/mcp列出已配置的 Model Context Protocol (MCP) 工具。检查 Codex 在当前会话期间可调用哪些外部工具；添加 verbose 可查看服务器详细信息。
/mention将文件附加到对话中。让 Codex 关注你希望它接下来检查的特定文件或文件夹。
/model选择活动模型（以及在可用时的推理强度）。在运行任务之前，在通用模型（gpt-4.1-mini）和更深度推理模型之间切换。
/fast当模型目录提供 Fast 服务层级时进行切换。打开或关闭当前模型的 Fast 层级，或检查线程是否正在使用它。
/plan切换到计划模式，并可选择发送提示。在实现工作开始之前，要求 Codex 提出执行计划。
/goal设置、暂停、恢复、查看或清除任务目标。在较大任务运行期间，为 Codex 提供一个可持续跟踪的目标。需要 features.goals。
/personality为响应选择一种沟通风格。无需更改你的指令，即可让 Codex 更简洁、更具解释性或更具协作性。
/ps显示实验性的后台终端及其最近输出。无需离开主转录内容即可检查长时间运行的命令。
/stop停止所有后台终端。取消当前会话启动的后台终端工作。
/fork将当前对话分叉到新线程中。在不丢失当前转录内容的情况下分支当前会话，以探索新方法。
/side启动一个临时的侧边对话。提出一个聚焦的后续问题，而不干扰主线程的转录内容。
/raw切换原始回滚模式。在查看长输出时，使终端选择和复制的格式化程度更低。
/resume从会话列表中恢复已保存的对话。从之前的 CLI 会话继续工作，而无需重新开始。
/new在同一个 CLI 会话中开始新的对话。当你想在同一仓库中使用新的提示时，无需离开 CLI 即可重置聊天上下文。
/quit退出 CLI。立即离开会话。
/review让 Codex 审查你的工作树。在 Codex 完成工作后运行，或当你希望有人帮你再检查一遍本地更改时使用。
/status显示会话配置和 token 使用情况。确认当前活动模型、批准策略、可写根目录以及剩余上下文容量。
/debug-config打印配置层和 requirements 诊断信息。调试优先级和策略 requirements，包括实验性的网络约束。
/statusline以交互方式配置 TUI 状态行字段。选择并重新排序页脚项（model/context/limits/git/tokens/session），并持久化到 config.toml 中。
/title以交互方式配置终端窗口或标签页标题字段。选择并重新排序标题项，例如 project、status、thread、branch、model 和 task progress。
/theme选择语法高亮主题。预览并持久化终端语法高亮主题。

/quit 和 /exit 都会退出 CLI。仅在你已经保存或提交了所有重要工作后再使用它们。

使用 /permissions 来调整 Codex 在无需事先询问的情况下可以执行的操作。仅当你需要重试一个被自动审核拒绝的近期操作时，才使用 /approve。

使用斜杠命令控制你的会话​

以下工作流可让你的会话保持在正确轨道上，而无需重启 Codex。

使用 /model 设置活动模型​

  1. 启动 Codex 并打开 composer。
  2. 输入 /model 并按 Enter。
  3. 在弹出窗口中选择一个模型，例如 gpt-4.1-mini 或 gpt-4.1。

预期结果：Codex 会在对话记录中确认新模型。运行 /status 以验证更改。

使用 /fast 切换 Fast 模式​

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

预期结果：Codex 会报告当前模型的 Fast 服务层级在当前线程中是开启还是关闭。在 TUI 页脚中，你也可以通过 /statusline 显示一个 Fast 模式状态行项目。

Fast 层级命令由目录驱动。如果当前模型未声明 Fast 层级，Codex 将不会显示 /fast。

使用 /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 会暂时不可用。

使用 /goal 设置实验性目标​

/goal 是实验性功能，仅在启用 features.goals 时可用。要启用它，请打开 /experimental，或在 config.toml 的 [features] 下添加 goals = true。

  1. 输入 /goal 以设置目标，例如 /goal Finish the migration and keep tests green。
  2. 输入 /goal 以查看当前目标。
  3. 使用 /goal pause、/goal resume 或 /goal clear 来暂停、恢复或移除目标。

预期结果：Codex 会在工作继续进行时，将该目标附加到当前活动线程。

目标内容必须非空，且最多 4,000 个字符。对于更长的说明，请将详细内容放入文件中，并让目标指向该文件。

使用 /experimental 切换实验性功能​

  1. 输入 /experimental 并按 Enter。
  2. 切换你想要的功能（例如 Apps 或 Smart Approvals），然后如果提示要求你这样做，请重启 Codex。

预期结果：Codex 会将你的功能选择保存到配置中，并在重启时应用。

使用 /approve 批准一次自动审核拒绝​

当自动审核器拒绝了某个近期操作，而你希望 Codex 重试一次时，使用 /approve。

  1. 输入 /approve。
  2. 当 Codex 显示相关被拒绝的操作时，确认重试。

预期结果：Codex 会在当前会话策略下重试该被拒绝的操作一次。

使用 /memories 配置 memories​

  1. 输入 /memories。
  2. 选择 Codex 是应使用现有 memories、生成新的 memories，还是保持 memory 行为为禁用状态。

预期结果：Codex 会更新相关的 memory 设置，用于未来会话。

使用 /skills 使用 Skills​

  1. 输入 /skills。
  2. 选择你希望 Codex 应用的 skill。

预期结果：Codex 会插入所选 skill 的上下文，使下一个请求遵循该 skill 的指令。

使用 /hooks 查看生命周期 hooks​

  1. 输入 /hooks。
  2. 查看已加载的生命周期 hook 配置。

预期结果：Codex 会显示当前会话中可运行的 hooks。

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

  1. 输入 /clear 并按 Enter。

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

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

Ctrl+L 只会清空终端视图，并保留当前聊天。当任务进行中时，Codex 会禁用这两种操作。

使用 /permissions 更新权限​

  1. 输入 /permissions 并按 Enter。
  2. 选择与你的舒适程度匹配的批准预设，例如适合放手运行的 Auto，或用于审查编辑的 Read Only。

预期结果：Codex 会宣布更新后的策略。未来操作将遵循更新后的批准模式，直到你再次更改它。

使用 /ide 包含 IDE 上下文​

  1. 输入 /ide。
  2. 如果你想说明 Codex 应如何处理当前 IDE 选区或打开的文件，可添加可选的内联文本。

预期结果：Codex 会在下一条提示中包含可用的 IDE 上下文。

使用 /vim 切换 Vim 模式​

  1. 输入 /vim。
  2. 继续在 composer 中编辑。

预期结果：Codex 会为当前会话切换 composer 的 Vim 模式。要使 Vim 模式成为新会话的默认设置，请在 config.toml 中设置 tui.vim_mode_default = true。

使用 /copy 复制最新响应​

  1. 输入 /copy 并按 Enter。

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

如果当前轮次仍在运行，/copy 会使用最近一次已完成的输出，而不是正在进行中的响应。在第一次完成的 Codex 输出之前，以及在回滚之后紧接着，此命令不可用。

你也可以在主 TUI 中按 Ctrl+O，在不打开斜杠命令菜单的情况下复制最近一次已完成的响应。

使用 /raw 切换原始滚动回溯​

  1. 输入 /raw、/raw on 或 /raw off。

预期结果：Codex 会切换原始滚动回溯模式，这会让终端中的选择和复制更加直接。你也可以使用默认的 Alt+R 绑定，或通过设置 tui.raw_output_mode = true 来持久化该默认值。

使用 /sandbox-add-read-dir 授予 sandbox 读取权限​

此命令仅在 Windows 上以原生方式运行 CLI 时可用。

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

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

使用 /status 检查会话​

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

预期结果：你会看到类似于 shell 中 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 不同。

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

预期结果：页脚状态行会立即更新，并持久保存到 config.toml 中的 tui.status_line。

可用的状态行项目包括模型、模型+reasoning、上下文统计、速率限制、git 分支、token 计数器、session id、当前目录/项目根目录以及 Codex 版本。

使用 /title 配置终端标题项目​

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

预期结果：终端窗口或标签页标题会立即更新，并持久保存到 config.toml 中的 tui.terminal_title。

可用的标题项目包括应用名称、项目、spinner、状态、线程、git 分支、模型和任务进度。

使用 /theme 选择语法主题​

  1. 输入 /theme。
  2. 在选择器中预览主题，然后确认。

预期结果：Codex 会更新语法高亮，并将选择持久保存到 config.toml 中的 tui.theme。

使用 /keymap 重新映射 TUI 快捷键​

使用 /keymap 来检查、更新并持久保存 TUI 的键盘快捷键绑定。

  1. 输入 /keymap。
  2. 选择你想更改的快捷键上下文和操作。
  3. 输入新的绑定，或移除现有绑定。

预期结果：Codex 会更新活动 keymap，并将自定义绑定写入 config.toml 中的 tui.keymap。

按键绑定使用诸如 ctrl-a、shift-enter 和 page-down 之类的名称。特定上下文的绑定会覆盖 tui.keymap.global；空绑定列表会取消该操作的绑定。

使用 /ps 检查后台终端​

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

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

当使用 unified_exec 时会出现后台终端；否则，列表可能为空。

使用 /stop 停止后台终端​

  1. 输入 /stop。
  2. 如果 Codex 在停止列出的终端前请求确认，请进行确认。

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

使用 /compact 保持转录精简​

  1. 在一段较长的交流后，输入 /compact。
  2. 当 Codex 提议总结目前为止的对话时，进行确认。

预期结果：Codex 会用简明摘要替换较早的轮次，在保留关键信息的同时释放上下文。

使用 /diff 审查更改​

  1. 输入 /diff 以检查 Git diff。
  2. 在 CLI 内滚动输出以审查编辑内容和新增文件。

预期结果：Codex 会显示你已暂存的更改、尚未暂存的更改，以及 Git 尚未开始跟踪的文件，以便你决定保留哪些内容。

使用 /mention 高亮文件​

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

预期结果：Codex 会将该文件添加到对话中，确保后续轮次会直接引用它。

使用 /new 开始新对话​

  1. 输入 /new 并按 Enter。

预期结果：Codex 会在同一个 CLI 会话中启动一段全新的对话，这样你就可以在不离开终端的情况下切换任务。

与 /clear 不同，/new 不会先清除当前终端视图。

使用 /resume 恢复已保存的对话​

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

预期结果：Codex 会重新加载所选对话的转录内容，让你可以从中断处继续，同时保留原始历史记录不变。

使用 /fork 分叉当前对话​

  1. 输入 /fork 并按 Enter。

预期结果：Codex 会将当前对话克隆为一个带有全新 ID 的新线程，原始转录内容保持不变，因此你可以并行探索另一种方案。

如果你需要分叉的是已保存会话而不是当前会话，请在终端中运行 codex fork 以打开会话选择器。

使用 /side 开始侧边对话​

使用 /side 可从当前对话开始一个临时分叉，而无需切换离开主任务。

  1. 输入 /side 以打开侧边对话。
  2. 可选地添加内联文本，例如 /side Check whether this plan has an obvious risk。
  3. 在聚焦的短暂分支结束后，返回父线程。

预期结果：Codex 会打开一个转录内容与父线程分离的侧边对话。当你处于 side 模式时，TUI 会继续显示父线程状态，这样你就能看到主任务是否仍在运行。

/side 在另一个侧边对话内以及 review 模式期间不可用。

使用 /init 生成 AGENTS.md​

  1. 在你希望 Codex 查找持久化指令的目录中运行 /init。
  2. 审查生成的 AGENTS.md，然后编辑它以符合你的仓库约定。

预期结果：Codex 会创建一个 AGENTS.md 脚手架，你可以进一步完善并提交，以供未来会话使用。

使用 /review 请求工作树审查​

  1. 输入 /review。
  2. 如果你想检查精确的文件更改，可继续使用 /diff。

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

使用 /mcp 列出 MCP 工具​

  1. 输入 /mcp。
  2. 审查列表以确认哪些 MCP 服务器和工具可用。

预期结果：你会看到为此会话配置的、Codex 可调用的 Model Context Protocol (MCP) 工具。

使用 /mcp verbose 可包含详细的服务器诊断信息。如果你传入除 verbose 之外的任何内容，Codex 会显示命令用法。

使用 /apps 浏览应用​

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

预期结果：Codex 会将应用提及插入到编辑器中，格式为 $app-slug，这样你就可以立即要求 Codex 使用它。

使用 /plugins 浏览插件​

  1. 输入 /plugins。
  2. 选择一个 marketplace 标签页，然后选择一个插件以检查其功能或可用操作。

预期结果：Codex 会打开插件浏览器，以便你审查已安装的插件、你的配置所允许发现的插件，以及已安装插件的状态。 在已安装插件上按 Space 可切换其启用状态。

使用 /hooks 审查 hooks​

  1. 输入 /hooks。
  2. 选择一个 hook 事件以检查匹配的处理程序。
  3. 根据需要信任、禁用或重新启用非托管 hooks。

预期结果：Codex 会打开 hook 浏览器，以便你审查已配置的生命周期 hooks。托管 hooks 会显示为托管，且不能从用户 hook 浏览器中禁用。

使用 /agent 切换 agent 线程​

  1. 输入 /agent 并按 Enter。
  2. 从选择器中选择你想要的线程。

预期结果：Codex 会切换活动线程，以便你检查或继续该 agent 的工作。

使用 /feedback 发送反馈​

  1. 输入 /feedback 并按 Enter。
  2. 按照提示包含日志或诊断信息。

预期结果：Codex 会收集所请求的诊断信息并将其提交给维护者。

使用 /logout 退出登录​

  1. 输入 /logout 并按 Enter。

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

使用 /quit 或 /exit 退出 CLI​

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

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