English
主导航

推荐
API 仪表板

Codex CLI 中的斜杠命令

在交互式会话中控制 Codex

斜杠命令为你提供了对 Codex 快速、优先使用键盘的控制。在编辑器中输入 / 即可打开斜杠弹出窗口，选择一个命令，Codex 将执行诸如切换模型、调整权限或总结长对话等操作，而无需离开终端。

本指南将向你展示如何：

  • 找到适合某项任务的内置斜杠命令
  • 使用命令引导活跃会话，例如 /model, /fast, /personality, /permissions, /approve, /raw, /agent，且 /status

内置斜杠命令

Codex 附带以下命令。打开斜杠弹出窗口并开始输入命令名称即可过滤列表。

当任务已在运行时，你可以输入斜杠命令并按 Tab 将其排队至下一轮。Codex 在运行时会解析排队的斜杠命令，因此命令菜单和错误将在当前轮次结束后显示。斜杠补全在排队命令之前依然有效。

命令目的何时使用
/permissions设置 Codex 无需事先询问即可执行的操作。在会话中放宽或收紧批准要求，例如在“自动”和“只读”模式之间切换。
/ide包含打开的文件、当前选区及其他 IDE 上下文。将编辑器上下文引入下一个提示词，无需重新解释 IDE 中打开的内容。
/keymap重新映射 TUI 键盘快捷键。在 config.toml.
/vim中检查并保留自定义快捷键绑定为编辑器切换 Vim 模式。
/sandbox-add-read-dir在 Vim 普通/插入模式与默认编辑器编辑模式之间切换。授予沙盒对额外目录的读取权限（仅限 Windows）。
/agent解除对需要读取当前可读根目录之外的绝对目录路径的命令的阻止。切换活跃代理线程。
/apps在生成的子代理线程中检查或继续工作。浏览应用（连接器）并将其插入到你的提示词中。 $app-slug 在要求 Codex 使用应用之前，将其附加为
/plugins浏览已安装和可发现的插件。检查插件工具，安装推荐插件，或管理插件的可用性。
/hooks查看生命周期钩子。检查已配置的钩子，信任新增或已更改的钩子，或在非托管钩子运行前将其禁用。
/clear清除终端并开启一段新对话。当你想重新开始时，同时重置可见 UI 和对话。
/compact总结当前可见的对话以释放 token。在长时间运行后使用，以便 Codex 保留要点而不撑爆上下文窗口。
/copy复制最新完成的 Codex 输出。无需手动选择，即可抓取最新完成的回复或计划文本。你还可以按 Ctrl+O.
/diff显示 Git diff，包含 Git 尚未跟踪的文件。在提交或运行测试之前，审查 Codex 的编辑内容。
/exit退出 CLI (同 /quit).另一种拼写方式；两条命令均可退出会话。
/experimental切换实验性功能。从 CLI 中启用可选功能，例如 subagents。
/approve批准对最近一次自动审查拒绝的重试。重试被自动审查拒绝的命令或操作。
/memories配置记忆的使用和生成。无需离开 TUI 即可开启或关闭记忆注入或记忆生成。
/skills浏览并使用技能。通过选择相关的本地技能来改善特定任务的表现。
/hooks查看并管理生命周期钩子。检查加载到当前会话中的钩子配置。
/feedback将日志发送给 Codex 维护人员。向支持团队报告问题或分享诊断信息。
/init生成一个 AGENTS.md 在当前目录中的脚手架。为你当前工作的代码库或子目录捕获持久化指令。
/logout退出登录 Codex。在使用公共机器时清除本地凭据。
/mcp列出已配置的模型上下文协议 (MCP) 工具。检查 Codex 在会话期间可以调用哪些外部工具；添加 verbose for server details.
/mention将文件附加到对话中。指定特定的文件或文件夹，供 Codex 接下来检查。
/model选择活动模型（及推理工作量，如果可用）。在运行任务前，在通用模型（gpt-4.1-mini）与深度推理模型之间切换。
/fast在模型目录提供快速服务层级时，将其开启。开启或关闭当前模型的快速服务层级，或检查当前线程是否正在使用它。
/plan切换到计划模式并选择性地发送提示词。要求 Codex 在开始实施工作之前先提出执行计划。
/goal设置、暂停、恢复、查看或清除任务目标。为 Codex 设定一个持久目标，以便在处理大型任务时进行跟踪。
/personality选择回复的沟通风格。让 Codex 变得更简洁、更具解释性或更具协作性，而无需修改您的指令。
/ps显示实验性后台终端及其最近的输出。无需离开主记录即可检查长时间运行的命令。
/stop停止所有后台终端。取消当前会话启动的后台终端工作。
/fork将当前对话分叉到新线程。分叉当前活动会话，以探索新方法而不丢失当前记录。
/side启动一个临时侧边对话。提出有针对性的后续问题，而不干扰主线程的记录。
/raw切换原始回滚模式。在查看长输出时，降低终端选择和复制内容的格式化程度。
/resume从会话列表中恢复已保存的对话。继续之前 CLI 会话的工作，无需重新开始。
/new在同一个 CLI 会话中开始新对话。当你想在同一仓库中使用全新的提示时，无需退出 CLI 即可重置聊天上下文。
/quit退出 CLI。立即离开会话。
/review请求 Codex 审查你的工作区。在 Codex 完成工作后，或者当你需要第二双眼睛来检查本地更改时运行。
/status显示会话配置和 token 用量。确认当前的模型、审批策略、可写根目录和剩余的上下文容量。
/debug-config打印配置层和依赖项诊断信息。调试优先级和策略要求，包括实验性网络限制。
/statusline交互式地配置 TUI 状态栏字段。选择并重新排列底部栏项目（模型/上下文/限制/git/token/会话），并持久化保存到 config.toml 中。
/title交互式地配置终端窗口或标签页标题字段。选择并重新排列标题项目，例如项目、状态、线程、分支、模型和任务进度。
/theme选择一个语法高亮主题。预览并持久化保存终端的语法高亮主题。

/quit and /exit 都会退出 CLI。请务必在保存或提交任何重要工作之后再使用它们。

使用 /permissions 以调整 Codex 无需事先询问即可执行的操作。请使用 /approve 仅在你需要重试被自动审查拒绝的近期操作时使用。

通过斜杠命令控制你的会话

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

使用以下命令设置活动模型 /model

  1. 启动 Codex 并打开编辑器。
  2. 类型 /model and press Enter.
  3. 选择一个模型，例如 gpt-4.1-mini or gpt-4.1 from the popup.

预期：Codex 会在记录中确认新模型。运行 /status to verify the change.

使用以下命令切换快速模式 /fast

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

预期：Codex 会报告当前线程中当前模型的快速服务级别是开启还是关闭。在 TUI 页脚中，你还可以使用以下命令显示快速模式状态行项 /statusline.

快速层级命令由目录驱动。如果当前模型未提供快速层级，Codex 将不会显示 /fast.

使用以下命令设置沟通风格 /personality

使用 /personality 以更改 Codex 的沟通方式，而无需重写你的提示词。

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

预期：Codex 在记录中确认新风格，并在该对话的后续回复中使用它。

Codex 支持 friendly, pragmatic，且 none 个性化设置。使用 none to disable personality instructions.

如果当前模型不支持特定风格指令，Codex 会隐藏此命令。

使用以下命令切换至计划模式 /plan

  1. 类型 /plan 然后按 Enter 键，将当前对话切换至计划模式。
  2. 可选：提供内联提示文本（例如， /plan Propose a migration plan for this service).
  3. 在使用内联时，你可以粘贴内容或附加图片 /plan arguments.

预期：Codex 进入计划模式，并将你提供的可选内联提示作为首个规划请求。

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

使用以下命令设置或查看任务目标 /goal

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

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

目标内容不能为空，且最多 4,000 个字符。对于较长的指令，请将详细信息放入文件中，并在目标中指向该文件。

使用以下命令切换实验性功能 /experimental

  1. 类型 /experimental and press Enter.
  2. 切换你想要的功能（例如 Apps 或 智能审批），然后在出现提示时重启 Codex。

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

使用以下命令批准自动审查拒绝 /approve

使用 /approve 当自动审查器拒绝了近期的操作，且你希望 Codex 重试一次时使用。

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

预期：Codex 根据当前的会话策略，将该拒绝的操作重试一次。

使用以下命令配置记忆 /memories

  1. 类型 /memories.
  2. 选择 Codex 应使用现有记忆、生成新记忆，还是保持记忆行为禁用。

预期：Codex 更新未来会话的相关记忆设置。

使用以下命令应用技能 /skills

  1. 类型 /skills.
  2. 选择你希望 Codex 应用的技能。

预期：Codex 插入选定的技能上下文，以便下一个请求遵循该技能的指令。

使用以下命令查看生命周期钩子 /hooks

  1. 类型 /hooks.
  2. 查看已加载的生命周期钩子配置。

预期：Codex 显示可在当前会话中运行的钩子。

使用以下命令清除终端并开启新聊天 /clear

  1. 类型 /clear and press Enter.

预期：Codex 清除终端，重置可见记录，并在同一 CLI 会话中开启全新聊天。

与 Ctrl+L, /clear 开启新对话。

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

使用以下命令更新权限 /permissions

  1. 类型 /permissions and press Enter.
  2. 选择符合你接受程度的审批预设，例如 Auto for hands-off runs or Read Only to review edits.

预期：Codex 宣布已更新的策略。后续操作将遵循更新后的审批模式，直到你再次更改。

使用以下命令包含 IDE 上下文 /ide

  1. 类型 /ide.
  2. 如果你希望解释 Codex 应如何处理当前选中的 IDE 内容或打开的文件，可添加可选的内联文本。

预期：Codex 在下一个提示中包含可用的 IDE 上下文。

使用以下命令切换 Vim 模式 /vim

  1. 类型 /vim.
  2. 在编辑器中继续编辑。

预期：Codex 为当前会话切换编辑器 Vim 模式。要将 Vim 模式设为新会话的默认模式，请设置 tui.vim_mode_default = true in config.toml.

使用以下命令复制最新回复 /copy

  1. 类型 /copy and press Enter.

预期：Codex 将最新完成的 Codex 输出复制到剪贴板。

如果某个轮次仍在运行， /copy 将使用最新完成的输出，而不是正在进行的回复。在首次完成的 Codex 输出之前，以及回滚操作之后立即执行时，该命令不可用。

你还可以按下 Ctrl+O 在主 TUI 界面中复制最新完成的回复，而无需打开斜杠命令菜单。

使用以下命令切换原始回滚模式 /raw

  1. 类型 /raw, /raw on, or /raw off.

预期：Codex 切换原始回滚模式，该模式使终端的选择和复制更加直接。你还可以使用默认的 Alt+R 绑定，或通过以下命令持久化该默认设置 tui.raw_output_mode = true.

使用以下命令授予沙盒读取权限 /sandbox-add-read-dir

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

  1. 类型 /sandbox-add-read-dir C:\absolute\directory\path and press Enter.
  2. 确认路径是一个现有的绝对目录。

预期：Codex 刷新 Windows 沙盒策略，并授予该目录读取权限，以供后续在沙盒中运行的命令使用。

使用以下命令检查会话 /status

  1. In any conversation, type /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. 使用选择器来切换和重新排列各项，然后进行确认。

预期结果：页脚状态栏会立即更新，并将更改持久化到 tui.status_line in config.toml.

可用的状态栏项包括模型、模型+推理、上下文统计、速率限制、git 分支、token 计数器、会话 ID、当前目录/项目根目录以及 Codex 版本。

使用以下命令配置终端标题项 /title

  1. 类型 /title.
  2. 使用选择器来切换和重新排列各项，然后进行确认。

预期结果：终端窗口或标签页的标题会立即更新，并将更改持久化到 tui.terminal_title in config.toml.

可用的标题项包括应用名称、项目、加载动画、状态、线程、git 分支、模型以及任务进度。

使用以下命令选择语法主题 /theme

  1. 类型 /theme.
  2. 在选择器中预览主题，然后进行确认。

预期结果：Codex 会更新语法高亮，并将所选主题持久化到 tui.theme in config.toml.

使用以下命令重新映射 TUI 快捷键 /keymap

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

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

预期结果：Codex 会更新活动的按键映射，并将自定义绑定写入 tui.keymap in config.toml.

按键绑定使用的名称例如 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 and press Enter.

预期：Codex 会在同一 CLI 会话中开启全新的对话，因此你无需离开终端即可切换任务。

与 /clear, /new 不会首先清除当前的终端视图。

使用以下命令恢复已保存的对话 /resume

  1. 类型 /resume and press Enter.
  2. 从已保存会话选择器中选择所需的会话。

预期：Codex 会重新加载所选对话的记录，方便你从上次中断的地方继续，并保持原始记录完整无缺。

使用以下命令复刻 (fork) 当前对话 /fork

  1. 类型 /fork and press Enter.

预期：Codex 会将当前对话克隆到一个具有新 ID 的新线程中，且不触碰原始记录，从而让你能够并行探索其他方案。

如果你需要复刻已保存的会话而非当前会话，请运行 codex fork 在你的终端中打开会话选择器。

使用以下命令开启辅助对话 /side

使用 /side 以便在不离开主任务的情况下，从当前对话中生成一个临时复刻分支。

  1. 类型 /side 以打开辅助对话。
  2. 可选择添加内联文本，例如 /side Check whether this plan has an obvious risk.
  3. 在完成这段专注的插曲后，返回父线程。

预期：Codex 会开启一个侧边对话，该对话的记录与父线程相互独立。当您处于侧边模式时，TUI 会继续显示父线程的状态，以便您查看主任务是否仍在运行。

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

生成 AGENTS.md with /init

  1. 在 Agent Builder 内部运行 /init 位于你希望 Codex 查找持久化指令的目录中。
  2. 查看生成的 AGENTS.md，然后对其进行编辑以符合你的代码仓库规范。

预期：Codex 会创建一个 AGENTS.md 供您完善并提交以供未来会话使用的基础脚手架。

使用以下命令请求工作区审查： /review

  1. 类型 /review.
  2. 使用 /diff 跟进查看，如果你想要检查具体的文件变更。

预期：Codex 会总结它在您的工作区中发现的问题，重点关注行为变更和缺失的测试。除非您设置了 review_model in config.toml.

使用以下命令列出 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. 选择一个市场选项卡，然后选择一个插件以查看其功能或可用操作。

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

使用以下命令查看钩子： /hooks

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

预期：Codex 会打开钩子浏览器，以便你查看已配置的生命周期钩子。托管钩子会显示为托管状态，且无法在用户钩子浏览器中禁用。

使用以下命令切换代理线程： /agent

  1. 类型 /agent and press Enter.
  2. 从选择器中选择你想要的线程。

预期：Codex 会切换当前活跃的线程，以便你检查或继续该 Agent 的工作。

使用以下命令发送反馈 /feedback

  1. 类型 /feedback and press Enter.
  2. 按照提示包含日志或诊断信息。

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

使用以下命令登出 /logout

  1. 类型 /logout and press Enter.

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

使用以下命令退出 CLI /quit or /exit

  1. 类型 /quit (or /exit) 并按 Enter 键。

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