自学教程

Codex 斜杆命令与速查表

斜杆命令(Slash Commands)是 Codex 桌面App与CLI内置的快捷指令系统。在输入框输入 / 即可唤起命令面板,快速切换工作模式、修改权限、执行专项任务、查看状态,无需手动编写冗长提示词。斜杆命令仅作用于当前 Thread 会话,不会修改全局配置文件;部分命令在桌面App、CLI中支持情况略有差异。

一、斜杆命令基础说明

  1. 触发方式:在Codex输入框直接输入 /,弹出下拉命令列表,选择或补全命令执行。
  2. 作用范围:绝大多数斜杆命令仅对当前会话生效,新建Thread会恢复默认配置。
  3. 使用场景:任务规划、权限快速切换、代码评审、会话快照、模型切换、MCP工具管理、查看任务状态。
  4. 区分:斜杆命令属于会话临时指令,优先级低于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报告上报使用问题

四、使用规范与最佳实践

  1. 复杂任务优先 /plan:跨文件重构、架构改造,先规划再动手,避免AI理解偏差造成大量无效修改。
  2. 高危代码操作前切换权限:陌生开源仓库,先用/permissions切换为只读模式做代码阅读。
  3. 斜杆命令仅临时生效:会话结束、新建Thread后,所有斜杆修改的模型、权限、推理强度全部重置;如需永久保存,修改config.toml配置文件。
  4. /goal适合长任务:适合需要多轮迭代、可中断恢复的工程任务;简单单行代码生成不需要开启goal模式。
  5. 快照分享务必人工检查:/share自动脱敏不能保证完全过滤密钥、数据库连接串,分享前手动检查敏感信息。
  6. 企业管控限制:企业工作区管理员通过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 条笔记