夜雨聆风
Claude Code 插件系统实战指南
Claude Code 简洁的对话框之下，隐藏着一个庞大而精密的”扩展宇宙”——插件系统。它能让你的 Claude 从一个”听话的工具”进化成一个”懂你的伙伴”。大多数人从未踏足这个领域，就像守着一座金山，却只在山脚捡了几块碎石。
这篇文章，就是你唤醒那沉睡 90% 潜能的钥匙。我们将彻底告别”隔靴搔痒”式的介绍，带你从一个插件的”消费者”，一步步进阶为”创造者”。
今天我们要介绍 Claude Code 鲜为人知的功能——Plugin。
1. 你的 Claude Code 不是工具，是平台
1.1 Plugin 是什么
要理解插件，我们必须先修正一个观念：要把 Claude Code 看作一个封闭的软件，而要把它看作一个像 iOS 或 Android 一样的开放平台。
简单来说，Plugin 就是一套把”Skills”、”MCP”、”Sub-agent” 等功能组件，打包好供你下载的”应用”
插件（Plugin），就是这个平台的”APP”。市场（Marketplace），就是下载这些 APP 的”应用商店”。
手机出厂时自带电话、短信功能，但真正让它无所不能的是微信、支付宝、高德地图等无数的 APP。同理，Claude Code 自带的编程能力是基础，而插件则可以为它安装上无穷无尽的、针对特定场景的”超能力”。
🖥️ 最重要的是，在团队合作中，Plugin 的转移与交接会比 Skills 来得更加方便和彻底！
一个插件可以包含五种核心组件，它们共同构成了这个强大的生态系统：
- 命令（Commands）：你主动下达的指令，如 /deploy
- 技能（Skills）：它根据上下文自动触发的能力
- 钩子（Hooks）：在特定事件发生时自动执行的脚本，实现”无人值守”的自动化
- 子代理（Sub-Agent）：专精于某一领域的”子人格”，让 Claude 能够分身处理复杂任务
- MCP 服务器：外部工具和服务集成
现在，你可能还有点混乱。别急，这趟旅程的下一站，我们将亲手为我们的”平台”安装第一个”APP”。
2. 三步为你的 Claude 安装”超能力”
理论是苍白的，实践是最好的老师。你会惊讶地发现，给 Claude 安装插件甚至比给手机装 APP 还简单。我们以官方插件市场为例，完整体验一次这个过程。
第一步：链接”应用商店”
如果你的 Plugin 里面已经存在官方市场，则可以省略这一步骤。
首先，我们需要告诉 Claude 去哪里寻找这些”APP”。在 Claude Code 的对话框中，输入并执行以下命令：
/plugin marketplace add anthropics/claude-code这条命令的作用是添加由 Claude 官方（Anthropic）维护的插件市场。执行后，你的 Claude 就成功连接到了一个充满官方认证”APP”的宝库。
同理，你也可以安装其他第三方的应用商城。
第二步：挑选并安装你的第一个插件
对于新手，最友好的方式是使用交互式菜单。只需输入 /plugin：
Claude 会为你呈现一个菜单。选择”Discover”，你就可以像逛应用商店一样，查看市场里所有可用的插件及其详细介绍。找到一个你感兴趣的（比如 Figma 自动化写代码），选择安装即可。
当然，如果你是效率至上的”老手”，可以直接通过命令安装。格式是 插件名@市场名。例如：
/plugin install your-plugin@your-org第三步：验证 Plugin 是否生效
输入 /Plugin 后，点击 Tab 找到 Install 界面。
如果在这里没有显示错误，那就可以尝试在输入框直接输入 /，看看能否找到相应的命令。
这里以 Notion 为例，如果能够看到有相应的 Notion 指令出现，那就代表已经安装成功啦！（取决于 Plugin 本身是否包含 Command）
如果涉及到需要链接 MCP 的 Plugin，需要先进行验证，确保 MCP 链接上了才能运行。
3. 从文档结构，深入了解 Plugin
想要清晰地了解 Plugin 与其他功能之间的区别，最直观的方式，便是查看它们的文档结构，以此来了解它们之间的差异。
3.1 Plugin 文档结构
my-plugin/ ├── .claude-plugin/ # 必需：元数据目录 │ └── plugin.json # 必需：清单文件 ├── commands/ # 可选：斜杠命令 │ └── hello.md ├── agents/ # 可选：子 Agent │ └── code-reviewer.md ├── skills/ # 可选：Skills │ └── pdf-processor/ │ └── SKILL.md ├── hooks/ # 可选：事件钩子 │ └── hooks.json ├── .mcp.json # 可选：MCP 服务器 ├── .lsp.json # 可选：LSP 服务器 ├── scripts/ # 可选：脚本 └── README.md从文档结构上来看，就很直观地能够认识到 Plugin 与 Skills 之间的区别了，Skills 是 Plugin 的下位概念，而 Plugin 则是 Skills、MCP、Sub-Agent 的上位概念。
3.2 以 Notion Plugin 为例
可以看到，Notion 的 Plugin 主要包含了三个功能组件：
- 命令（Commands）：包含了六个不同的核心功能命令
- 技能（Skills）：包含了四个主要的 Skills
MCP：一个 MCP 的 JSON 格式文件
这么看就很好理解了！Notion 的 Plugin，就是一个使用了 Skills、Command 和 MCP 功能的 APP！
这下各位应该能够理解，Plugin 和 Skills 之间的具体区别是什么，以及为什么它能够更有效地在团队内部流转了！
那事不宜迟，我们马上开始动手做我们的第一个 Plugin。
4. 从 0 到 1，打造你的第一个插件
“如果有个 APP 能帮我做 XXX 就好了。”
当这个念头出现时，就是你从用户蜕变为创造者的最佳时机。让我们创建一个最简单的”问候插件”，它只包含一个 /summary 命令，但足以让你跑通完整的开发流程。
这次我们的最小可执行架构如下，大家可以先有一个概念：
🔥 如果准备好了，那我们就开始吧！下面教学分为两步：
- 邪修：让 Claude Code 帮你生成，适合不想了解具体细节的读者
- 详细步骤：逐步教你创建，适合想要了解具体细节的读者
1️⃣ 方式一：邪修👹
这一步很简单，只需要让 Claude Code 帮你创建即可，模板如下：
帮我创建一个完整的 Claude Code 测试插件环境：1. 插件信息： - 名称：my-first-plugin - 功能：添加一个 /summary 命令，可以帮助用户总结文本 - 版本：1.0.0 - 作者：[你的名字]2. 市场信息： - 市场名称：test-marketplace - 用于本地测试3. 创建完成后： - 告诉我如何添加市场和安装插件的命令 - 说明如何测试 /summary 命令请先在互联网搜索「Claude Code plugin structure」和「Claude Code marketplace.json」，了解最新的插件目录规范。恭喜你🎉 你可以直接跳去第四步了（这就是 Agent 的威力）
2️⃣ 方式二：按部就班
第一步：创建”蓝图”（目录与清单）
首先，我们需要为插件搭建骨架。打开你的终端，依次执行：
# 1. 创建一个市场目录，用于存放你的所有插件mkdir my-marketplacecd my-marketplace# 2. 在市场里，创建你的第一个插件目录mkdir hello-plugincd hello-plugin# 3. 创建插件的"身份证"——plugin.jsonmkdir .claude-plugin然后创建 .claude-plugin/plugin.json 文件，内容如下：
{"name":"summary-plugin","description":"A plugin that adds /summary command to summarize user input text","version":"1.0.0","author":{"name":"Roy"}}核心知识：plugin.json 是每个插件的”身份证”，它告诉 Claude 这个插件叫什么、版本多少、作者是谁。name 字段必须使用 kebab-case（小写字母加连字符）格式。
第二步：添加”功能”（创建命令文件）
接下来，我们为插件添加 /summary 命令。
# 4. 创建存放命令的目录mkdir commands然后创建 commands/hello.md 文件，内容如下：
---description: Greet the user with a personalized message---# Hello CommandGreet the user warmly and ask how you can help them today.核心知识：commands 目录是存放所有自定义命令的地方。文件名决定了命令名（hello.md 对应 /hello）。文件内容是 Markdown 格式，
---包围的部分是元数据，正文则是给 Claude 的指令，告诉它执行这个命令时该做什么。
第三步：上架”应用商城”（创建市场清单）
现在，插件本身已经做好了，我们需要把它”上架”到我们自己的本地市场里。
在这个文件夹里面，创建一个”.claude-plugin”文件夹。然后再在文件夹内创建一个 “marketplace.json” 文件，内容如下：
{"name":"test-marketplace","owner":{"name":"Roy"},"metadata":{"description":"A local test marketplace for Claude Code plugins","version":"1.0.0"},"plugins":[{"name":"summary-plugin","source":"./plugins/summary-plugin","description":"A plugin that adds /summary command to summarize user input text","version":"1.0.0","author":{"name":"Roy"},"keywords":["summary","text","utility"]}]}核心知识：marketplace.json 文件定义了这个市场里有哪些插件。source 字段指明了插件的存放路径。
第四步：安装并测试你的”作品”
万事俱备！现在，启动 Claude Code，输入以下指令添加 Marketplace：
/plugin marketplace add ./my-marketplace重启 Claude Code 后，激动人心的时刻来了！在对话框输入 /plugin，然后选择 Marketplace，你就能找到自己的 Marketplace，并且里面有属于你自己创造的插件！
恭喜你！你已经完成了从 0 到 1 的创造。这个简单的插件只是一个开始，你已经掌握了打造复杂工具的钥匙。
5. 团队协作——让所有人用上同一套工具
当你的插件足够成熟，你可能会想把它分享给团队。插件系统为此提供了完善的机制。
方式一：托管到 GitHub（推荐）
将你的市场目录推送到 GitHub 仓库，团队成员只需一条命令即可添加：
/plugin marketplace add your-org/your-marketplace方式二：项目级配置
更优雅的方式是将插件配置写入项目的 .claude/settings.json 文件：
{"extraKnownMarketplaces":{"team-tools":{"source":{"source":"github","repo":"your-org/claude-plugins"}}},"enabledPlugins":{"code-formatter@team-tools":true,"deploy-tools@team-tools":true}}这样，每个团队成员克隆项目后，Claude Code 会自动识别并安装相同的插件，确保所有人使用统一的工具集。
结论：你的下一站——从”好用”到”共联”
今天，我们一起重新认识了 Claude Code，将它从一个”工具”重新定义为一个”平台”。
插件系统，正是 Claude Code 从”好用”到”无敌”的”点睛之笔”。它让你能够将自己的经验、团队的规范、常用的流程，全部封装成可复用、可分享的模块，为你打造一个独一无二、心意相通的伙伴。
你的 Claude，从此将与众不同。
