斜杆命令(Slash Commands)是 Codex 桌面App与CLI内置的快捷指令系统。在输入框输入 / 即可唤起命令面板,快速切换工作模式、修改权限、执行专项任务、查看状态,无需手动编写冗长提示词。斜杆命令仅作用于当前 Thread 会话,不会修改全局配置文件;部分命令在桌面App、CLI中支持情况略有差异。
一、斜杆命令基础说明
- 触发方式:在Codex输入框直接输入
/,弹出下拉命令列表,选择或补全命令执行。 - 作用范围:绝大多数斜杆命令仅对当前会话生效,新建Thread会恢复默认配置。
- 使用场景:任务规划、权限快速切换、代码评审、会话快照、模型切换、MCP工具管理、查看任务状态。
- 区分:斜杆命令属于会话临时指令,优先级低于
requirements.toml企业强制配置,管理员锁定的参数无法通过斜杆命令覆盖。
二、核心常用斜杆命令详解
/plan 任务规划
作用:进入规划模式,Codex先分析项目,输出完整执行方案、风险点与验证标准,不会直接修改代码。
适用:大型重构、跨模块改造、复杂功能开发。
推荐流程:/plan → 审阅方案、调整计划 → 确认后再执行开发。
示例:
/plan 重构登录模块,拆分token解析与会话管理,保证对外接口不变
/goal 设置持久目标
作用:为当前Thread绑定长期持续任务目标,支持暂停、恢复、清空目标。目标会被持续保留,智能体依据目标持续迭代直至完成。
子命令:
/goal <目标描述>:设置当前任务目标/goal pause:暂停任务,保留上下文/goal resume:恢复已暂停目标任务/goal clear:清除当前持久目标,回到普通对话模式
适合长时间后台运行的工程任务,Codex Cloud云端沙箱场景尤为实用。
/review 代码评审
作用:自动对本次会话所有代码变更执行评审,检查Bug、安全漏洞、代码规范、性能问题,输出评审清单与修改建议。
支持查看Diff变更、生成PR评审意见,是代码提交前快速自检工具。
/share 生成会话快照
作用:生成当前Thread只读分享快照,用于团队复盘、代码评审、问题反馈。快照会自动尝试脱敏密钥,但仍建议人工复核敏感业务信息。
/permissions 权限/沙箱快速切换
作用:在当前会话快速调整沙箱模式与审批策略,快速切换只读、工作区写入模式。
注意:企业环境如果管理员通过
requirements.toml锁定沙箱,该命令无法修改权限。
/model 切换模型
作用:会话内临时切换底层编码模型,例如切换GPT-5-Codex,调整推理版本。仅当前Thread生效,重启会话恢复默认。
/reasoning 调整推理强度
作用:快速修改推理深度档位:fast / balanced / thorough,平衡任务速度与代码质量。
简单脚本选fast;大型代码重构使用thorough。
/mcp MCP工具状态查看
作用:查看当前会话MCP服务连接状态、已加载外部工具列表,快速排查MCP对接异常。
/side 分支侧会话
作用:创建临时分支会话,在不污染主线Thread上下文的前提下,尝试探索性代码实验、方案对比。侧会话变更不会自动合并到主线任务。
/status 查看任务状态
作用:查看当前任务运行信息,包含子代理状态、已执行命令、文件变更记录、Token消耗。
/diff 查看代码变更对比
作用:快速调出本次会话全部代码Diff视图,集中审阅所有文件修改内容。
/init 初始化项目AGENTS.md
作用:自动生成AGENTS.md脚手架模板,可直接填充项目编码规范、技术栈、文件黑名单,快速落地项目级智能体约束。
/feedback 提交反馈
作用:向官方提交Codex使用问题、功能建议,用于反馈Bug与产品优化意见。
三、Codex 斜杆命令速查表
| 命令 | 功能简述 | 适用场景 |
|---|---|---|
/plan | 生成任务执行方案,不修改代码 | 大型重构、多步骤开发 |
/goal | 设置/暂停/清除持久化长期任务目标 | 长时间后台工程任务 |
/review | 自动代码质量与安全评审 | 提交前代码自检 |
/share | 生成只读会话快照,用于分享复盘 | 团队协作、问题复现 |
/permissions | 会话快速切换沙箱与审批权限 | 临时切换只读/写入模式 |
/model | 临时切换模型 | 对比不同模型输出效果 |
/reasoning | 调整推理强度档位 | 平衡速度、代码质量 |
/mcp | 查看MCP外部工具连接状态 | MCP工具调试 |
/side | 创建独立临时分支会话 | 方案试验、风险探索 |
/status | 查看当前任务运行状态 | 排查任务执行异常 |
/diff | 查看本次会话所有代码变更Diff | 集中审阅代码改动 |
/init | 生成AGENTS.md项目规范模板 | 新项目初始化 |
/feedback | 提交产品反馈与Bug报告 | 上报使用问题 |
四、使用规范与最佳实践
- 复杂任务优先
/plan:跨文件重构、架构改造,先规划再动手,避免AI理解偏差造成大量无效修改。 - 高危代码操作前切换权限:陌生开源仓库,先用
/permissions切换为只读模式做代码阅读。 - 斜杆命令仅临时生效:会话结束、新建Thread后,所有斜杆修改的模型、权限、推理强度全部重置;如需永久保存,修改
config.toml配置文件。 /goal适合长任务:适合需要多轮迭代、可中断恢复的工程任务;简单单行代码生成不需要开启goal模式。- 快照分享务必人工检查:
/share自动脱敏不能保证完全过滤密钥、数据库连接串,分享前手动检查敏感信息。 - 企业管控限制:企业工作区管理员通过
requirements.toml锁定的安全策略、模型白名单,斜杆命令无法覆盖。
五、常见问题
Q:斜杆命令修改的权限,关闭App之后还保留吗?
A:不保留。斜杆命令属于会话临时参数,新建Thread、重启App都会重置。永久配置需要写入config.toml。
Q:桌面App与CLI的斜杆命令完全一致吗?
A:大部分通用命令互通;部分高级命令(如部分goal子命令)在CLI支持更完整,桌面App以面板UI搭配斜杆命令共同使用。
Q:可以在同一个Thread多次执行/plan修改方案吗?
A:可以。可以反复调用/plan重新生成或调整任务方案,无需新建会话。
六、小结
斜杆命令是Codex的快捷操作入口,可快速控制任务模式、权限、模型、代码评审与MCP工具,无需修改配置文件即可临时调整会话行为。熟练使用/plan、/goal、/review、/permissions等核心命令,能够大幅提升AI协同开发的可控性,规范任务流程,降低代码修改风险。配合AGENTS.md与配置文件,可实现临时指令+持久规范的组合管控,充分发挥Codex智能体开发能力。
0 条笔记