斜杠命令

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 模式。	在 Vim 普通/插入行为和默认输入框编辑模式之间切换。
/sandbox-add-read-dir	为沙箱授予额外目录的读取访问权限（仅限 Windows）。	解除需要读取当前可读根目录之外的绝对目录路径的命令限制。
/agent	切换活跃的智能体线程。	检查或继续在已生成的子智能体线程中工作。
/apps	浏览应用（连接器）并将其插入到提示中。	以 $app-slug 的形式附加应用，然后要求 Codex 使用它。
/plugins	浏览已安装和可发现的插件。	检查插件工具、安装建议的插件或管理插件可用性。
/hooks	查看生命周期钩子。	检查已配置的钩子、信任新的或更改的钩子，或在运行前禁用非托管钩子。
/clear	清除终端并开始全新对话。	同时重置可见 UI 和对话，适合想要全新开始时使用。
/archive	打包当前的会话并退出 codex	由于技术维护和系统更新，当前会话已从活动会话列表中移除，但其聊天记录已被妥善保存。
/compact	总结可见对话以释放 token。	在长时间运行后使用，让 Codex 保留关键要点而不超出上下文窗口。
/copy	复制最近完成的 Codex 输出。	获取最近完成的响应或计划文本，无需手动选择。也可以按 Ctrl+O。
/diff	显示 Git 差异，包括 Git 尚未跟踪的文件。	在提交或运行测试之前审查 Codex 的编辑。
/exit	退出 CLI（同 /quit）。	替代拼写；两个命令都会退出会话。
/experimental	切换实验性功能。	从 CLI 启用可选功能，例如子智能体。
/approve	批准对最近一次自动审查拒绝的重试。	重试被自动审查器拒绝的命令或操作。
/memories	配置记忆使用和生成。	在不离开 TUI 的情况下开启或关闭记忆注入或记忆生成。
/skills	浏览和使用技能。	通过选择相关的本地技能来改善特定任务的行为。
/hooks	查看和管理生命周期钩子。	检查加载到当前会话中的钩子配置。
/feedback	向 Codex 维护者发送日志。	报告问题或与支持团队共享诊断信息。
/init	在当前目录中生成 AGENTS.md 脚手架。	为正在工作的仓库或子目录捕获持久化指令。
/logout	退出 Codex 登录。	在使用共享计算机时清除本地凭据。
/mcp	列出已配置的模型上下文协议（MCP）工具。	检查 Codex 在会话期间可以调用哪些外部工具；添加 verbose 可查看服务器详细信息。
/mention	将文件附加到对话中。	让 Codex 关注你希望它接下来检查的特定文件或文件夹。
/model	选择活跃模型（以及推理强度，当可用时）。	在运行任务之前，在通用模型（gpt-4.1-mini）和深度推理模型之间切换。
/fast	当模型目录提供快速服务层级时切换。	开启或关闭当前模型的快速层级，或检查线程是否正在使用它。
/plan	切换到计划模式，并可选择发送提示。	在实现工作开始之前要求 Codex 提出执行计划。
/goal	设置、暂停、恢复、查看或清除任务目标。	为 Codex 提供一个持久目标，以便在较大任务运行期间跟踪。需要 features.goals。
/personality	选择响应的沟通风格。	让 Codex 更简洁、更详细或更具协作性，而无需更改你的指令。
/ps	显示实验性后台终端及其最近的输出。	无需离开主记录即可检查长时间运行的命令。
/stop	停止所有后台终端。	取消由当前会话启动的后台终端工作。
/fork	将当前对话分叉到新线程中。	分支活跃会话以探索新方法而不丢失当前记录。
/side, /btw	启动临时附属对话。	提出专注的后续问题而不干扰主线程的记录。
/raw	切换原始回滚模式。	在审查冗长输出时使终端选择和复制更加直接。
/resume	从会话列表中恢复已保存的对话。	继续之前 CLI 会话的工作，无需重新开始。
/new	在同一 CLI 会话中开始新对话。	在不离开 CLI 的情况下重置对话上下文，适合在同一仓库中使用新提示。
/quit	退出 CLI。	立即离开会话。
/review	要求 Codex 审查你的工作树。	在 Codex 完成工作后或当你需要对本地更改进行二次审查时运行。
/status	显示会话配置和 token 使用情况。	确认活跃模型、审批策略、可写根目录和剩余上下文容量。
/debug-config	打印配置层和需求诊断信息。	调试优先级和策略需求，包括实验性网络约束。
/statusline	交互式配置 TUI 状态行字段。	选择和重新排序页脚项（模型/上下文/限制/git/token/会话）并持久化到 config.toml。
/title	交互式配置终端窗口或标签标题字段。	选择和重新排序标题项，例如项目、状态、线程、分支、模型和任务进度。
/theme	选择语法高亮主题。	预览并持久化终端语法高亮主题。

/quit 和 /exit 都会退出 CLI。仅在保存或提交任何重要工作后使用它们。

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

使用斜杠命令控制会话

以下工作流可在不重启 Codex 的情况下保持会话正常进行。

使用 /model 设置活跃模型

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

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

使用 /fast 切换快速模式

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

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

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

使用 /personality 设置沟通风格

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

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

预期结果： Codex 在记录中确认新风格，并在后续的线程响应中使用该风格。

Codex 支持 friendly（友好）、pragmatic（务实）和 none（无）三种风格。使用 none 禁用个性指令。

如果活跃模型不支持个性特定指令，Codex 会隐藏此命令。

使用 /plan 切换到计划模式

1. 输入 /plan 并按 Enter 将活跃对话切换到计划模式。
2. 可选：提供内联提示文本（例如 /plan 为此服务提出迁移计划）。
3. 在使用内联 /plan 参数时可以粘贴内容或附加图片。

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

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

使用 /goal 设置实验性目标

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

• 输入 /goal <目标> 设置目标，例如 /goal 完成迁移并保持测试通过。
• 输入 /goal 查看当前目标。
• 使用 /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 配置记忆

1. 输入 /memories。
2. 选择 Codex 是否应使用现有记忆、生成新记忆或保持记忆行为禁用。

预期结果： Codex 更新相关记忆设置以供未来会话使用。

使用 /skills 使用技能

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

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

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

1. 输入 /hooks。
2. 审查已加载的生命周期钩子配置。

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

使用 /clear 清除终端并开始新对话

1. 输入 /clear 并按 Enter。

预期结果： Codex 清除终端，重置可见记录，并在同一 CLI 会话中开始全新对话。

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

Ctrl+L 仅清除终端视图并保留当前对话。Codex 在任务进行中时会禁用这两个操作。

使用 /archive 归档当前会话

1. 输入 /archive 并按 Enter。
2. 确认你想要归档当前会话并退出 Codex。

预期结果：Codex 会归档当前会话并关闭交互式 TUI。Codex 会将会话记录保存在本地；之后可以使用 codex unarchive <SESSION> 恢复它。

当任务正在运行时，/archive 不可用。

使用 /permissions 更新权限

1. 输入 /permissions 并按 Enter。
2. 选择符合你舒适程度的审批预设，例如 “自动” 用于无需干预的运行，或 “仅读取” 用于审查编辑。

预期结果： Codex 宣布更新后的策略。后续操作在更改之前都将遵循更新后的审批模式。

使用 /ide 包含 IDE 上下文

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

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

使用 /vim 切换 Vim 模式

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

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

使用 /copy 复制最近的响应

1. 输入 /copy 并按 Enter。

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

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

你也可以从主 TUI 按 Ctrl+O 来复制最近完成的响应，无需打开斜杠命令菜单。

使用 /raw 切换原始回滚模式

• 输入 /raw、/raw on 或 /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 并按 Enter。
2. 确认路径是一个存在的绝对目录。

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

使用 /status 检查会话

1. 在任何对话中，输入 /status。
2. 查看当前模型、审批策略、可写根目录以及当前 token 使用情况的输出。当 TUI 远程连接时，输出还会显示远程地址和服务器版本。

预期结果： 你会看到类似 codex status 在 shell 中打印的摘要，确认 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。

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

使用 /title 配置终端标题项

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

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

可用标题项包括：应用名称、项目、旋转指示器、状态、线程、git 分支、模型和任务进度。

使用 /theme 选择语法主题

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

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

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

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

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

预期结果： Codex 更新活跃键映射，并将自定义绑定写入 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 差异。
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 检查这个计划是否有明显风险。
3. 在专注的绕行完成后返回父线程。

预期结果： Codex 打开一个附属对话，其记录与父线程分开。在附属模式下，TUI 继续显示父线程状态，以便你可以查看主任务是否仍在运行。

/side 在另一个附属对话内和审查模式下不可用。

使用 /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 在此会话中可以调用的已配置模型上下文协议（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 打开钩子浏览器，以便你查看已配置的生命周期钩子。托管钩子显示为 managed，且无法从用户钩子浏览器中禁用。

使用 /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 立即退出。请先保存或提交任何重要工作。