For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主导航

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 的普通和插入模式与编辑器的默认编辑模式之间切换。
/setup-default-sandbox设置具有提升权限的智能体沙盒(仅限 Windows)。在 Codex 提供提升权限设置后,替换功能降级的 Windows 沙盒。
/sandbox-add-read-dir向沙盒授予对额外目录的读取权限(仅限 Windows)。允许需要读取当前可读根目录范围之外绝对目录路径的命令运行。
/agent, /subagents切换当前智能体线程。检查已创建的子智能体线程,或继续处理其中的工作。
/apps浏览应用(连接器)并将其插入您的提示。先以 $app-slug 的形式附加应用,再要求 Codex 使用它。
/plugins浏览已安装和可发现的插件。检查插件工具、安装推荐的插件,或管理插件的可用性。
/hooks查看和管理生命周期钩子。检查已配置的钩子,信任新增或已更改的钩子,或在非托管钩子运行前将其禁用。
/clear清空终端并开始新的聊天。需要重新开始时,同时重置当前显示的 UI 和聊天上下文。
/rename重命名当前聊天。无需离开 TUI 即可为已保存的会话设置一个易于识别的名称。
/archive将当前会话归档并退出 Codex。从活动会话列表中移除当前会话,但不删除其会话记录。
/delete永久删除当前会话并退出 Codex。当归档还不够时,移除会话记录及其派生会话。
/compact总结当前显示的聊天内容以释放 Token。在长时间运行后使用,使 Codex 保留要点,同时避免耗尽上下文窗口容量。
/copy复制 Codex 最近一次完成的输出。无需手动选择,即可获取最近一次完成的回复或计划文本。您也可以按 Ctrl+O
/diff显示 Git 差异,包括 Git 尚未跟踪的文件。在提交或运行测试前,审查 Codex 所做的更改。
/exit退出 CLI(与 /quit 相同)。另一种写法;这两个命令都会退出会话。
/experimental切换实验性功能。启用“网络代理”或“运行时防止睡眠”等选项。
/approve批准重试一次最近被自动审查拒绝的操作。重试被自动审查器拒绝的命令或操作。
/memories配置记忆的使用与生成。无需离开 TUI 即可开启或关闭记忆注入或记忆生成。
/skills浏览和使用技能。通过选择相关的本地技能,改进针对特定任务的行为。
/import导入 Claude Code 或 Cursor 的设置、项目和聊天。将受支持的外部智能体产物迁移到 Codex 的配置和本地文件中。
/feedback向 Codex 维护者发送日志。向支持团队报告问题或分享诊断信息。
/init在当前目录中生成 AGENTS.md 脚手架。为您正在处理的代码仓库或子目录记录持久指令。
/logout退出 Codex 登录。使用共享计算机时,清除本地凭据。
/mcp列出已配置的模型上下文协议(MCP)工具。检查 Codex 在会话期间可调用哪些外部工具;添加 verbose 可查看服务器详细信息。
/mention将文件附加到聊天。指定您希望 Codex 接下来检查的文件或文件夹。
/model选择当前模型,以及可用时的推理强度。运行任务前,在 gpt-5.6-lunagpt-5.6-terra 等模型之间切换。
/fast当模型目录提供快速服务层级时,将其开启或关闭。开启或关闭当前模型的快速服务层级,并保存所选设置。
/plan切换到计划模式,并可选择发送提示。让 Codex 在开始实施前提出执行计划。
/goal设置、编辑、暂停、恢复、查看或清除任务目标。在较大任务运行期间,为 Codex 设定一个持续跟踪的目标。
/personality选择回复时采用的沟通风格。无需更改指令,即可让 Codex 的回复更简洁、解释更充分或更注重协作。
/ps显示后台终端及其最近的输出。无需离开主对话记录,即可查看长时间运行的命令。
/stop停止所有后台终端。取消当前会话启动的后台终端任务。
/fork基于当前聊天派生一个新聊天。从当前会话派生新会话,探索新方法,同时保留当前对话记录。
/app在 ChatGPT 桌面应用中继续当前会话。在 macOS 或 Windows 上从 TUI 切换到桌面应用。
/side, /btw启动临时侧边聊天。在不影响主聊天记录的情况下,提出有针对性的后续问题。
/raw切换原始回滚模式。查看较长输出时,减少选择和复制终端内容时附带的格式。
/resume从会话列表中恢复已保存的聊天。继续之前 CLI 会话中的工作,无需从头开始。
/new在同一 CLI 会话中开始新聊天。如果您希望在同一代码仓库中使用全新提示,可以不退出 CLI,直接重置聊天上下文。
/quit退出 CLI。立即退出会话。
/review让 Codex 审查您的工作树。在 Codex 完成工作后,或希望再次检查本地更改时运行。
/status显示会话配置和 Token 用量。确认当前模型、审批策略、可写根目录和剩余上下文容量。
/usage查看账户 Token 用量,或使用一次速率限制重置。在 TUI 中查看 ChatGPT 每日、每周或累计的 Token 使用情况。
/debug-config输出配置层及相关要求的诊断信息。调试优先级和策略要求,包括实验性网络限制。
/statusline以交互方式配置 TUI 状态行字段。选择页脚项并调整顺序(模型、上下文、限制、git、Token、会话),然后保存到 config.toml。
/title以交互方式配置终端窗口或标签页的标题字段。选择项目、状态、线程、分支、模型和任务进度等标题项,并调整其顺序。
/theme选择语法高亮主题。预览并保存终端语法高亮主题。
/pets, /pet选择或隐藏终端宠物。使用内置或自定义的陪伴宠物,个性化您的 TUI。

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

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

使用斜杠命令控制会话

以下工作流无需重启 Codex,即可让会话顺利推进。

使用 /model 设置当前模型

  1. 启动 Codex 并打开编辑器。
  2. 输入 /model,然后按 Enter 键。
  3. 从弹出菜单中选择 gpt-5.6-lunagpt-5.6-terra 等模型。

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

使用 /fast 切换快速模式

  1. 输入 /fast,开启当前模型的快速服务层级。
  2. 再次输入 /fast 即可关闭。

预期结果:Codex 会切换该层级并保存所选设置。在 TUI 页脚中, 您还可以使用 /statusline 显示快速模式状态行项。

快速服务层级命令由模型目录决定。如果当前模型未提供 快速服务层级,Codex 将不会显示 /fast

使用 /personality 设置沟通风格

使用 /personality 即可更改 Codex 的沟通方式,无需改写您的提示。

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

预期结果:Codex 会在对话记录中确认新风格,并在该聊天的后续 回复中使用这种风格。

Codex 支持 friendlypragmaticnone 三种个性。使用 none 可停用个性指令。

如果当前模型不支持针对特定个性的指令,Codex 会隐藏此命令。

使用 /plan 切换到计划模式

  1. 输入 /plan 并按 Enter 键,将当前聊天 切换到计划模式。
  2. 可选:提供内联提示文本(例如 /plan Propose a migration plan for this service)。
  3. 使用内联 /plan 参数时,您可以粘贴内容或附加图像。

预期结果:Codex 会进入计划模式,并将您提供的内联提示(如有)作为首个规划请求。

当 Codex 正在工作时,/plan 暂时不可用。

使用 /goal 设置或查看任务目标

  1. 输入 /goal <objective> 以设置目标,例如 /goal Finish the migration and keep tests green
  2. 输入 /goal 以查看当前目标。
  3. 使用 /goal edit 修改目标。使用 /goal pause/goal resume/goal clear 可分别暂停、恢复或移除目标。

预期结果:工作继续进行时,Codex 会保持目标与当前聊天关联。

目标内容不能为空,且不得超过 4,000 个字符。对于较长的 指令,请将详细内容写入文件,并让目标指向该文件。

使用 /experimental 切换实验性功能

  1. 输入 /experimental 并按 Enter 键。
  2. 按需启用或停用功能(例如“网络代理”或“运行时防止休眠”);如果出现重启提示,请重启 Codex。

预期结果:Codex 会将您的功能选择保存到配置中,并在重启后应用这些选择。

使用 /approve 批准重试被自动审查拒绝的操作

自动审查器拒绝最近的一项操作后,您可以使用 /approve 让 Codex 重试一次。

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

预期结果:Codex 会依据当前会话策略, 对被拒绝的操作重试一次。

使用 /memories 配置记忆

  1. 输入 /memories
  2. 选择让 Codex 使用现有记忆、生成新记忆, 或保持记忆功能停用。

预期结果:Codex 会更新相关记忆设置,供后续会话使用。

使用 /skills 应用技能

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

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

使用 /import 导入 Claude Code 或 Cursor 设置

  1. 输入 /import
  2. 选择 Claude CodeCursor
  3. 选择您要迁移的设置、项目文件或最近的聊天。

预期结果:Codex 会打开外部智能体导入选择器,并将所选且受支持的工件 导入 Codex 配置和本地文件。会话发现功能最多可找到 过去 30 天内的 50 个聊天会话。

请在本地 TUI 会话中运行 /import。在任务运行期间、 远程会话中,或连接到本地 app-server 守护进程时,该命令不可用。

有关桌面应用的工作流程及受支持的工件类型,请参阅从另一个智能体 导入

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

  1. 输入 /clear 并按 Enter 键。

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

要在创建新对话时为其命名,请运行 /clear release prep

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

Ctrl+L 只会清空终端视图,并保留当前聊天。 任务进行期间,Codex 会停用这两项操作。

使用 /archive 归档当前会话

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

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

任务运行期间,/archive 不可用。

使用 /delete 删除当前会话

  1. 输入 /delete 并按 Enter 键。
  2. 确认您要删除当前会话并退出 Codex。

预期结果:Codex 会删除当前会话记录并关闭 交互式 TUI。删除后无法恢复,同时移除 由该会话派生的后代会话。

/delete 在聊天运行期间或侧边聊天中不可用。

使用 /permissions 更新权限

  1. 输入 /permissions 并按 Enter 键。
  2. 选择符合您偏好的审批预设,例如 使用 Auto 进行无需干预的运行,或使用 Read Only 审查编辑内容。 启用已命名的权限配置方案时,选择器还会显示 已配置的自定义配置方案及其说明。

预期结果:Codex 会告知您审批策略已更新。在您再次更改之前, 后续操作将遵循更新后的审批模式。

使用 /ide 添加 IDE 上下文

  1. 输入 /ide
  2. 如需说明 Codex 应如何处理 IDE 中当前选中的内容或已打开的文件,您可以添加内联文本。

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

使用 /vim 切换 Vim 模式

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

预期结果:Codex 会为当前会话切换编辑器的 Vim 模式。 如需将 Vim 模式设为新会话的默认模式,请将 tui.vim_mode_default = true 写入 config.toml

使用 /setup-default-sandbox 设置提升权限的 Windows 沙盒

仅当 Codex 在 Windows 上使用降级的受限 Token 沙盒时,才会显示此命令。

  1. 输入 /setup-default-sandbox
  2. 按照管理员设置流程操作。

预期结果:Codex 会配置提升权限的 Windows 沙盒,并选择相应的自动审批预设。

使用 /copy 复制最新响应

  1. 输入 /copy,然后按 Enter 键。

预期结果: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 授予沙盒读取权限

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

  1. 输入 /sandbox-add-read-dir C:\absolute\directory\path,然后按 Enter 键。
  2. 确认该路径是现有目录的绝对路径。

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

使用 /status 检查会话

  1. 在任意聊天中输入 /status
  2. 检查输出中的当前模型、审批策略、可写根目录和当前 Token 用量。TUI 建立远程连接时,输出还会显示远程地址和服务器版本。

预期结果:Codex 会输出摘要,确认其正在您预期的环境中运行。

使用 /usage 查看账户用量

  1. 输入 /usage 打开用量菜单。
  2. 选择查看 Token 使用情况,或兑换一次已获得且可用的重置机会。
  3. 若要直接查看 Token 使用情况,请输入 /usage daily/usage weekly/usage cumulative

预期结果:Codex 会显示用量相关操作,或显示所选视图中的账户 Token 使用情况。如果当前会话未通过 Codex 服务账户身份验证,Codex 会提示您登录。

使用 /debug-config 检查配置层

  1. 输入 /debug-config
  2. 检查输出中的配置层顺序(优先级最低的在前)、启用或停用状态以及策略来源。

预期结果:Codex 会输出配置层诊断信息,以及已配置的策略详情,例如 allowed_approval_policiesallowed_sandbox_modesmcp_serversrulesexperimental_network

使用此输出排查实际生效的设置为何与 config.toml 中的设置不同。

  1. 输入 /statusline
  2. 使用选择器启用或停用各项并调整其顺序,然后确认。

预期结果:底部状态行会立即更新,相关设置也会持久保存到 tui.status_line(位于 config.toml 中)。

可用的状态行显示项包括模型、模型+推理、上下文统计信息、速率限制、Git 分支、Token 计数器、会话 ID、当前目录/项目根目录,以及 Codex 版本。

使用 /title 配置终端标题显示项

  1. 输入 /title
  2. 使用选择器启用或停用各项并调整其顺序,然后确认。

预期结果:终端窗口或标签页标题会立即更新,相关设置也会持久保存到 tui.terminal_title(位于 config.toml 中)。

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

使用 /theme 选择语法高亮主题

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

预期结果:Codex 会更新语法高亮,并将所选主题持久保存到 tui.theme(位于 config.toml 中)。

使用 /pets 选择终端宠物

  1. 输入 /pets(或 /pet)打开宠物选择器。
  2. 选择内置或自定义宠物,也可以关闭宠物。

预期结果:Codex 会在受支持的终端中显示所选的装饰性宠物, 并持久保存该选择。您也可以输入 /pets off 将其隐藏。

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

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

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

预期结果:Codex 会更新当前生效的键位映射,并将自定义绑定写入 tui.keymap(位于 config.toml 中)。

按键绑定使用 ctrl-ashift-enterpage-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 会话中开始新对话,因此您 无需离开终端即可切换聊天。

要在创建新对话的同时为其命名,请运行 /new bug bash

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

使用 /rename 重命名当前聊天

  1. 输入 /rename <name>,或输入 /rename 以打开命名提示。
  2. 输入一个简短的名称,方便您之后找到该聊天。

预期结果:Codex 会更新已保存聊天的名称,但不会更改其聊天记录。

使用 /resume 恢复已保存的聊天

  1. 输入 /resume,然后按 Enter。
  2. 从已保存会话选择器中选择您需要的会话。

预期结果:Codex 会重新加载所选聊天的记录,让您从上次中断处 继续,同时完整保留原始历史记录。

使用 /fork 派生当前聊天

  1. 输入 /fork,然后按 Enter。

预期结果:Codex 会将当前聊天克隆为一个具有全新 ID 的新聊天,并保持原始聊天记录不变,以便您并行探索另一种 方案。

如果您需要派生已保存的会话而非当前会话,请在终端中运行 codex fork,以打开会话选择器。

使用 /app 在桌面应用中继续

在 macOS 和 Windows 上,输入 /app 可在 ChatGPT 桌面应用中打开当前会话。如果该应用尚未安装或未在运行,Codex 会显示错误,要求 您安装或启动它。

预期结果:桌面应用会打开同一个已保存的聊天,您可以在其中继续。

使用 /side 开始侧边聊天

使用 /side 从当前聊天创建一个临时派生聊天,而无需切换出主聊天。

  1. 输入 /side 以打开侧边聊天。
  2. 您可以选择添加内联文本,例如 /side Check whether this plan has an obvious risk
  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 会打开插件浏览器,供您查看已安装的插件、 当前配置允许发现的插件,以及已安装插件的状态。 在已安装的插件上按 空格键 可切换其启用状态。

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

  1. 输入 /hooks
  2. 选择一个钩子事件,查看对应的处理程序。
  3. 根据需要信任、禁用或重新启用不受管理的钩子。

预期结果:Codex 会打开钩子浏览器,供您查看已配置的生命周期钩子。受管理的钩子会标明其受管理状态,且无法通过用户钩子浏览器禁用。

使用 /agent 切换智能体线程

  1. 输入 /agent/subagents,然后按 Enter 键。
  2. 从选择器中选择所需的线程。

预期结果:Codex 会切换当前线程,以便您查看或继续相应智能体的工作。

使用 /feedback 发送反馈

  1. 输入 /feedback,然后按 Enter 键。
  2. 按照提示附加日志或诊断信息。

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

使用 /logout 退出登录

  1. 输入 /logout,然后按 Enter 键。

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

使用 /quit/exit 退出 CLI

  1. 输入 /quit(或 /exit),然后按 Enter 键。

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