斜杠命令让你可以用键盘优先的方式快速控制 Codex。在输入框中输入 / 会打开斜杠命令弹出菜单;选中某个命令后,Codex 就能在不离开终端的情况下执行切换模型、调整权限、压缩长对话等操作。
本页会说明如何:
- 找到适合当前任务的内置斜杠命令
- 用
/model、/fast、/personality、/permissions、/approve、/raw、/agent、/status等命令调整正在进行中的会话
内置斜杠命令
Codex 内置了以下命令。打开斜杠命令弹出菜单后,开始输入命令名即可过滤列表。
当某个任务已经在运行时,你可以输入斜杠命令并按 Tab,把它排队到下一轮执行。Codex 会在实际运行时再解析这些排队的斜杠命令,因此命令菜单和错误会在当前 turn 结束后显示。排队前,斜杠补全仍然可用。
| 命令 | 用途 | 何时使用 |
|---|---|---|
/permissions |
设置 Codex 在不先询问的情况下可以做什么。 | 想在会话中途放宽或收紧审批要求时,例如在 Auto 和 Read Only 之间切换。 |
/ide |
包含打开文件、当前选区和其他 IDE 上下文。 | 想把编辑器上下文带进下一条提示词,而不重新解释 IDE 里打开了什么时。 |
/keymap |
重新映射 TUI 快捷键。 | 想查看自定义快捷键绑定并把它们持久写入 config.toml 时。 |
/vim |
切换输入框的 Vim 模式。 | 想在 Vim normal / insert 行为和默认输入编辑模式之间切换时。 |
/sandbox-add-read-dir |
为额外目录授予沙箱读权限(仅 Windows)。 | 某些命令需要读取当前可读根目录之外的绝对路径时,用它解锁。 |
/agent |
切换当前激活的智能体线程。 | 想查看或继续某个已生成的子智能体线程时。 |
/apps |
浏览 Apps(连接器),并把它们插入提示词。 | 想先把某个 App 以 $app-slug 的形式附加进提示词,再让 Codex 调用它时使用。 |
/plugins |
浏览已安装和可发现的插件。 | 想检查插件工具、安装建议插件,或管理哪些插件可用时使用。 |
/hooks |
查看和管理生命周期 hooks。 | 想检查当前会话加载了哪些 hook 配置时。 |
/clear |
清空终端,并开始一个新聊天。 | 想同时重置可见 UI 和当前对话时。 |
/compact |
总结当前可见对话,以释放 token。 | 长会话后压缩对话记录,保留重点并腾出上下文空间。 |
/copy |
复制最近一次已完成的 Codex 输出。 | 想直接拿到最近一条完成回复或计划文本,而不手动选中复制;也可以按 Ctrl+O。 |
/diff |
显示 Git diff,包括 Git 尚未追踪的文件。 | 在提交或运行测试前,先审查 Codex 改了什么。 |
/exit |
退出 CLI(等价于 /quit)。 |
作为 /quit 的另一种写法使用;两者都会直接退出会话。 |
/experimental |
切换实验性功能。 | 想在 CLI 中开启可选能力,例如子智能体。 |
/approve |
批准最近一次 auto review 拒绝后的重试。 | 想让 Codex 重试被自动评审拒绝的命令或动作时。 |
/memories |
配置记忆使用和生成。 | 想在不离开 TUI 的情况下开启或关闭记忆注入 / 生成时。 |
/skills |
浏览和使用技能。 | 想选择相关本地技能来改善特定任务行为时。 |
/feedback |
向 Codex 维护团队发送日志。 | 想报告问题或分享诊断信息时。 |
/init |
在当前目录生成 AGENTS.md 骨架。 |
想为仓库或子目录留下长期生效的操作指令时。 |
/logout |
退出 Codex 登录状态。 | 在共享机器上清理本地凭据。 |
/mcp |
列出已配置的 Model Context Protocol(MCP)工具。 | 想确认本会话可用的外部工具能力时;添加 verbose 可查看 MCP server 详情。 |
/mention |
把文件附加到当前对话。 | 想让 Codex 下一步重点查看某个文件或目录。 |
/model |
选择当前使用的模型,以及可用时的推理强度。 | 在执行任务前切换模型,例如在通用模型和深度推理模型之间切换。 |
/fast |
为受支持模型切换快速模式(Fast mode)。 | 打开 / 关闭快速模式,或检查当前线程是否处于快速模式。 |
/plan |
切换到规划模式,并可选择立即附带一条提示词。 | 想先让 Codex 给出执行计划,再进入实现阶段时。 |
/goal |
设置、暂停、恢复、查看或清除任务目标。 | 让 Codex 在较大的任务运行期间持续跟踪一个目标。 |
/personality |
设定响应风格。 | 想让 Codex 更简洁、更解释型,或更偏协作式,而不改写原提示词。 |
/ps |
查看实验性的后台终端及其最近输出。 | 想不离开主对话记录就查看长任务进度时。 |
/stop |
停止所有后台终端。 | 想取消当前会话启动的后台终端任务时。 |
/fork |
把当前对话分叉成新线程。 | 想在不丢失当前对话记录的情况下平行探索另一种做法。 |
/side |
启动一个临时侧边会话(side conversation)。 | 想在不打断主线程记录的情况下提出一个聚焦追问。 |
/raw |
切换 raw scrollback 模式。 | 想在查看长输出时让终端选中和复制更少受格式化影响。 |
/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 |
交互式配置终端窗口或标签标题项。 | 想把项目、状态、线程、分支、模型或任务进度等信息显示到终端标题中时。 |
/theme |
选择语法高亮主题。 | 想预览并保存终端语法高亮主题时。 |
/quit 和 /exit 都会退出 CLI。退出前请确认你已经保存或提交了重要工作。
使用 /permissions 调整 Codex 在不先询问的情况下可以做什么。只有当你需要重试最近被自动评审拒绝的动作时,才使用 /approve。
用斜杠命令控制当前会话
下面这些工作流可以帮助你在不重启 Codex 的情况下持续调整会话。
用 /model 设置当前模型
- 启动 Codex 并打开输入框。
- 输入
/model并按 Enter。 - 从弹出菜单中选择
gpt-4.1-mini、gpt-4.1等模型。
预期结果:Codex 会在对话记录中确认模型已切换。你也可以运行 /status 再确认一次。
用 /fast 切换快速 service tier
- 输入
/fast on、/fast off或/fast status。 - 如果你希望这个设置持久生效,可以在 Codex 提示保存更新时确认。
预期结果:Codex 会说明当前模型的 Fast service tier 是否已在当前线程开启。在 TUI 底部状态栏中,你也可以用 /statusline 显示快速模式的状态项。
Fast tier 命令由模型目录驱动。如果当前模型没有声明 Fast tier,Codex 不会显示 /fast。
用 /personality 设置沟通风格
使用 /personality 可以在不重写提示词的情况下调整 Codex 的表达方式。
- 在当前对话中输入
/personality并按 Enter。 - 从弹出菜单中选择一种风格。
预期结果:Codex 会在对话记录中确认新的风格,并在后续回复中持续采用它。
Codex 支持 friendly、pragmatic 和 none 三种沟通风格(personality)。使用 none 可关闭沟通风格指令。
如果当前模型不支持沟通风格专用指令,Codex 会隐藏这个命令。
用 /plan 切换到规划模式
- 输入
/plan并按 Enter,把当前对话切换到规划模式。 - 你也可以直接附带一段内联提示词,例如
/plan Propose a migration plan for this service。 - 使用内联
/plan参数时,你也可以粘贴内容或附加图片。
预期结果:Codex 会进入规划模式,并把你可选提供的内联提示词作为第一条规划请求。
当某个任务已经在运行时,/plan 会暂时不可用。
用 /goal 设置或查看任务目标
- 输入
/goal <objective>设置目标,例如/goal Finish the migration and keep tests green。 - 输入
/goal查看当前目标。 - 使用
/goal pause、/goal resume或/goal clear暂停、恢复或移除目标。
预期结果:Codex 会在工作继续推进时,把该目标持续附加到活动线程上。
目标内容必须非空,且最多 4,000 个字符。对于更长的指令,请把细节放进文件,并让目标指向该文件。
用 /experimental 切换实验性功能
- 输入
/experimental并按 Enter。 - 切换你想启用的功能,例如 Apps 或 Guardian approval;如果 Codex 提示需要重启,则按提示执行。
预期结果:Codex 会把你的功能选择写入配置,并在重启后生效。
用 /approve 批准 auto review 拒绝后的重试
当自动评审拒绝了最近一次动作,而你希望 Codex 重试一次时,可以使用 /approve。
- 输入
/approve。 - 当 Codex 显示相关被拒绝动作时,确认重试。
预期结果:Codex 会在当前会话策略下重试该被拒绝动作一次。
用 /memories 配置记忆
- 输入
/memories。 - 选择 Codex 应该使用已有记忆、生成新记忆,还是保持记忆行为关闭。
预期结果:Codex 会更新后续会话使用的相关记忆设置。
用 /skills 使用技能
- 输入
/skills。 - 选择你希望 Codex 应用的技能。
预期结果:Codex 会插入所选技能上下文,让下一条请求遵循该技能的说明。
用 /clear 清空终端并开始新聊天
- 输入
/clear并按 Enter。
预期结果:Codex 会清空终端、重置当前可见的对话记录,并在同一个 CLI 会话中启动一个全新的聊天。
与 Ctrl+L 不同,/clear 会开启一个新对话。
Ctrl+L 只会清空终端显示,不会清空当前聊天。任务运行中时,这两个动作都会被禁用。
用 /permissions 更新权限
- 输入
/permissions并按 Enter。 - 选择与你当前风险偏好匹配的审批预设,例如无人值守运行时可选
Auto,想先审查改动时可选Read Only。
预期结果:Codex 会公布新的策略,后续动作都会遵守更新后的审批模式,直到你再次修改。
用 /ide 包含 IDE 上下文
- 输入
/ide。 - 如果你想解释 Codex 应如何使用当前 IDE 选区或打开文件,可以追加可选行内文本。
预期结果:Codex 会把可用 IDE 上下文加入下一条提示词。
用 /vim 切换 Vim 模式
- 输入
/vim。 - 继续在输入框中编辑。
预期结果:Codex 会为当前会话切换输入框 Vim 模式。若要让新会话默认使用 Vim 模式,请在 config.toml 中设置 tui.vim_mode_default = true。
用 /copy 复制最新回复
- 输入
/copy并按 Enter。
预期结果:Codex 会把最近一条已完成的输出复制到剪贴板。
如果当前 turn 仍在运行,/copy 会复制最近一条已完成的输出,而不是正在生成中的回复。在第一条完整输出产生之前,以及回滚刚结束后,这个命令不可用。
你也可以在主 TUI 中按 Ctrl+O,不打开斜杠命令菜单也能复制最近一次已完成回复。
用 /raw 切换 raw scrollback
- 输入
/raw、/raw on或/raw off。
预期结果:Codex 会切换 raw scrollback 模式,让终端选中和复制更直接。你也可以使用默认 Alt+R 绑定,或通过 tui.raw_output_mode = true 持久化默认值。
用 /sandbox-add-read-dir 授予沙箱读权限
这个命令只在 Windows 原生 CLI 中可用。
- 输入
/sandbox-add-read-dir C:\absolute\directory\path并按 Enter。 - 确认该路径是一个存在的绝对目录。
预期结果:Codex 会刷新 Windows 沙箱策略,并为后续在沙箱中运行的命令授予该目录的读权限。
用 /status 查看当前会话
- 在任意对话中输入
/status。 - 查看输出中的当前模型、审批策略、可写根目录和 token 使用情况。
预期结果:你会看到一段类似 codex status 的摘要,用来确认 Codex 正在你预期的位置和配置下运行。
用 /debug-config 查看配置层
- 输入
/debug-config。 - 查看输出中的配置层顺序、启用状态和策略来源。
预期结果:Codex 会打印各层配置诊断,以及策略细节,例如 allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency 和 experimental_network(若已配置)。
当某个生效设置与你在 config.toml 中看到的不一致时,这份输出很适合拿来排查原因。
用 /statusline 配置底部状态栏项目
- 输入
/statusline。 - 用选择器切换并重排项目,然后确认。
预期结果:底部状态栏会立刻更新,并把配置持久写入 config.toml 中的 tui.status_line。
可显示的状态栏项包括 model、model+reasoning、context 统计、rate limits、Git branch、token 计数、session id、当前目录 / 项目根,以及 Codex 版本。
用 /title 配置终端标题项
- 输入
/title。 - 用选择器切换并重排项目,然后确认。
预期结果:终端窗口或标签标题会立刻更新,并把配置持久写入 config.toml 中的 tui.terminal_title。
可显示的标题项包括 app 名称、项目、加载指示器、状态、线程、Git 分支、模型和任务进度。
用 /theme 选择语法主题
- 输入
/theme。 - 从选择器中预览主题,然后确认。
预期结果:Codex 会更新语法高亮,并把选择持久写入 config.toml 中的 tui.theme。
用 /keymap 重新映射 TUI 快捷键
使用 /keymap 可以查看、更新并持久保存 TUI 的快捷键绑定。
- 输入
/keymap。 - 选择要修改的快捷键 context 和 action。
- 输入新的绑定,或移除现有绑定。
预期结果:Codex 会更新当前 keymap,并把自定义绑定写入 config.toml 中的 tui.keymap。
快捷键绑定使用 ctrl-a、shift-enter、page-down 这类名称。特定上下文的绑定会覆盖 tui.keymap.global;空绑定列表表示解除该动作绑定。
用 /ps 查看后台终端
- 输入
/ps。 - 查看后台终端列表及其状态。
预期结果:Codex 会展示每个后台终端的命令,以及最多三行最近、非空输出,方便你快速判断进度。
只有在启用了 unified_exec 时才会出现后台终端;否则列表可能为空。
用 /stop 停止后台终端
- 输入
/stop。 - 如果 Codex 在停止前要求确认,就按提示确认。
预期结果:Codex 会停止当前会话中的所有后台终端。/clean 仍可作为 /stop 的别名使用。
用 /compact 精简对话记录
- 在一次较长的对话后输入
/compact。 - 当 Codex 提示是否要总结当前对话时,确认即可。
预期结果:Codex 会用一段简洁摘要替换较早的 turns,在保留关键细节的同时释放上下文。
用 /diff 审查改动
- 输入
/diff查看 Git diff。 - 在 CLI 内滚动输出,审查改动和新增文件。
预期结果:Codex 会显示已暂存的改动、未暂存的改动,以及 Git 尚未开始追踪的文件,帮助你决定要保留什么。
用 /mention 高亮文件
- 输入
/mention后跟路径,例如/mention src/lib/api.ts。 - 从弹出菜单中选择匹配结果。
预期结果:Codex 会把该文件加入当前对话,使后续 turn 能直接引用它。
用 /new 开启新对话
- 输入
/new并按 Enter。
预期结果:Codex 会在同一个 CLI 会话中开启一个全新对话,让你无需退出终端就能切换到另一项任务。
与 /clear 不同,/new 不会先清空当前终端显示。
用 /resume 恢复已保存对话
- 输入
/resume并按 Enter。 - 从保存的会话选择器中选中你要恢复的对话。
预期结果:Codex 会载入你所选对话的完整记录,让你从原来的进度继续,而不会丢掉历史内容。
用 /fork 分叉当前对话
- 输入
/fork并按 Enter。
预期结果:Codex 会把当前对话复制成一个带有新 ID 的线程,原始对话记录保持不变,因此你可以并行探索另一种方案。
如果你要 fork 的不是当前对话,而是某个已保存 session,请在终端中运行 codex fork,打开 session picker。
用 /side 启动侧边会话(side conversation)
使用 /side 可以从当前对话启动一个临时分叉,而不离开主任务。
- 输入
/side打开侧边会话。 - 也可以附带行内文本,例如
/side Check whether this plan has an obvious risk。 - 这个聚焦插曲结束后,返回父线程。
预期结果:Codex 会打开一个转录记录与父线程分离的侧边会话。处于侧边模式时,TUI 仍会显示父线程状态,方便你确认主任务是否仍在运行。
/side 不能在另一个侧边会话内使用,也不能在评审模式中使用。
用 /init 生成 AGENTS.md
- 在你希望 Codex 查找长期指令的目录中运行
/init。 - 查看生成的
AGENTS.md,再按仓库约定继续编辑。
预期结果:Codex 会创建一个可继续完善并提交、供后续会话使用的 AGENTS.md 骨架。
用 /review 审查工作树
- 输入
/review。 - 如果你还想查看精确的文件改动,可继续运行
/diff。
预期结果:Codex 会总结它在当前工作树中发现的问题,重点关注行为变化与缺失测试。默认使用当前 session 的 model,除非你在 config.toml 中单独设置了 review_model。
用 /mcp 列出 MCP 工具
- 输入
/mcp。 - 查看列表,确认当前有哪些 MCP server 和工具可用。
预期结果:你会看到当前会话中 Codex 可调用的 MCP 工具列表。
使用 /mcp verbose 可以包含详细的服务端诊断信息。如果传入的参数不是 verbose,Codex 会显示命令用法。
用 /apps 浏览 Apps
- 输入
/apps。 - 从列表中选择一个 App。
预期结果:Codex 会把 App mention 以 $app-slug 的形式插入输入框,这样你就可以立刻要求 Codex 调用它。
用 /plugins 浏览插件
- 输入
/plugins。 - 选择一个插件市场标签页,然后选中某个插件,查看它的能力或可用动作。
预期结果:Codex 会打开插件浏览器,让你查看已安装插件、当前配置允许发现的插件,以及已安装插件状态。在已安装插件上按 Space 可以切换它的启用状态。
用 /hooks 查看生命周期 hooks
- 输入
/hooks。 - 查看当前会话中已加载的生命周期 hook 配置。
预期结果:Codex 会显示当前会话可运行的 hooks。
用 /agent 切换智能体线程
- 输入
/agent并按 Enter。 - 从选择器中选中你要查看或继续的线程。
预期结果:Codex 会切换当前激活线程,让你查看或继续该智能体的工作。
用 /feedback 发送反馈
- 输入
/feedback并按 Enter。 - 按提示选择是否附带日志或其他诊断信息。
预期结果:Codex 会收集所需诊断信息,并把它提交给维护团队。
用 /logout 退出登录
- 输入
/logout并按 Enter。
预期结果:Codex 会清除当前用户会话在本地保存的凭据。
用 /quit 或 /exit 退出 CLI
- 输入
/quit或/exit并按 Enter。
预期结果:Codex 会立即退出。退出前请先保存或提交重要工作。