CX-03 Commands 完整指南
CX-03 Commands 完整指南
CX 03 Commands 完整指南 CX 03 Commands 完整指南 ⠀ • 任务范围。 • 允许读写的文件。 • 验证命令。 • 失败时怎么停。 • 最长运行边界。 • 是否允许提交、推送或调用外部服务。 ⠀ 如果当前环境看不到 /goal 或 /loop,不要硬找配置;先用普通自然语言让 Codex 分阶段执行,或查看当前 App / CLI 的功能成熟度和命令列表。 ⠀ 6. /review:把审查放进 App 工作流 ⠀ /review 用来审查当前工作区改动。App 用户可以把它放在每次合并前: ⠀ Code block Plain Text /review ⠀ 你也可以自然语言补充审查重点: ⠀ Code block Plain Text /review 重点看:是否改了范围外文件、是否缺测试、是否引入安全问题。 ⠀ 注意: ⠀ • /review 不替代人工确认。 • 高风险改动仍要读 diff。 • 安全专项可以另用安全审查提示或专门 skill。 ⠀ 6.1 /review 不是一句“帮我看看” ⠀ 好的 /review 要带检查维度: ⠀ ⠀ 示例: ⠀ Code block Plain Text /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、配置 ⠀ 使用顺序: ⠀ 1. 先确认要解决的问题。 2. 看 App 是否已有连接器或插件。 3. 用 /mcp、Apps 入口或 Plugins 入口确认工具是否可见。 4. 再让 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 确认可用时再学。 📝 总结与检查清单 ⠀ 完成本课后,请确认以下所有项: ⠀ 知道在App输入框输入/可以查看当前可用命令 掌握核心稳定命令:/status、/plan、/review、/mcp、/feedback 理解/plan适合多文件改动、架构调整等场景 知道命令会随版本、插件、权限变化,以当前App显示为准 不把CLI命令表硬搬成App命令表 知道如何用/compact压缩上下文 ⠀ 如果以上全部勾选,恭喜你掌握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日 ⠀ • 任务范围。 • 允许读写的文件。 • 验证命令。 • 失败时怎么停。 • 最长运行边界。 • 是否允许提交、推送或调用外部服务。 ⠀ 如果当前环境看不到 /goal 或 /loop,不要硬找配置;先用普通自然语言让 Codex 分阶段执行,或查看当前 App / CLI 的功能成熟度和命令列表。 ⠀ 6. /review:把审查放进 App 工作流 ⠀ /review 用来审查当前工作区改动。App 用户可以把它放在每次合并前: ⠀ ⠀ 你也可以自然语言补充审查重点: ⠀ ⠀ 注意: ⠀ • /review 不替代人工确认。 • 高风险改动仍要读 diff。 • 安全专项可以另用安全审查提示或专门 skill。 ⠀ 6.1 /review 不是一句“帮我看看” ⠀ 好的 /review 要带检查维度: ⠀ ⠀ 示例: ⠀ ⠀ 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、配置 命令 命令 管什么 管什么 例子 例子 /mcp /mcp 外部工具 server 暴露的工具 外部工具 server 暴露的工具 浏览器、数据库、内部 API 浏览器、数据库、内部 API Apps / Connectors 入口 Apps / Connectors 入口 连接器 / 外部服务上下文 连接器 / 外部服务上下文 GitHub、Drive、Gmail、Slack GitHub、Drive、Gmail、Slack Plugins 入口 Plugins 入口 能力包 能力包 携带 skills、MCP、apps、配置 携带 skills、MCP、apps、配置 ⠀ 使用顺序: ⠀ 1. 先确认要解决的问题。 2. 看 App 是否已有连接器或插件。 3. 用 /mcp、Apps 入口或 Plugins 入口确认工具是否可见。 4. 再让 Codex 使用它。 ⠀ 9. CLI slash commands:只作为补充 ⠀ 在终端里运行 codex 也有 slash commands。CLI 表只能帮助你理解概念,不能反推 App 一定支持同名命令。终端里输入 /help 查看当前 CLI 支持项。 ⠀ 命令 用途 类型 例子 状态 / 配置 /status、/model、/permissions 工作流 /review、计划模式、目标模式 工具 /mcp、Apps、Plugins 会话管理 /compact、/resume、/new 等 命令 命令 用途 用途 类型 类型 例子 例子 状态 / 配置 状态 / 配置 /status、/model、/permissions /status、/model、/permissions 工作流 工作流 /review、计划模式、目标模式 /review、计划模式、目标模式 工具 工具 /mcp、Apps、Plugins /mcp、Apps、Plugins 会话管理 会话管理 /compact、/resume、/new 等 /compact、/resume、/new 等 ⠀ 如果你需要完整 CLI 命令表,去 CX 12 或直接运行 codex 后输入 /help。本篇只保留 App 主线。 ⠀ 10. Commands、Skills、Automations 的边界 ⠀ 类型 适合什么 例子 Command 当前会话里的快速动作 /review、/plan、/mcp Skill 可复用流程或领域规范 代码审查 SOP、发布检查 Automation 定时或后台重复任务 每天检查测试、每周依赖摘要 类型 类型 适合什么 适合什么 例子 例子 Command Command 当前会话里的快速动作 当前会话里的快速动作 /review、/plan、/mcp /review、/plan、/mcp Skill Skill 可复用流程或领域规范 可复用流程或领域规范 代码审查 SOP、发布检查 代码审查 SOP、发布检查 Automation Automation 定时或后台重复任务 定时或后台重复任务 每天检查测试、每周依赖摘要 每天检查测试、每周依赖摘要 ⠀ 不要把所有东西都做成 command。长期流程优先沉淀为 Skill;周期任务用 Automation。 ⠀ 常见问题 ⠀ Q1:App 和 CLI 的命令完全一样吗? ⠀ 不保证。以当前 App 的 / 列表、命令说明和官方 App Commands 文档为准。CLI 表只能辅助理解。 ⠀ Q2:/goal 或 /loop 会不会无限跑? ⠀ 有风险。所以必须写清楚停止条件、范围和验证方式。 ⠀ Q3:我应该背完整命令表吗? ⠀ 不用。掌握“输入 / 看当前命令”、/status、/plan、/review、/mcp,再理解 Apps / Plugins / 权限入口,就足够开始。/goal、/loop 只在你的 App 确认可用时再学。 📝 总结与检查清单 ⠀ 完成本课后,请确认以下所有项: ⠀ 知道在App输入框输入/可以查看当前可用命令 掌握核心稳定命令:/status、/plan、/review、/mcp、/feedback 理解/plan适合多文件改动、架构调整等场景 知道命令会随版本、插件、权限变化,以当前App显示为准 不把CLI命令表硬搬成App命令表 知道如何用/compact压缩上下文 ⠀ 如果以上全部勾选,恭喜你掌握Codex Commands! 附录 ⠀ A. 命令速查 ⠀ 命令 用途 稳定性 / 或 /help 查看当前可用命令 稳定 /status 查看模型、工作区、审批状态 稳定 /plan 切换计划模式(先规划不执行) 稳定 /review 审查当前改动 稳定 /mcp 查看/管理MCP工具 稳定 /compact 压缩上下文 稳定 /feedback 发送产品反馈 稳定 /permissions 管理权限设置 稳定 命令 命令 用途 用途 稳定性 稳定性 / 或 /help / 或 /help 查看当前可用命令 查看当前可用命令 稳定 稳定 /status /status 查看模型、工作区、审批状态 查看模型、工作区、审批状态 稳定 稳定 /plan /plan 切换计划模式(先规划不执行) 切换计划模式(先规划不执行) 稳定 稳定 /review /review 审查当前改动 审查当前改动 稳定 稳定 /mcp /mcp 查看/管理MCP工具 查看/管理MCP工具 稳定 稳定 /compact /compact 压缩上下文 压缩上下文 稳定 稳定 /feedback /feedback 发送产品反馈 发送产品反馈 稳定 稳定 /permissions /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 项目指令、配置、权限与沙盒。 本篇以 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 桌面工作流 📚 本课学习目标 ⠀ 完成本课学习后,你将能够: ⠀ 1. 理解Commands的本质:掌握slash命令是App的快速工作流入口,不是高级玩具 2. 学会发现命令:在App中输入/查看当前可用命令,不依赖死记硬背 3. 掌握核心稳定命令:熟练使用/status、/plan、/review、/mcp、/feedback 4. 理解计划模式:知道什么时候该先规划再执行,用/plan进入 5. 区分命令层级:分清App命令、CLI命令、版本相关命令、Skills各自的位置 6. 学会压缩上下文:在长线程中使用/compact保持对话效率 7. 理解命令的变化性:知道命令会随版本、插件、权限变化,以当前App显示为准 8. 避免常见命令陷阱:不把CLI命令当App主线,不把版本相关命令写成确定功能 🗺️ 学习路径导航(先看这里!) ⠀ 💡 根据你的情况选择学习路径:不用全看! 💡 根据你的情况选择学习路径:不用全看! ⠀ 路径A:快速上手(⏱️ 15分钟) ⠀ 适合人群:想快速知道App里有哪些命令可以用 ⠀ 只看这些章节: ⠀ 路径B:完整学习(⏱️ 2 3小时) ⠀ 适合人群:想系统掌握所有Commands用法 ⠀ 学习顺序:从头到尾所有章节 路径C:问题排查(⏱️ 5分钟) ⠀ 适合人群:某个命令用不了或效果不对 ⠀ 直接跳到: ⠀ 1. Commands 在 App 里解决什么问题 ⠀ Commands 不是“高级玩具”,而是 App 的快速入口: ⠀ 你想做什么 直接说也可以 Command 更适合 查看当前状态 “现在是什么模型和权限?” /status 压缩上下文 “帮我压缩上下文” /compact 进入计划模式 “先给计划别执行” /plan 长目标持续推进 “一直做直到验证通过” 先输入 / 确认是否有 /goal 或同类长目标入口 审查改动 “review 当前 diff” /review 管理外部工具 “看看 MCP” /mcp 管理插件 “打开插件列表” /plugins 你想做什么 你想做什么 直接说也可以 直接说也可以 Command 更适合 Command 更适合 查看当前状态 查看当前状态 “现在是什么模型和权限?” “现在是什么模型和权限?” /status /status 压缩上下文 压缩上下文 “帮我压缩上下文” “帮我压缩上下文” /compact /compact 进入计划模式 进入计划模式 “先给计划别执行” “先给计划别执行” /plan /plan 长目标持续推进 长目标持续推进 “一直做直到验证通过” “一直做直到验证通过” 先输入 / 确认是否有 /goal 或同类长目标入口 先输入 / 确认是否有 /goal 或同类长目标入口 审查改动 审查改动 “review 当前 diff” “review 当前 diff” /review /review 管理外部工具 管理外部工具 “看看 MCP” “看看 MCP” /mcp /mcp 管理插件 管理插件 “打开插件列表” “打开插件列表” /plugins /plugins ⠀ 学习方式:在 App 输入框输入 /,看当前版本展示什么。不要背死命令表,也不要把别人机器上出现的命令直接当成你这台机器一定有。 ⠀ 2. 先学会在 App 里发现命令 ⠀ 每次换版本、换账号、换项目或安装插件后,先做这四步: ⠀ 1. 打开 Codex App 的任意项目线程。 2. 在输入框输入 /。 3. 看弹出的命令列表、命令说明和是否有实验标记。 4. 如果不确定某个命令能做什么,先输入 /help 或用自然语言问“解释当前可用 slash commands,不要执行任何改动”。 ⠀ 判断一个命令能不能写进教程,按这个顺序: ⠀ 来源 教程写法 官方 App Commands 明确列出 可以作为稳定入口写 当前 App 弹窗显示但官方页未列出 写成“当前版本可能出现,以你的 App 为准” 只在 CLI 出现 放到 CX 12,不能写成 App 主线 只听别人说过 不写成确定命令 来源 来源 教程写法 教程写法 官方 App Commands 明确列出 官方 App Commands 明确列出 可以作为稳定入口写 可以作为稳定入口写 当前 App 弹窗显示但官方页未列出 当前 App 弹窗显示但官方页未列出 写成“当前版本可能出现,以你的 App 为准” 写成“当前版本可能出现,以你的 App 为准” 只在 CLI 出现 只在 CLI 出现 放到 CX 12,不能写成 App 主线 放到 CX 12,不能写成 App 主线 只听别人说过 只听别人说过 不写成确定命令 不写成确定命令 ⠀ 3. App 用户优先掌握的稳定命令 ⠀ 命令 App 主线用途 使用建议 /feedback 发送产品反馈 反馈 App 或命令问题 /status 查看模型、工作区、审批、上下文状态 任务前后都可用 /plan 切换计划模式 大任务先规划,不急着改 /review 审查当前改动 合并前使用 /mcp 查看 MCP 工具 接外部工具后检查 /help 或 / 列表 查看当前可用命令 以当前 App 显示为准 命令 命令 App 主线用途 App 主线用途 使用建议 使用建议 /feedback /feedback 发送产品反馈 发送产品反馈 反馈 App 或命令问题 反馈 App 或命令问题 /status /status 查看模型、工作区、审批、上下文状态 查看模型、工作区、审批、上下文状态 任务前后都可用 任务前后都可用 /plan /plan 切换计划模式 切换计划模式 大任务先规划,不急着改 大任务先规划,不急着改 /review /review 审查当前改动 审查当前改动 合并前使用 合并前使用 /mcp /mcp 查看 MCP 工具 查看 MCP 工具 接外部工具后检查 接外部工具后检查 /help 或 / 列表 /help 或 / 列表 查看当前可用命令 查看当前可用命令 以当前 App 显示为准 以当前 App 显示为准 ⠀ 官方 App Commands 页面当前明确列出的命令很少,所以本篇不再把 CLI 的完整 slash command 表硬搬成 App 表。 ⠀ 3.1 三个 App 命令工作流配方 ⠀ 配方一:大任务先计划 ⠀ ⠀ 通过标准:Codex 只输出计划,不直接写文件;计划里能说明为什么读这些文件。 ⠀ 配方二:改完立刻审查 ⠀ ⠀ 通过标准:Review 结论能对应当前 diff,不是泛泛而谈。 ⠀ 配方三:命令不确定时先问状态 ⠀ ⠀ 然后再问: ⠀ ⠀ 通过标准:你能判断当前任务适合只读、可写、worktree 还是 Cloud。 ⠀ 4. /plan:先规划,不急着写 ⠀ 适合: ⠀ • 多文件改动。 • 架构调整。 • 不确定影响面的 bug。 • 需要先比较方案。 ⠀ 示例: ⠀ ⠀ 好的计划应该包括: ⠀ • 要读哪些文件。 • 要改哪些文件。 • 可能方案和取舍。 • 验证命令。 • 不做什么。 • 什么时候退出计划模式进入执行。 ⠀ 如果你的 App 里仍显示旧口径 /plan mode 而不是 /plan,按当前 App 弹窗为准;但教程中不要把两者写成永远等价。 ⠀ 5. /goal、/loop:长目标或循环入口 ⠀ Codex CLI v0.133.0 更新:Goals 默认启用,并有专用存储追踪 active turns 之间的进度。教程把 /goal 作为可用长目标入口讲解,但仍建议先输入 / 查看你当前 App / CLI 实际暴露的命令。 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。 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 里真的有这个命令,再使用。不要在教程里保证所有用户都有。 ⠀ 适合: ⠀ • 长迁移。 • 长重构。 • 部署重试直到成功。 • 原型持续打磨直到测试通过。 ⠀ 不要这样写: ⠀ ⠀ 应该这样写: ⠀ ⠀ 如果是 /loop,也要写清楚循环条件和停止条件: ⠀ ⠀ 长目标/循环类入口必须包含: