斜杠命令
交互会话中的全部斜杠命令(按用途分组),常用快捷键与输入技巧,以及全屏对话记录的操作
在输入框开头输入 / 会弹出命令菜单,继续输入会按命令名的前缀筛选(不分大小写,与输入完全相同的命令排在最前);支持参数的命令把参数写在同一行,例如 /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.theme | v0.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 正在工作时发送,会把新指令注入当前这一轮 |
Tab | Codex 正在工作时,把消息、斜杠命令或 shell 命令排到下一轮 |
Ctrl+J | 插入换行(终端支持时也可以用 Shift+Enter、Alt+Enter) |
Esc | Codex 正在工作时中断当前这一轮 |
输入框为空时按两次 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 不再捕获鼠标。