Appearance
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 — 切换模型
- 在 Composer 里输入
/model,回车 - 从弹窗里选择模型(如
gpt-4.1-mini或gpt-4.1) - 运行
/status确认切换生效
/fast — 开关 Fast 模式
/fast on # 开启
/fast off # 关闭
/fast status # 查看当前状态如果想让设置持久化,Codex 会提示是否保存到配置。TUI 底部状态栏也可通过 /statusline 添加 Fast 模式指示。
/permissions — 调整审批策略
- 输入
/permissions,回车 - 选择审批预设(如
Auto无人值守 /Read Only只读审查)
之后的所有操作都会遵循新策略,直到你再次修改。
/plan — 切换到 Plan 模式
/plan
/plan 规划这个服务的迁移方案进入 Plan 模式后 Codex 先出方案,等你确认后再执行。可以在命令后直接跟提示词文本。任务运行中时该命令暂时不可用。
/compact — 压缩上下文
在长时间交互后,用 /compact 让 Codex 将之前的对话压缩为摘要,释放 token 空间,同时保留关键细节。
/diff — 查看 Git 改动
显示已 staged、未 staged 的改动以及 Git 未追踪的新文件,方便你在提交前完整审查 Codex 的全部修改。
/review — 代码审查
- 输入
/review - 可以配合
/diff同时使用,先看改动再看审查意见
Codex 会聚焦行为变化和缺少测试的地方。使用 review_model 配置项可以指定审查时使用的模型。
/status — 查看 Session 状态
显示当前模型、审批策略、可写目录、token 用量等信息,适合随时确认 Codex 在预期的配置下工作。
/debug-config — 配置诊断
打印配置层次(优先级从低到高)、每层的开关状态,以及策略细节(如 allowed_approval_policies、mcp_servers、experimental_network 等)。排查"配置文件里改了但没有生效"的问题时很有用。
/init — 生成 AGENTS.md
在当前目录生成 AGENTS.md 脚手架,可以在里面写仓库级别的持久指令(如代码规范、测试要求),Codex 后续 session 都会读取并遵循。
/statusline — 自定义状态栏
交互式选择和排序 TUI 底部状态栏里显示的项目:模型、推理模式、上下文统计、速率限制、git 分支、token 计数、session ID、当前目录、Codex 版本等。配置持久化到 config.toml 的 tui.status_line。
/title — 自定义终端标题
交互式选择终端窗口/标签页标题里显示的内容:app 名称、项目、进度 spinner、状态、线程 ID、git 分支、模型、任务进度等。持久化到 tui.terminal_title。
常见问题
Q: /clear 和 Ctrl+L 有什么区别?
A: Ctrl+L 只清空终端视图,对话历史保留,Codex 仍然"记得"之前说的内容。/clear 会同时清空视图和开始一个全新对话。任务运行中时两者都不可用。
Q: /compact 会丢失重要上下文吗?
A: Codex 会尽量保留关键决策和结论,但长对话中的细节可能被压缩掉。建议在一个大任务完整结束后使用,而不是在任务中途频繁压缩。
Q: /model 切换的模型只对当前 session 有效吗?
A: 是的,/model 切换只对当前 session 生效。如果想持久化模型设置,在 ~/.codex/config.toml 里设置 model 字段,或用 /fast 时选择保存到配置。