“codex cli 内的指令”，通常主要是指 交互模式里的 slash commands（斜杠命令），也就是你先运行 codex 进入界面后，在输入框里键入 / 能看到的那一批内置命令。官方说明里，这些命令用于在当前会话里快速切模型、切权限、看 diff、压缩上下文、分叉线程等。(OpenAI开发者)

先给你一个结论：Codex CLI 里的内置 slash commands 目前包括 /permissions、/sandbox-add-read-dir、/agent、/apps、/plugins、/clear、/compact、/copy、/diff、/exit、/experimental、/feedback、/init、/logout、/mcp、/mention、/model、/fast、/plan、/personality、/ps、/stop、/fork、/resume、/new、/quit、/review、/status、/debug-config、/statusline、/title。另外，旧的 /approvals 仍可作为别名使用，但已不再显示在命令列表中。(OpenAI开发者)

下面我按用途详细讲。

一、会话控制类

/new

在同一个 CLI 进程里开启一个新对话。 适合当前聊天已经跑偏、上下文太脏，但你又不想退出 Codex 重开。(OpenAI开发者)

例子：

bash
/new

你可以把它理解成“清空聊天上下文，但还留在这个项目/这个终端环境里”。

/resume

恢复之前保存过的会话，从旧线程继续。 适合你昨天做到一半，今天想接着干，不想重新解释项目背景。(OpenAI开发者)

例子：

bash
/resume

/fork

把当前会话分叉成一个新线程。 这个很适合“保留原方案，同时试另一种做法”。比如你已经让它写了一版实现，现在想让它再试一版“更保守的改法”或“性能优先的改法”，就可以 fork。(OpenAI开发者)

例子：

bash
/fork

/clear

清空当前可见终端，并重新开始一段新的聊天。 它的作用比 /new 更偏“界面和会话一起重置”。长时间使用后界面太乱时很好用。(OpenAI开发者)

例子：

bash
/clear

/quit 与 /exit

两者作用一样，都是退出 CLI。官方明确写了它们等价。(OpenAI开发者)

例子：

bash
/quit
/exit

二、模型与输出风格类

/model

切换当前会话使用的模型；在支持的情况下，也能一起调 reasoning effort。 适合做任务前先切模型：简单改字可以用轻量模型，复杂重构再切强模型。官方示例里可从弹窗中选择模型，切换后可再用 /status 验证。(OpenAI开发者)

例子：

bash
/model

使用场景：

  • 让它解释代码：偏快模型即可
  • 复杂调试、架构调整：切更强推理模型
  • 想省 token / 省等待：切轻量模型

/fast

这是 GPT-5.4 相关的快速模式开关。 官方写法支持：

bash
/fast on
/fast off
/fast status

用于打开、关闭、查看当前线程是否启用了 Fast mode。(OpenAI开发者)

适合场景：

  • 你更在意响应速度而不是最深度推理
  • 当前任务是小修小补、查一下文件、快速问答

/personality

调整 Codex 的表达风格，不改你的任务要求，只改它“怎么说”。官方列出的 personality 有 friendly、pragmatic、none。none 表示禁用人格风格。(OpenAI开发者)

例子：

bash
/personality

大致理解：

  • friendly：更友好、更有人味
  • pragmatic：更直接、更工程化
  • none：尽量不加风格说明，回归中性

这个很适合你嫌它“太啰嗦”或者“太冷”时临时切一下。

三、权限、安全、沙箱类

/permissions

设置 Codex 在当前会话里什么能自动做、什么必须先问你。 官方描述是：可在会话中途放宽或收紧审批要求，比如从 Read Only 切到 Auto。(OpenAI开发者)

例子：

bash
/permissions

适合场景：

  • 刚开始先只读，先让它分析仓库
  • 确认可信后，切成更自动的模式让它改代码
  • 任务敏感时再切回严格审批

这通常是最重要的 slash command 之一。

/sandbox-add-read-dir

这个是 Windows only，给沙箱额外增加一个可读目录。 如果命令需要读取当前工作区之外的绝对路径，而默认沙箱不让，就用它放行。(OpenAI开发者)

例子：

bash
/sandbox-add-read-dir

适合场景：

  • 你的配置文件、日志、共享目录不在当前 repo 里
  • 想让 Codex 读取另一个盘符/另一个目录的只读资料

/experimental

打开或关闭实验性功能。官方举例包括 subagents。(OpenAI开发者)

例子：

bash
/experimental

适合场景：

  • 你想尝试还没完全稳定的新能力
  • 文档或版本说明提到某功能需要 experimental 才能启用

/debug-config

打印配置层与 requirements 诊断信息，用来排查配置优先级、策略要求、网络限制等问题。(OpenAI开发者)

例子：

bash
/debug-config

特别适合下面这些问题：

  • 我明明改了 config.toml，为什么没生效？
  • 为什么当前审批策略和我以为的不一样？
  • 为什么网络或某些工具不可用？

/logout

退出登录，清除本地凭据。共享机器上尤其有用。(OpenAI开发者)

例子：

bash
/logout

四、代码查看与工作流类

/diff

直接查看当前 Git diff，连 Git 尚未跟踪的新文件也能显示。 这几乎是“验收修改”的必备命令。让 Codex 改完以后，先 /diff 看它改了什么，再决定是否继续。(OpenAI开发者)

例子：

bash
/diff

典型流程：

  1. 让 Codex 改代码
  2. /diff 看改动
  3. 跑测试
  4. 再决定 commit

/review

让 Codex 对当前 working tree 做代码审查。 官方建议在 Codex 完成工作后，或者你想对本地改动做“第二双眼睛”检查时用它。(OpenAI开发者)

例子：

bash
/review

适合：

  • 检查有没有明显 bug
  • 看改动是否符合风格
  • 找遗漏测试、潜在边界条件

可以把它理解为“请你站在 reviewer 角度再看一遍”。

/plan

把当前会话切到计划模式，也可顺手发送一个 prompt。 适合在写代码前先让它给出实施方案，而不是直接动手。官方写的是 “propose an execution plan before implementation work starts”。(OpenAI开发者)

例子：

bash
/plan

你可以这样用：

bash
/plan 先分析这个仓库里认证模块的重构方案

非常适合：

  • 复杂需求拆解
  • 大范围重构
  • 想先确认方案再让它改代码

/init

在当前目录生成 AGENTS.md 脚手架。 AGENTS.md 用来保存这个仓库或子目录下的长期指导说明，例如代码风格、测试要求、提交规范、禁改区域等。(OpenAI开发者)

例子：

bash
/init

适合：

  • 新项目第一次引入 Codex
  • 团队想固定“这个仓库里的工作规则”

/mention

把文件附加到当前对话，相当于点名让 Codex 看特定文件或目录。(OpenAI开发者)

例子：

bash
/mention

搭配普通提问很好用，比如：

  • 先 /mention 选 src/auth.ts
  • 再问：这里的 token 刷新逻辑有没有 race condition？

/copy

复制最近一次已完成的 Codex 输出。 适合快速拿走它刚刚写的计划、解释、总结。官方也提到可以按 Ctrl+O。(OpenAI开发者)

例子：

bash
/copy

/compact

把当前可见对话压缩总结，以释放上下文 token。 长会话里非常重要：不然聊久了上下文会越来越贵，也更容易丢重点。官方明确写这是在长会话后保留关键点又不撑爆上下文窗口的办法。(OpenAI开发者)

例子：

bash
/compact

适合：

  • 你已经聊了很多轮
  • 任务还没做完
  • 想继续，但又怕上下文太大

这是长任务里的高频命令。

五、线程、代理、后台终端类

/agent

切换当前活动的 agent thread，用于查看或继续子代理线程里的工作。(OpenAI开发者)

例子：

bash
/agent

适合：

  • 你启用了 subagent / 多线程工作流
  • 主线程和子线程分工了不同任务
  • 想切过去看某个子任务做到哪了

/ps

查看实验性的后台 terminal 以及最近输出。 如果 Codex 在后台跑了较长命令，用它可以看状态，而不用离开主对话。(OpenAI开发者)

例子：

bash
/ps

很像 shell 里查看后台任务的感觉，但它是 Codex 会话层面的。

/stop

停止所有当前会话启动的后台终端任务。(OpenAI开发者)

例子：

bash
/stop

适合：

  • 测试跑卡住了
  • 某个后台命令失控了
  • 你想立刻中断长任务

六、状态与界面配置类

/status

显示当前会话配置与 token 使用情况。 官方列出的内容包括：当前模型、审批策略、可写根目录、剩余上下文容量等。(OpenAI开发者)

例子：

bash
/status

这是排查“它现在到底在什么模式下工作”的第一命令。

建议你在这几种情况都跑一下：

  • 刚切完 /model
  • 刚改完 /permissions
  • 长会话担心上下文不够
  • 不确定哪些目录可写

/statusline

交互式配置 TUI 底部状态栏显示哪些字段，以及顺序，并可持久化到 config.toml。官方举例包括 model/context/limits/git/tokens/session 等。(OpenAI开发者)

例子：

bash
/statusline

适合：

  • 你想在底部一直看到模型名
  • 想实时看到 token / context / git branch
  • 想自定义终端里状态信息布局

/title

交互式配置终端窗口或标签页标题显示哪些字段，以及顺序。官方举例包括 project、status、thread、branch、model、task progress。(OpenAI开发者)

例子：

bash
/title

适合同时开多个 Codex 窗口时快速区分：

  • 哪个窗口对应哪个项目
  • 哪个在线程 A / B
  • 哪个在跑哪个任务

七、连接器、插件、工具类

/apps

浏览 apps（连接器），并插入到 prompt 里。官方写法是把 app 作为 $app-slug 附加到提示里，再让 Codex 使用。(OpenAI开发者)

例子：

bash
/apps

适合：

  • 想把外部应用/连接器接入当前任务
  • 想在提问时显式指定某个 app 上下文

/plugins

浏览已安装和可发现的插件，也可管理插件可用性。(OpenAI开发者)

例子：

bash
/plugins

适合：

  • 查看有哪些插件工具能用
  • 安装官方推荐插件
  • 控制插件启停

/mcp

列出已配置的 MCP 工具，查看当前会话里 Codex 能调用哪些外部工具。(OpenAI开发者)

例子：

bash
/mcp

如果你配了 Model Context Protocol servers，这个命令很关键。它相当于检查“我接的外部工具链今天到底有没有挂上”。

八、反馈与诊断类

/feedback

发送日志给 Codex 维护方，用于报告问题或共享诊断信息。(OpenAI开发者)

例子：

bash
/feedback

适合：

  • CLI 异常
  • 界面 bug
  • 某能力明显表现不正常，想附日志反馈

九、你实际最常用的 8 个内部命令

如果你不是想背全表，而是想先真正会用，我建议优先掌握这 8 个：

bash
/status
/permissions
/model
/plan
/diff
/review
/compact
/fork

这 8 个基本覆盖了：

  • 看当前状态
  • 控制能不能自动执行
  • 切模型
  • 先规划
  • 看改动
  • 做审查
  • 压缩长上下文
  • 分叉新方案。(OpenAI开发者)

十、几个非常实用的交互小技巧

除了 / 命令，官方还给了几个在 CLI 里很实用的输入方式：

  • 输入 @：打开工作区的模糊文件搜索，把文件路径插入消息里。(OpenAI开发者)
  • 输入 !命令：直接运行本地 shell 命令，例如 !ls，输出会作为用户提供的命令结果喂给 Codex。(OpenAI开发者)
  • Codex 正在运行时按 Enter：向当前轮次追加指令。(OpenAI开发者)
  • Codex 正在运行时按 Tab：把提示或 slash command 排队到下一轮执行。(OpenAI开发者)
  • Ctrl+G：打开完整编辑器写长 prompt。(OpenAI开发者)
  • Esc 连按：回到之前的用户消息并可从那里 fork。(OpenAI开发者)

十一、补充：自定义“斜杠命令”

Codex 以前支持把本地 Markdown prompt 做成 /prompts:xxx 这种自定义命令；但官方现在已标记为 deprecated，推荐改用 skills。也就是说，自定义 prompt 还能看见相关文档，但官方方向已经转向 skills 了。(OpenAI开发者)

旧方式大概长这样：

bash
/prompts:draftpr FILES="src/a.ts src/b.ts" PR_TITLE="Refactor auth flow"

它会把你放在 ~/.codex/prompts/*.md 里的模板展开后作为提示发送。(OpenAI开发者)

十二、给你一套最实用的日常流程

如果你平时用 Codex CLI 写代码，我建议就按这个顺序来：

bash
codex
/status
/permissions
/plan
/diff
/review
/compact

意思是：

  1. 先启动
  2. 看当前模式
  3. 设置权限
  4. 先出方案
  5. 改完看 diff
  6. 再做 review
  7. 长会话时 compact

这套流程最稳。(OpenAI开发者)

如果你愿意，我下一条可以直接给你整理成一份 “Codex CLI 内部指令中文速查表”，做成表格版：命令 | 作用 | 常见写法 | 推荐使用时机。