Codex CLI 30+ 斜杠命令全拆解:一个 `/` 让你少敲一万次键盘

23 阅读8分钟

如果你天天在终端里跟 Codex 打交道,但用来用去就那几个命令——切模型、看状态、退出——那这篇文章会让你怀疑自己之前是不是在用一个阉割版。

Codex CLI 的斜杠命令一共 30 多个,覆盖了从模型切换、权限调整、上下文压缩、代码 Review、后台进程管理到 MCP 工具调用的几乎所有场景。在 composer 里敲一个 /,菜单就弹出来了。

这篇文章按实际使用场景把所有命令分成九组拆开讲,不按字母排序——目的是让你看完之后能直接对照自己的工作流找到对应命令。

先说一个最实用的小机制

在开始之前先记住这个细节:当一个任务正在跑的时候,你可以提前敲一个斜杠命令,按 Tab 把它排进下一轮。Codex 等当前任务跑完之后才会真正解析它,所以菜单和报错都会延后显示,但命令补全当时就能用。这意味着你不用干等任务结束再去敲下一步。

一、会话生命周期:开始、切换、结束

这是用得最频繁的一类,也是最容易搞混的。先把 /new/clearCtrl+L 三个的区别捋清楚。

/new同一个 CLI 会话里开一个新对话。上下文清掉,但终端历史保留。适合"想换个话题但不想离开终端"的场景。

/clear/new 更彻底——终端画面也清掉,对话也重置。适合想要一个干干净净的开始。

Ctrl+L 只是清屏,对话上下文完全保留。这点和很多人的直觉相反。任务正在跑的时候,/clearCtrl+L 都不能用。

/resume 从已保存的会话列表里挑一个继续,原始历史保持不动。/fork 则是把当前对话克隆成一个新线程并分配新 ID,原对话不动——典型用法是想试一个不一样的方向,但不想丢掉现在这条线。如果你要 fork 的是已保存的会话而不是当前活动的,得在 shell 里跑 codex fork 调出会话选择器。

/quit/exit 是同义词,直接退出 CLI——退之前记得保存。/logout 清掉本地凭证,共享机器上用。

二、模型、模式、风格:决定 Codex 怎么思考

/model 切换当前模型,能选 reasoning effort 的模型也会让你选。比如日常用 gpt-4.1-mini,需要深度推理的活儿换 gpt-4.1。切完之后跑一个 /status 验证。

/fast 是 Fast 模式的开关,三种用法:/fast on/fast off/fast status。Codex 会主动问你要不要把这个设置持久化。如果你想在底部状态栏一直看到 Fast 模式状态,可以通过 /statusline 把它加进去。

/personality 改 Codex 的说话风格,不需要改你的提示词。内置三种:friendly(友好)、pragmatic(务实)、none(关闭风格指令)。如果当前模型不支持 personality,这个命令会被自动隐藏——找不到不是 bug。

/plan 切到计划模式——Codex 会先给你一个执行计划再动手。支持 inline 写法:

/plan 帮我设计这个服务的迁移方案

计划模式下还能贴内容、附图。注意:正在跑任务的时候这个命令不可用

/experimental 打开或关掉实验性功能,比如 Apps、Smart Approvals、subagents。改完可能要重启 Codex 才能生效。

三、权限与沙箱:决定 Codex 能干什么

/permissions 调整审批策略,预设里有 Auto(全自动放行)和 Read Only(只读)等。老命令 /approvals 还能用——它现在是 /permissions隐藏别名,不在斜杠菜单里显示了,但老用户的肌肉记忆不会废。

/sandbox-add-read-dir 只在 Windows 原生 CLI 下可用。它给沙箱多授权一个绝对路径的读权限:

/sandbox-add-read-dir C:\absolute\directory\path

当某个命令需要读当前可读根目录之外的东西时用得上。其他平台找不到这个命令是正常的。

四、上下文管理:让对话保持精瘦

/compact 把当前对话总结成一段简短摘要,把前面的轮次替换掉,省下 token 但留下关键信息。长会话末尾必备——避免上下文窗口被塞爆。

/mention 把文件或目录拉进对话,比如 /mention src/lib/api.ts,从弹出来的列表里选。之后 Codex 都能直接引用这个文件。

/copy 复制最后一条已完成的 Codex 输出。注意三个细节:第一,如果当前轮还在跑,它复制的是上一条已完成的,而不是正在生成的内容;第二,TUI 主界面下 Ctrl+O 是同样的快捷键,不需要打开斜杠菜单;第三,第一条输出还没出来之前、或刚 rollback 之后,这个命令不可用。

五、代码 Review:提交前的两道关

/diff 显示完整的 Git diff——已暂存的、未暂存的、还没被 Git 追踪的全都列出来。提交前过一遍很有用。

/review 让 Codex 自己 review 你的工作树,重点关注行为变更和缺失的测试。默认用当前会话的模型,但你可以在 config.toml 里设 review_model 单独指定一个 review 专用的模型。Review 完用 /diff 对照看具体改动。

六、诊断和排查:东西不对劲的时候

/status 打印当前模型、审批策略、可写目录、剩余上下文容量。和在 shell 里跑 codex status 看到的内容一样。

/debug-config深度排错神器。它会把配置层从最低优先级到最高全部打出来,附带策略诊断信息,包括:

allowed_approval_policiesallowed_sandbox_modesmcp_serversrulesenforce_residencyexperimental_network

当你发现实际行为和 config.toml 里写的对不上的时候,第一时间跑这个——能省你半小时翻文档。

/mcp 列出当前会话能调用的所有 MCP 工具和服务器。/feedback 把日志和诊断信息发给 Codex 维护者。

七、后台终端:长时间任务不挡道

这一组命令需要 unified_exec 已启用——否则列表可能是空的。

/ps 列出所有后台终端,每个最多显示最近 3 行非空输出。可以一眼看出长时间任务进展到哪里了,不用跳出主对话。

/stop 停掉当前会话所有后台终端。/clean 是它的别名——两个名字一回事。

八、Apps、Plugins、Agents:扩展能力

/apps 浏览 connectors。选中之后,对应的 app 会以 $app-slug 的形式插进 composer,你直接接着写提示词就行。

/plugins 打开插件浏览器,能看到已装的、可发现的、当前状态。一个不少人不知道的细节:在已装插件上Space 切换启用状态

/agent 切换当前 agent 线程——用来检查或继续某个 subagent 的工作。

九、配置 UI:可视化改 config.toml

下面三个命令都是交互式选择器,改完会直接写进 config.toml,不用手动编辑文件。

/statusline 配 TUI 底部状态栏。可选项包括:模型、模型+推理深度、上下文统计、速率限制、Git 分支、token 计数器、会话 ID、当前目录/项目根、Codex 版本、Fast 模式指示。改动持久化到 tui.status_line

/title 配终端窗口或标签页的标题。可选项:应用名、项目、加载圈、状态、线程、Git 分支、模型、任务进度。持久化到 tui.terminal_title

/init 在当前目录生成一个 AGENTS.md 脚手架。这个文件用来存仓库级别的持久化指令——编辑后 commit 进去,以后所有会话都会继承你定的约定。

几个容易踩的坑

写到这里把容易混淆的点单独拎出来再强调一遍:

/clear 不等于 Ctrl+L。前者重置对话,后者只清屏——别再混用了。

/copy 在某些时刻不可用。第一条输出还没生成之前不能用,rollback 之后立刻也不能用——它只能复制"已完成"的输出。

/sandbox-add-read-dir 只有 Windows 原生 CLI 才有,其他平台不存在。

/personality 找不到? 当前模型可能不支持 personality 指令,Codex 会主动把这个命令藏掉。

/approvals 还能用,但不在菜单里。它是 /permissions 的隐藏别名。

任务跑的时候 /plan/clearCtrl+L 都用不了。要么等任务结束,要么用 Tab 把命令排队。

一张表收工

想干什么用哪个命令
同终端开新对话/new
清屏并开新对话/clear
继续之前的会话/resume
克隆当前对话开分支/fork
退出 CLI/quit/exit
登出/logout
切模型/model
切 Fast 模式/fast on|off|status
改说话风格/personality
让它先做计划再动手/plan
开关实验功能/experimental
调审批策略/permissions
加沙箱读目录(Win)/sandbox-add-read-dir
压缩长对话/compact
加文件进对话/mention 路径
复制最后输出/copyCtrl+O
看 diff/diff
让它 review 代码/review
看会话信息/status
排查配置层/debug-config
列 MCP 工具/mcp
提交反馈/feedback
看后台终端/ps
停所有后台终端/stop(或 /clean
浏览 connectors/apps
浏览插件/plugins
切 agent 线程/agent
配底部状态栏/statusline
配终端标题/title
生成 AGENTS.md/init

写在最后

斜杠命令的设计哲学其实很清楚:不要离开终端。切模型、调权限、压上下文、看 diff、做 review、排查配置——全都用一个 / 打开。一旦肌肉记忆建立起来,你会发现绝大多数原本要打开浏览器或翻文档的事,在 composer 里几秒就能搞定。

把这篇当小抄收着,用上一周,下次再有人问你"Codex CLI 怎么 xxx"的时候,你大概率能直接甩一个斜杠命令过去。