Skip to content

Codex CLI 提供丰富的 Slash 命令,让你在终端里不用重启 session 就能切换模型、调整权限、管理会话、审查代码改动。在对话 Composer 里输入 / 弹出命令列表,支持实时过滤。本文给出所有命令的说明和详细使用步骤。

Codex CLI Slash 命令

在终端里运行 Codex 时,输入 / 打开命令弹窗,选择或输入命令名称后回车执行。大多数命令立即生效,不需要重启 session。


命令总览

命令用途适用场景
/permissions设置 Codex 的操作权限(审批策略)会话中途切换 Auto / Read Only 等模式
/sandbox-add-read-dir给沙箱添加只读目录访问权限(仅 Windows)解锁在工作区外读取绝对路径的能力
/agent切换当前 Agent 线程查看或继续子 Agent 的工作
/apps浏览可用 Apps(连接器)并插入提示词在提示词里引用 App
/plugins浏览已安装和可发现的插件查看插件工具、安装新插件
/clear清空终端,开始新对话想彻底重置界面和会话时
/compact压缩对话历史,释放 token 空间长任务后防止上下文溢出
/copy复制最近一条 Codex 输出到剪贴板快速获取最后的回复文本
/diff显示 Git diff(含未追踪文件)提交前审查 Codex 的改动
/exit退出 CLI(同 /quit离开 session
/experimental开关实验性功能从 CLI 启用子 Agent 等实验功能
/feedback向维护者发送反馈和日志报告问题
/init在当前目录生成 AGENTS.md 脚手架为仓库/子目录设置持久指令
/logout注销登录在共享机器上清除凭据
/mcp列出当前 session 可用的 MCP 工具确认哪些外部工具可以被调用
/mention把文件附加到对话让 Codex 关注特定文件或目录
/model切换当前活跃模型(含推理强度)按任务难度切换模型
/fast开关 Fast 模式(GPT-5.4)控制是否使用快速输出模式
/plan切换到 Plan 模式,可带提示词让 Codex 先出方案再执行
/personality选择 Codex 的沟通风格让回复更简洁、更详细或更协作
/ps查看后台终端及最近输出检查长时间运行的后台命令
/stop停止所有后台终端取消当前 session 的后台任务
/fork把当前对话分叉为新线程保留原记录的同时探索新思路
/resume从 session 列表恢复已保存的对话继续之前中断的工作
/new在同一 CLI session 里开始新对话切换任务但不离开终端
/quit退出 CLI立即离开 session
/review让 Codex 审查当前工作区改动提交前或 Codex 完成任务后审查
/status显示 session 配置和 token 用量确认模型、审批策略和上下文容量
/debug-config打印配置层次和策略诊断信息排查配置优先级问题
/statusline交互式配置 TUI 底部状态栏自定义显示哪些信息
/title交互式配置终端标题栏内容自定义终端窗口/标签页标题

/quit/exit 效果相同,都退出 CLI。使用前请先保存或提交重要改动。 /approvals 仍作为兼容别名存在,但不再在弹窗里显示。


常用命令详解

/model — 切换模型

  1. 在 Composer 里输入 /model,回车
  2. 从弹窗里选择模型(如 gpt-4.1-minigpt-4.1
  3. 运行 /status 确认切换生效

/fast — 开关 Fast 模式

/fast on       # 开启
/fast off      # 关闭
/fast status   # 查看当前状态

如果想让设置持久化,Codex 会提示是否保存到配置。TUI 底部状态栏也可通过 /statusline 添加 Fast 模式指示。


/permissions — 调整审批策略

  1. 输入 /permissions,回车
  2. 选择审批预设(如 Auto 无人值守 / Read Only 只读审查)

之后的所有操作都会遵循新策略,直到你再次修改。


/plan — 切换到 Plan 模式

/plan
/plan 规划这个服务的迁移方案

进入 Plan 模式后 Codex 先出方案,等你确认后再执行。可以在命令后直接跟提示词文本。任务运行中时该命令暂时不可用。


/compact — 压缩上下文

在长时间交互后,用 /compact 让 Codex 将之前的对话压缩为摘要,释放 token 空间,同时保留关键细节。


/diff — 查看 Git 改动

显示已 staged、未 staged 的改动以及 Git 未追踪的新文件,方便你在提交前完整审查 Codex 的全部修改。


/review — 代码审查

  1. 输入 /review
  2. 可以配合 /diff 同时使用,先看改动再看审查意见

Codex 会聚焦行为变化和缺少测试的地方。使用 review_model 配置项可以指定审查时使用的模型。


/status — 查看 Session 状态

显示当前模型、审批策略、可写目录、token 用量等信息,适合随时确认 Codex 在预期的配置下工作。


/debug-config — 配置诊断

打印配置层次(优先级从低到高)、每层的开关状态,以及策略细节(如 allowed_approval_policiesmcp_serversexperimental_network 等)。排查"配置文件里改了但没有生效"的问题时很有用。


/init — 生成 AGENTS.md

在当前目录生成 AGENTS.md 脚手架,可以在里面写仓库级别的持久指令(如代码规范、测试要求),Codex 后续 session 都会读取并遵循。


/statusline — 自定义状态栏

交互式选择和排序 TUI 底部状态栏里显示的项目:模型、推理模式、上下文统计、速率限制、git 分支、token 计数、session ID、当前目录、Codex 版本等。配置持久化到 config.tomltui.status_line


/title — 自定义终端标题

交互式选择终端窗口/标签页标题里显示的内容:app 名称、项目、进度 spinner、状态、线程 ID、git 分支、模型、任务进度等。持久化到 tui.terminal_title


常见问题

Q: /clearCtrl+L 有什么区别?

A: Ctrl+L 只清空终端视图,对话历史保留,Codex 仍然"记得"之前说的内容。/clear 会同时清空视图开始一个全新对话。任务运行中时两者都不可用。

Q: /compact 会丢失重要上下文吗?

A: Codex 会尽量保留关键决策和结论,但长对话中的细节可能被压缩掉。建议在一个大任务完整结束后使用,而不是在任务中途频繁压缩。

Q: /model 切换的模型只对当前 session 有效吗?

A: 是的,/model 切换只对当前 session 生效。如果想持久化模型设置,在 ~/.codex/config.toml 里设置 model 字段,或用 /fast 时选择保存到配置。