如果你天天在终端里跟 Codex 打交道,但用来用去就那几个命令——切模型、看状态、退出——那这篇文章会让你怀疑自己之前是不是在用一个阉割版。
Codex CLI 的斜杠命令一共 30 多个,覆盖了从模型切换、权限调整、上下文压缩、代码 Review、后台进程管理到 MCP 工具调用的几乎所有场景。在 composer 里敲一个
/,菜单就弹出来了。这篇文章按实际使用场景把所有命令分成九组拆开讲,不按字母排序——目的是让你看完之后能直接对照自己的工作流找到对应命令。
先说一个最实用的小机制
在开始之前先记住这个细节:当一个任务正在跑的时候,你可以提前敲一个斜杠命令,按 Tab 把它排进下一轮。Codex 等当前任务跑完之后才会真正解析它,所以菜单和报错都会延后显示,但命令补全当时就能用。这意味着你不用干等任务结束再去敲下一步。
一、会话生命周期:开始、切换、结束
这是用得最频繁的一类,也是最容易搞混的。先把 /new、/clear、Ctrl+L 三个的区别捋清楚。
/new 在同一个 CLI 会话里开一个新对话。上下文清掉,但终端历史保留。适合"想换个话题但不想离开终端"的场景。
/clear 比 /new 更彻底——终端画面也清掉,对话也重置。适合想要一个干干净净的开始。
而 Ctrl+L 只是清屏,对话上下文完全保留。这点和很多人的直觉相反。任务正在跑的时候,/clear 和 Ctrl+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_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency、experimental_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、/clear、Ctrl+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 路径 |
| 复制最后输出 | /copy 或 Ctrl+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"的时候,你大概率能直接甩一个斜杠命令过去。