斜杠命令

交互会话中的全部斜杠命令(按用途分组),常用快捷键与输入技巧,以及全屏对话记录的操作

作者 David更新于 第 10 篇(共 22 篇)

在输入框开头输入 / 会弹出命令菜单,继续输入会按命令名的前缀筛选(不分大小写,与输入完全相同的命令排在最前);支持参数的命令把参数写在同一行,例如 /review 只看权限相关的改动。本页已核对至 Codex CLI v0.160.1;CLI 文档没有列出的命令会在备注中注明。

Codex 正在工作时,输入斜杠命令后按 Tab 可以把它排到下一轮执行。排队的命令在真正执行时才解析,所以菜单和报错会在当前这一轮结束后才出现。

模型与模式

命令作用参数备注
/model选择模型与推理强度选择器里按 Enter 保存为默认值,按 s 只用于当前会话(v0.156.0 起)
/fast开关当前模型的 Fast 服务档位,并记住选择只有模型目录为当前模型提供该档位时才出现;随附目录里的 GPT-6 Sol 与 GPT-6 Luna 在没有设置 service_tier 时默认就用 Fast,见模型与推理
/plan切换到计划模式可选,作为第一条规划请求Shift+Tab 也可以切换协作模式
/goal设置或查看长任务的目标<目标>,或 edit、pause、resume、clear目标最长 4000 字符;不带参数时打开目标菜单
/voice开始或结束实时语音对话可选:settings(选择之后语音对话使用的声音)、mute(开关麦克风)或 stop(结束对话);不带参数时在开始与结束之间切换快捷键 F8。v0.156.0 起默认开启(功能开关 realtime_conversation);只在附带语音运行时的安装包里出现,macOS、Linux 与 Windows 的发布包都已附带;旁支对话中不可用;CLI 文档未列出

/personality 已在 v0.156.0 移除(官方 CLI 文档仍列着它):friendly、pragmatic 两种沟通风格已经退役,配置项 personality 只剩 none 还有作用,见模型与推理。

权限与沙箱

命令作用参数备注
/permissions选择 Codex 无需询问即可执行的操作(如 Auto、Read Only 预设)配置了命名权限配置档时也会列出
/approve对最近一次被自动审查拒绝的操作批准重试一次配合自动审查(Auto-review)使用
/setup-default-sandbox设置提权版 Windows 沙箱仅 Windows,且正在使用降级的受限令牌沙箱时出现

原来仅限原生 Windows、让沙箱额外读取一个目录的 /sandbox-add-read-dir 已在 v0.155.0 移除,官方 CLI 参考目前仍列着它。沙箱与审批的完整说明见 沙箱、审批与安全。

会话

命令作用参数备注
/new在同一个 CLI 进程里开始新对话可选,新对话名称不清屏;在本地 Git 仓库里会先询问在当前检出还是新 worktree 中运行(v0.156.0 起 worktrees 默认开启)
/clear清屏并开始新对话可选,新对话名称Ctrl+L 只清屏、不换对话
/resume恢复一个已保存的会话可选,会话 ID 或名称;省略则打开选择器
/fork把当前对话复制为新对话(新 ID),原记录不变可选,新对话名称在本地 Git 仓库里同样先询问放在哪个检出;派生其他已保存会话用 codex fork
/rename重命名当前对话可选,新名称;省略则弹出输入框
/archive归档当前会话需确认;用 codex unarchive 恢复。使用内嵌服务时归档后退出;v0.155.0 起,连接本机守护进程或远程 app server 时不再退出,而是回到代理总览
/delete永久删除当前会话需确认;派生的子代理线程一并删除。使用内嵌服务时删除后退出;v0.156.0 起,连接本机守护进程或远程 app server 时回到代理总览
/compact总结对话以释放上下文
/recap立即生成当前对话的摘要CLI 文档未列出
/side、/btw在临时分叉中开一个旁支对话,不影响主对话记录可选,直接跟问题Ctrl+/ 切换旁支对话,Ctrl+C 返回主线程
/export把对话导出为 Markdown可选,输出文件路径;省略则弹出导出选项CLI 文档未列出
/copy复制最近一条已完成的回复,可以只复制其中一部分快捷键 Ctrl+O
/worktree在新的 Git worktree 中开始或继续对话v0.156.0 起功能开关 worktrees 默认开启;CLI 文档未列出
/cd切换当前工作目录可选,路径;省略时为 ~CLI 文档未列出
/pwd显示当前工作目录别名 /cwd;CLI 文档未列出
/app在 ChatGPT 桌面应用中继续当前会话仅 macOS、Windows
/quit、/exit退出 Codex

会话的存储位置与命令行管理见 会话管理。

代码与上下文

命令作用参数备注
/review审查当前改动并找出问题可选,自定义审查说明;省略则打开预设菜单见 代码审查
/diff显示 git diff,包括未跟踪的文件
/mention插入 @ 并打开文件搜索等同直接输入 @
/init让 Codex 在当前目录生成 AGENTS.md见 AGENTS.md 项目指令
/ide把 IDE 的当前选区、打开的文件等上下文带入对话可选,on、off 或 status
/status显示会话配置(模型、审批策略、可写目录)与 token 用量v0.156.0 起,连接本机守护进程时 Server 一行显示 Local background server
/usage查看账号用量分析,或使用一次额度重置可选,daily、weekly 或 cumulative,直接打开对应的 token 活动视图需用 ChatGPT 账号登录。v0.156.0 起菜单里的 View analytics 打开全屏的用量分析面板,分概览、用量、消息、插件、技能、对话等标签页
/debug-config显示配置层顺序与 requirements 来源,排查配置为何不生效不在弹出菜单中显示,但可以直接输入
/warnings查看保留下来的警告与诊断详情(启动、运行时、MCP、弃用提示等),可逐条复制v0.156.0 新增,快捷键 F2,底部状态栏显示去重后的警告数;CLI 文档未列出

扩展与集成

命令作用参数备注
/mcp列出已配置的 MCP 工具可选,verbose 显示服务器详情见 MCP 集成
/skills选择一个技能用于接下来的请求也可以输入 $ 提及技能,见 Skills 技能
/plugins浏览已安装和可发现的插件在已安装插件上按 Space 启用或停用
/apps管理应用(连接器),选中后以 $app-slug 插入输入框需 ChatGPT 登录;不在弹出菜单中显示
/hooks查看生命周期 hooks,信任、停用或重新启用非托管 hooks见 Hooks
/memories配置是否使用、生成记忆
/import从 Claude Code 或 Cursor 导入配置、项目和近期对话v0.157.0 起远程会话与连接本机守护进程的会话也能用

多代理与后台终端

命令作用参数备注
/agents打开代理总览(agent command center),查看、筛选并切换所有 agent 会话连接本机守护进程时,输入框为空按 ← 也能打开;文档写作 /agent,v0.158.0 中没有这个名字;见子代理
/daemon管理本机的后台服务(app-server 守护进程):显示正在运行的版本,可选择安装最新稳定版,或改用当前 CLI 的安装包并固定版本v0.156.0 新增;确认后 Codex 退出并在当前终端执行更新,完成后重新启动即可;连接远程 app server 时不可用。见 SDK 与 App Server;CLI 文档未列出
/subagents在本会话的子代理线程之间切换见 子代理
/ps列出后台终端及其最近几行输出使用 unified_exec 时才会有后台终端;v0.158.0 起多行命令的预览不再只显示第一行,换行显示为 ↵,整条预览最多 80 个字符
/stop停止本会话的所有后台终端别名 /clean

界面、账户与其他

命令作用参数备注
/keymap查看并重映射快捷键,保存到 tui.keymap可选,debug 打开按键调试视图
/vim开关输入框的 Vim 模式默认开启可设 tui.vim_mode_default = true
/raw开关原始回滚模式,方便在终端里选中复制可选,on 或 off快捷键 Alt+R;默认值用 tui.raw_output_mode
/tui选择下次启动时的界面模式:Fullscreen(全屏对话记录)或 Scrollback(使用终端自己的回滚记录)v0.156.0 新增,需确认,保存为 tui.fullscreen_transcript,重启后生效;--no-alt-screen 等启动参数仍然优先;CLI 文档未列出
/theme选择语法高亮主题,保存到 tui.themev0.156.0 起新增 ada、babbage、curie、cushman、dali、davinci 六个内置主题,界面的强调色也跟随主题;自定义 .tmTheme 放在 $CODEX_HOME/themes
/statusline配置底部状态栏显示哪些项,保存到 tui.status_line
/title配置终端标题显示哪些项,保存到 tui.terminal_title
/pets选择或隐藏终端宠物可选,宠物 ID,或 off 隐藏别名 /pet
/experimental开关实验功能(如网络代理、运行时防止休眠)保存到配置,部分需重启生效;语音对话、worktree 与自动启动后台服务已转为默认开启,不再列在这里
/logout退出登录,清除本地凭据
/feedback把日志与诊断信息发送给维护者先选反馈类别,再决定是否上传日志;v0.158.0 起,同意上传日志时还会附上 TUI 客户端最近 1 MiB 的日志(client-logs.txt)。诊断日志写不进本地数据库时,Codex 会发出一次警告,提醒退出前用 /feedback 附带日志上传,或运行 codex doctor

此外还有只在开发构建中出现的 /rollout(打印会话记录文件路径)和 /test-approval,以及源码中标注“请勿使用”的 /debug-m-drop、/debug-m-update。

哪些情况下命令不可用:

  • 任务进行中:/new、/clear、/resume、/fork、/archive、/delete、/worktree、/init、/compact、/recap、/export、/review、/plan、/cd、/import、/memories、/experimental、/keymap、/tui、/vim、/theme、/pets、/logout 以及 Windows 的 /setup-default-sandbox 会提示当前不可用,其余命令随时可用。v0.156.0 起,MCP 服务器仍在启动时也能使用 /review。
  • 旁支对话中:只能用 /ide、/agents、/copy、/export、/raw、/diff、/mention、/status、/daemon、/warnings、/pwd、/usage;代码审查进行中不能开旁支对话。
  • 按功能开关显示:/goal、/plugins、/worktree、/voice 默认可用,关闭对应的功能开关(goals、plugins、worktrees、realtime_conversation)后隐藏;/voice 另外只在附带语音运行时的安装包里出现。

快捷键与输入技巧

按键或输入作用
/打开斜杠命令菜单(仅在消息开头)
@在工作区中搜索文件,并把路径插入输入框
行首 !把这一行当作本地 shell 命令直接执行:不经审批、不进沙箱(相当于完全访问),也不走会话的网络代理
$提及技能或应用,例如 $skill-creator
Ctrl+V、Ctrl+Alt+V粘贴剪贴板中的图片;直接粘贴图片文件的路径也会变成图片附件
Enter发送;Codex 正在工作时发送,会把新指令注入当前这一轮
TabCodex 正在工作时,把消息、斜杠命令或 shell 命令排到下一轮
Ctrl+J插入换行(终端支持时也可以用 Shift+Enter、Alt+Enter)
EscCodex 正在工作时中断当前这一轮
输入框为空时按两次 Esc浏览之前的提示词:←、→ 选择,Enter 把当前会话回退到所选提示词之前,并把它放回输入框重新编辑。v0.156.0 起在原会话中回退,不再分叉出新会话;已经发生的文件改动不会撤销
Up、Down翻阅草稿历史
Ctrl+R、Ctrl+S向前、向后搜索提示历史;Enter 采用,Esc 取消
Ctrl+G用 VISUAL(未设置时用 EDITOR)指定的编辑器编写长提示词,保存并关闭后回到输入框
Ctrl+O复制最近一条已完成的回复
Ctrl+T打开完整的对话记录视图;浏览之前的提示词时用来展开或收起详情
Ctrl+L清屏,保留当前对话
Alt+R开关原始回滚模式
F8开始或结束语音对话(v0.156.0 起,对应 tui.keymap.chat.toggle_voice)
Ctrl+X语音对话进行中开关麦克风(v0.155.0 起;自定义快捷键已占用 ctrl-x 时不启用这个默认键)
F2打开警告查看器,同 /warnings(v0.156.0 起)
F3、F4在对话记录中查找;聚焦某组工具活动查看详情(v0.156.0 起,见下文“全屏对话记录”)
Ctrl+/切换旁支对话
Shift+Tab在协作模式(如计划模式)之间切换
Alt+,、Alt+.在当前模型支持的档位间降低、提高推理强度,只对当前会话生效(也可以用 Shift+Down、Shift+Up)。v0.158.0 起可以一直调到 max,ultra 仍要在 /model 选中模型后的 More reasoning… 里选择
Shift+Left编辑已排队的消息(也可以用 Alt+Up)。v0.158.0 起不再按终端挑选,界面提示统一显示 Shift+Left(此前多数终端里提示的是 Alt+Up)
Alt+Left、Alt+Right切换到上一个、下一个 agent
输入框为空时按 ←打开代理总览(连接本机守护进程时)。v0.158.0 起,对话正在另一个应用中打开、这里只能只读查看时,除了 Esc 也可以按 ← 回到代理总览
空输入框中按 ?显示快捷键提示
Ctrl+C中断当前任务;空闲时再按一次退出(Ctrl+D 同样可以退出)

除 /、@、!、$、Esc(回溯)、Ctrl+C、Ctrl+D、Ctrl+V、Ctrl+Alt+V、Shift+Tab、Alt+Left、Alt+Right、F2 与空输入框里的 ←(把 editor.move_left 改成不含 left 后它就不再打开代理总览)这些固定按键外,上表中的快捷键都可以用 /keymap 或 config.toml 中的 tui.keymap 重新绑定。键名写作 ctrl-a、shift-enter、page-down 这样的形式;针对具体场景的绑定会覆盖 tui.keymap.global,绑定为空列表表示解绑。v0.156.0 新增的默认键(F2、F3、F4、F8)如果已经被你绑定给了别的操作,会自动让位,不会冲突。

全屏对话记录

v0.157.0 起,交互界面默认使用“全屏对话记录”(tui.fullscreen_transcript = true,v0.156.0 可以用 /tui 手动开启):对话记录画在终端的备用屏幕里,滚动、选择与搜索都由 Codex 自己处理,不再依赖终端的回滚记录。

操作作用
PgUp、PgDn、鼠标滚轮滚动对话记录
Ctrl+Home、Ctrl+End跳到开头、回到最新(也可以用 Alt+Shift+,、Alt+Shift+.)
鼠标拖动、双击、三击选择文本,双击选中整个词,三击选中整行;按住 Shift 单击可以扩展已有的选区(v0.157.0 起)
松开鼠标v0.158.0 起,用鼠标选中文字后一松开就自动复制,选区保留,由 tui.copy_on_select 控制(见下文)
Ctrl+Space用键盘开始选择,再用方向键调整选区
有选区时按 Ctrl+C、Enter复制选中的文本(Ctrl+Shift+C,以及终端转发过来的 Cmd+C 也可以),Enter 复制后回到最新;Esc 取消选择
右键有选区时复制选中的文本(在输入框里同样可用);v0.158.0 起,没有选区时把剪贴板里的文本粘贴到输入框,由 tui.right_click_paste 控制
单击链接打开链接,Markdown 链接和裸 URL 都可以
F3在整个对话记录中查找,不区分大小写,需要时会加载更早的历史;对话记录视图里也可以按 /
F4聚焦某组工具活动,查看它的详细内容

v0.158.0 起,从对话记录里复制选区会保留 Markdown 格式:粗体、斜体、行内代码、链接、标题、列表、引用和表格都按 Markdown 写出,只选中代码等原样内容时仍按原文复制;想要整条回复的 Markdown 原文,用 /copy 或 Ctrl+O。松开即复制与右键粘贴各有一个配置:

  • tui.copy_on_select:auto(默认)、always 或 never,对 Ctrl+T 打开的对话记录视图和恢复、派生会话时的预览同样生效。auto 下大多数终端松开即复制,在 tmux、Zellij 里也是;只有直接在 Ghostty 1.2 及以上、macOS 上的 Kitty、Windows Terminal、Windows 上的 VS Code 中运行时不自动复制,因为这些终端的复制快捷键在终端自己没有选区时会转发给 Codex,直接按它即可。never 表示只用上表的按键或右键复制。
  • tui.right_click_paste:auto(默认)、on 或 off。auto 在 Windows、Linux(含 WSL)上启用,on 另外在 macOS 上启用;两者在 SSH 会话和 VS Code 的终端里都不读取剪贴板,也只在输入框可以编辑、没有选区、没在查找时才粘贴。off 则不做这种粘贴,右键粘贴留给终端自己处理。

同样从 v0.158.0 起,新会话的标题改成精简样式并带一句随机问候语,全屏模式下空白处的花朵动画点一下会重播(受 tui.animations 与 tui.effects.welcome 控制)。全屏模式也不再显示启动提示,输入框上方不再轮换显示使用提示(那里只留给额度提醒),改为:一轮运行超过 30 秒时,工作状态指示下方会出现一条随机提示;从第三轮起,部分成功完成的回复后面也会出现一条(每次启动最多两条)。提示里的快捷键按你当前的绑定显示,也不会被选中或查找到;tui.show_tooltips = false 可以关掉。

想换回终端自己的回滚记录(例如习惯用终端的搜索与复制),在 /tui 里选 Scrollback 后重启,或在配置里写 tui.fullscreen_transcript = false。不使用备用屏幕时(--no-alt-screen 或 tui.alternate_screen = "never")也是回滚记录模式;tui.alternate_screen = "auto" 时,通过 SSH 使用 macOS 自带的 Terminal.app 会自动改用回滚记录。v0.157.0 起,tmux 中设置了 mouse off 时,Codex 不再捕获鼠标。

本页目录