CX-03 Commands 完整指南：App 里的 slash commands 与工作流入口
本篇以 Codex App 的 slash commands 为主线。CLI slash commands 只作为核对和排查补充。
⠀
主要来源：OpenAI Codex App Commands、Codex CLI Slash Commands、Codex Follow Goals 官方文档。本篇按 2026-05-30 可查官方文档与 Codex CLI v0.135.0 修订；命令会随 App 版本、实验开关、插件和权限变化，最终以你当前 App 输入 / 后看到的列表为准。
课程信息
⠀
-
作者：老金
-
GitHub：https://github.com/KimYx0207
-
公众号：老金带你玩AI
-
X（Twitter）：老金带你玩AI
-
个人博客：https://aiking.dev
-
预计学时：2-3小时
-
难度等级：⭐⭐ 入门级
-
更新日期：2026年5月30日
-
信息来源：OpenAI Codex App Commands、CLI Slash Commands、Follow Goals 官方文档
-
前置要求：已完成 CX-01 安装 和 CX-02 桌面工作流
📚 本课学习目标
⠀
完成本课学习后，你将能够：
⠀
-
理解Commands的本质：掌握slash命令是App的快速工作流入口，不是高级玩具
-
学会发现命令：在App中输入/查看当前可用命令，不依赖死记硬背
-
掌握核心稳定命令：熟练使用/status、/plan、/review、/mcp、/feedback
-
理解计划模式：知道什么时候该先规划再执行，用/plan进入
-
区分命令层级：分清App命令、CLI命令、版本相关命令、Skills各自的位置
-
学会压缩上下文：在长线程中使用/compact保持对话效率
-
理解命令的变化性：知道命令会随版本、插件、权限变化，以当前App显示为准
-
避免常见命令陷阱：不把CLI命令当App主线，不把版本相关命令写成确定功能
🗺️ 学习路径导航（先看这里！）
⠀
💡 根据你的情况选择学习路径：不用全看！
⠀
路径A：快速上手（⏱️ 15分钟）
⠀
适合人群：想快速知道App里有哪些命令可以用
⠀
只看这些章节：
⠀
✅ 第2部分：先学会在App里发现命令（3分钟）
✅ 第3部分：App用户优先掌握的稳定命令（5分钟）
✅ 第4部分：/plan 先规划（7分钟）
路径B：完整学习（⏱️ 2-3小时）
⠀
适合人群：想系统掌握所有Commands用法
⠀
学习顺序：从头到尾所有章节
路径C：问题排查（⏱️ 5分钟）
⠀
适合人群：某个命令用不了或效果不对
⠀
直接跳到：
⠀
🔧 最后的常见问题FAQ部分
1. Commands 在 App 里解决什么问题
⠀
Commands 不是“高级玩具”，而是 App 的快速入口：
⠀
你想做什么
直接说也可以
Command 更适合
查看当前状态
“现在是什么模型和权限？”
/status
压缩上下文
“帮我压缩上下文”
/compact
进入计划模式
“先给计划别执行”
/plan
长目标持续推进
“一直做直到验证通过”
先输入 / 确认是否有 /goal 或同类长目标入口
审查改动
“review 当前 diff”
/review
管理外部工具
“看看 MCP”
/mcp
管理插件
“打开插件列表”
/plugins
⠀
学习方式：在 App 输入框输入 /，看当前版本展示什么。不要背死命令表，也不要把别人机器上出现的命令直接当成你这台机器一定有。
⠀
2. 先学会在 App 里发现命令
⠀
每次换版本、换账号、换项目或安装插件后，先做这四步：
⠀
-
打开 Codex App 的任意项目线程。
-
在输入框输入 /。
-
看弹出的命令列表、命令说明和是否有实验标记。
-
如果不确定某个命令能做什么，先输入 /help 或用自然语言问“解释当前可用 slash commands，不要执行任何改动”。
⠀
判断一个命令能不能写进教程，按这个顺序：
⠀
来源
教程写法
官方 App Commands 明确列出
可以作为稳定入口写
当前 App 弹窗显示但官方页未列出
写成“当前版本可能出现，以你的 App 为准”
只在 CLI 出现
放到 CX-12，不能写成 App 主线
只听别人说过
不写成确定命令
⠀
3. App 用户优先掌握的稳定命令
⠀
命令
App 主线用途
使用建议
/feedback
发送产品反馈
反馈 App 或命令问题
/status
查看模型、工作区、审批、上下文状态
任务前后都可用
/plan
切换计划模式
大任务先规划，不急着改
/review
审查当前改动
合并前使用
/mcp
查看 MCP 工具
接外部工具后检查
/help 或 / 列表
查看当前可用命令
以当前 App 显示为准
⠀
官方 App Commands 页面当前明确列出的命令很少，所以本篇不再把 CLI 的完整 slash command 表硬搬成 App 表。
⠀
3.1 三个 App 命令工作流配方
⠀
配方一：大任务先计划
⠀
/plan
目标：把登录逻辑从旧 auth helper 迁到新 auth client。
范围：先只读 src/auth、tests/auth 和相关 README。
约束：先不要修改文件，不要安装依赖。
交付：列出方案、风险、要改的文件和验证命令。
⠀
通过标准：Codex 只输出计划，不直接写文件；计划里能说明为什么读这些文件。
⠀
配方二：改完立刻审查
⠀
/review 重点检查：是否改了范围外文件、是否缺少测试、是否引入权限或网络行为变化。
⠀
通过标准：Review 结论能对应当前 diff，不是泛泛而谈。
⠀
配方三：命令不确定时先问状态
⠀
/status
⠀
然后再问：
⠀
解释当前线程的模型、工作区、权限/审批状态和可用工具。不要修改文件。
⠀
通过标准：你能判断当前任务适合只读、可写、worktree 还是 Cloud。
⠀
4. /plan：先规划，不急着写
⠀
适合：
⠀
-
多文件改动。
-
架构调整。
-
不确定影响面的 bug。
-
需要先比较方案。
⠀
示例：
⠀
/plan
修复登录页移动端布局问题。先读相关文件，列出可能方案、风险和验证命令，不要改文件。
⠀
好的计划应该包括：
⠀
-
要读哪些文件。
-
要改哪些文件。
-
可能方案和取舍。
-
验证命令。
-
不做什么。
-
什么时候退出计划模式进入执行。
⠀
如果你的 App 里仍显示旧口径 /plan-mode 而不是 /plan，按当前 App 弹窗为准；但教程中不要把两者写成永远等价。
⠀
5. /goal、/loop：长目标或循环入口
⠀
Codex CLI v0.133.0 更新：Goals 默认启用，并有专用存储追踪 active turns 之间的进度。教程把 /goal 作为可用长目标入口讲解，但仍建议先输入 / 查看你当前 App / CLI 实际暴露的命令。
⠀
Codex CLI v0.134.0 / v0.135.0 更新：命令排查时新增两个稳定入口：先用本地会话历史搜索找旧线程，再用 codex doctor 生成环境、Git、终端、app-server 和 thread inventory 诊断。远程 TUI 的 /status 会显示 remote connection 与 server version；/permissions 可识别 named permission profiles。
⠀
当前官方文档已把 /goal 作为长目标持续推进入口讲解；/loop 或同类循环入口仍以当前 App / CLI 输入 / 后看到的列表为准。它们适合“比一次普通提示更长、但有明确结束条件”的任务。
⠀
写法要保守：先确认你的 App 里真的有这个命令，再使用。不要在教程里保证所有用户都有。
⠀
适合：
⠀
-
长迁移。
-
长重构。
-
部署重试直到成功。
-
原型持续打磨直到测试通过。
⠀
不要这样写：
⠀
/goal 优化项目
⠀
应该这样写：
⠀
/goal Complete the migration from legacy auth helpers to the new auth client without stopping until npm test -- auth passes and no files outside src/auth and tests/auth are changed.
⠀
如果是 /loop，也要写清楚循环条件和停止条件：
⠀
/loop 每 10 分钟检查一次当前分支测试状态。只汇总失败原因，不修改文件；连续两次通过或发现需要人工决策时停止。
⠀
长目标/循环类入口必须包含：
⠀
-
任务范围。
-
允许读写的文件。
-
验证命令。
-
失败时怎么停。
-
最长运行边界。
-
是否允许提交、推送或调用外部服务。
⠀
如果当前环境看不到 /goal 或 /loop，不要硬找配置；先用普通自然语言让 Codex 分阶段执行，或查看当前 App / CLI 的功能成熟度和命令列表。
⠀
6. /review：把审查放进 App 工作流
⠀
/review 用来审查当前工作区改动。App 用户可以把它放在每次合并前：
⠀
/review
⠀
你也可以自然语言补充审查重点：
⠀
/review 重点看：是否改了范围外文件、是否缺测试、是否引入安全问题。
⠀
注意：
⠀
-
/review 不替代人工确认。
-
高风险改动仍要读 diff。
-
安全专项可以另用安全审查提示或专门 skill。
⠀
6.1 /review 不是一句“帮我看看”
⠀
好的 /review 要带检查维度：
⠀
维度
适合提示
范围
是否只改了任务指定文件
正确性
是否有边界条件、空值、异步竞态
安全
是否触碰 secret、权限、网络、外部服务
测试
是否覆盖新增行为，是否只跑了无关测试
可维护
是否引入重复逻辑、过度抽象或隐式依赖
⠀
示例：
⠀
/review 重点检查 auth migration 的边界条件、token 处理、测试覆盖，以及是否误改了非 auth 模块。
⠀
7. 权限命令与安全边界
⠀
权限入口的名称可能随 App 版本变化。你应该通过 / 列表或 Settings 找到当前会话的权限设置，用来理解或调整 Codex 能自动做什么。
⠀
学习阶段建议：
⠀
-
不要开无限制自动执行。
-
让 Codex 在写文件和运行危险命令前解释。
-
对陌生项目使用更保守权限。
⠀
当任务涉及删除、移动、大量写入、联网或外部服务时，先看权限。若当前 App 没有 /permissions，就去 Settings 或当前线程权限提示里看，不要假设命令一定存在。
⠀
8. /mcp、Apps、Plugins
⠀
这三个命令常被混淆：
⠀
命令
管什么
例子
/mcp
外部工具 server 暴露的工具
浏览器、数据库、内部 API
Apps / Connectors 入口
连接器 / 外部服务上下文
GitHub、Drive、Gmail、Slack
Plugins 入口
能力包
携带 skills、MCP、apps、配置
⠀
使用顺序：
⠀
-
先确认要解决的问题。
-
看 App 是否已有连接器或插件。
-
用 /mcp、Apps 入口或 Plugins 入口确认工具是否可见。
-
再让 Codex 使用它。
⠀
9. CLI slash commands：只作为补充
⠀
在终端里运行 codex 也有 slash commands。CLI 表只能帮助你理解概念，不能反推 App 一定支持同名命令。终端里输入 /help 查看当前 CLI 支持项。
⠀
命令
用途
类型
例子
状态 / 配置
/status、/model、/permissions
工作流
/review、计划模式、目标模式
工具
/mcp、Apps、Plugins
会话管理
/compact、/resume、/new 等
⠀
如果你需要完整 CLI 命令表，去 CX-12 或直接运行 codex 后输入 /help。本篇只保留 App 主线。
⠀
10. Commands、Skills、Automations 的边界
⠀
类型
适合什么
例子
Command
当前会话里的快速动作
/review、/plan、/mcp
Skill
可复用流程或领域规范
代码审查 SOP、发布检查
Automation
定时或后台重复任务
每天检查测试、每周依赖摘要
⠀
不要把所有东西都做成 command。长期流程优先沉淀为 Skill；周期任务用 Automation。
⠀
常见问题
⠀
Q1：App 和 CLI 的命令完全一样吗？
⠀
不保证。以当前 App 的 / 列表、命令说明和官方 App Commands 文档为准。CLI 表只能辅助理解。
⠀
Q2：/goal 或 /loop 会不会无限跑？
⠀
有风险。所以必须写清楚停止条件、范围和验证方式。
⠀
Q3：我应该背完整命令表吗？
⠀
不用。掌握“输入 / 看当前命令”、/status、/plan、/review、/mcp，再理解 Apps / Plugins / 权限入口，就足够开始。/goal、/loop 只在你的 App 确认可用时再学。
📝 总结与检查清单
⠀
完成本课后，请确认以下所有项：
⠀
⠀
如果以上全部勾选，恭喜你掌握Codex Commands！
附录
⠀
A. 命令速查
⠀
命令
用途
稳定性
/ 或 /help
查看当前可用命令
稳定
/status
查看模型、工作区、审批状态
稳定
/plan
切换计划模式（先规划不执行）
稳定
/review
审查当前改动
稳定
/mcp
查看/管理MCP工具
稳定
/compact
压缩上下文
稳定
/feedback
发送产品反馈
稳定
/permissions
管理权限设置
稳定
⠀
B. 推荐学习资源
⠀
-
Codex App Commands 官方文档：https://developers.openai.com/codex/app/commands
-
本系列上一篇：CX-02 桌面工作流
-
本系列下一篇：CX-04 项目指令与权限
课程制作：老金
最后更新：2026年5月30日
许可：本课程采用CC BY-NC-SA 4.0许可
下一步
⠀
下一篇：CX-04 项目指令、配置、权限与沙盒。