24 · 插件指南：安装、组合与分发能力

插件如何组合命令、Agent、Skill、Hook 和 MCP，覆盖插件安装、启用、目录结构与团队分发的基本流程。

如果说 Skill 是「单项能力」，插件就是「能力包」——它把命令、子代理、Skill、Hook、MCP 打包在一起，一次装进来。

「组合」是插件的核心：一个插件里，可能同时包含自定义命令、几个子代理、几个 Skill、几个 Hook、几个 MCP 连接。装一个插件，等于装一整套。

「安装」和「启用」比零散配置省心：找到插件、装上、启用，里面的东西就都就位了。适合「我想要一整套某类能力」的场景。

「目录结构」决定了插件里的东西装到哪、怎么被 Claude 发现。理解这个，出问题才知道去哪找。

「团队分发」是插件的一个重要价值：你可以把一套配置打包成插件，分发给团队，保证大家用的是同一套规则和能力。

「权限」是装插件时最要留神的：插件自带的东西多，要求的权限也可能多。装之前看看它要碰什么、连什么，别为省事把权限全交出去。

「适用场景」：当你发现「零散配置太麻烦、想要现成的一整套」时，插件比逐个装划算。

但插件的便利也意味着「黑盒」风险：里面装了什么、会干什么，你得心里有数。原则还是那句老话——能力越大，越要看清楚再收。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

与其他篇的关系：这一篇是本组的基础。如果你跳过了前面几篇，建议先回去看，否则这里有些概念可能看着突兀。如果都看过了，那你可以直接进入更后面的实战环节，把这里学到的东西用上。

复盘清单：每做完一个任务，可以花一分钟复盘——目标说清楚了吗？范围限定了吗？结果验证了吗？审查过 diff 了吗？下次哪里能更好？这 5 步能让你的 Codex 使用从「能用」进化到「好用」。