Back to Articles
Jan 16, 20261 month ago

Claude Code Practical Guide: Unlocking the Plug-In System from 0 to 1 to Build Your Own "Super Platform" (Includes Complete Steps)

Y
Yuker@0xYuker

AI Summary

This article argues that most users are only utilizing 10% of Claude Code's potential by treating it as a simple tool. It positions the Plug-In system as the key to unlocking a transformative "super platform," evolving Claude from an obedient tool into an intuitive partner. The guide promises a hands-on journey from being a plugin consumer to a creator. The author's central argument is that Claude Code should be reconceptualized not as a closed software but as an open platform like iOS or Android. Within this framework, a Plugin is a packaged "app" that can contain five core components: Commands (user-initiated instructions), Skills (contextually triggered abilities), Hooks (automated scripts), Sub-Agents (specialized sub-personas), and MCP servers (external integrations). This structure makes Plugins superior to individual Skills for team collaboration and workflow encapsulation. Key Insights The article provides a complete three-step workflow for users: 1) Connecting to an official or third-party "app store" (marketplace), 2) Installing plugins via an interactive menu or direct command, and 3) Verifying installation by checking for new commands. It demystifies the plugin architecture by contrasting its document structure with simpler Skills, using the Notion plugin as a concrete example that bundles specific Commands, Skills, and an MCP configuration. A detailed, two-path tutorial guides readers in building their first plugin from scratch. The "detailed" path walks through creating the plugin directory, the essential `plugin.json` manifest, a command file, and a local marketplace listing for installation. For team scalability, the guide outlines methods to share plugins, primarily by hosting the marketplace on GitHub for centralized access or by embedding plugin configurations in a project's settings file for automatic synchronization among team members. The ultimate takeaway is that the Plug-In system enables the codification and sharing of personal expertise, team norms, and frequent workflows, transforming Claude Code from a merely useful tool into a uniquely powerful and interconnected platform.

在过去的文章中,我们已经初步接触了Skills,Sub-Agent,MCP,CLAUDE.md 和安全设置。大家应该已经使用上Claude Code来完成各式各样炫酷的功能了。如果我告诉你,你很可能只发挥了它10%的功力,一个"出厂默认设置"的功力呢?

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 自带的编程能力是基础,而插件则可以为它安装上无穷无尽的、针对特定场景的"超能力"。

🖥️最重要的是,在团队合作中,Plug-In的转移与交接会比Skills来得更加方便和彻底!

一个插件可以包含五种核心组件,它们共同构成了这个强大的生态系统:

命令(Commands):你主动下达的指令,如 /deploy

技能(Skills):它根据上下文自动出发的能力

钩子(Hooks):在特定事件发生时自动执行的脚本,实现“无人值守”的自动化。

子代理(Sub-Agent):专精于某一领域的“子人格”,让Claude 能够分身处理复杂人物。

MCP服务器:外部工具和服务集成

现在,你可能还有点混乱。别急,这趟旅程的下一站,我们将亲手为我们的"平台"安装第一个"APP"。

2. 三步为你的Claude安装“超能力”

理论是苍白的,实践是最好的老师。你会惊讶地发现,给 Claude 安装插件甚至比给手机装APP还简单。我们以官方插件市场为例,完整体验一次这个过程。

第一步:链接“应用商店”

如果你的Plug-in里面已经存在官方市场,则可以省略这一步骤。

首先,我们需要告诉 Claude 去哪里寻找这些"APP"。在 Claude Code 的对话框中,输入并执行以下命令:

这条命令的作用是添加由 Claude 官方(Anthropic)维护的插件市场。执行后,你的 Claude 就成功连接到了一个充满官方认证"APP"的宝库。

同理,你也可以安装其他第三方的应用商城。

第二步:挑选并安装你的第一个插件

对于新手,最友好的方式是使用交互式菜单。只需输入 /plugin:

Claude 会为你呈现一个菜单。选择"Discover",你就可以像逛应用商店一样,查看市场里所有可用的插件及其详细介绍。找到一个你感兴趣的(比如 Figma 自动化写代码),选择安装即可。

当然,如果你是效率至上的"老手",可以直接通过命令安装。格式是 插件名@市场名。例如:

第三步:验证 Plug-In 是否生效

输入 /Plugin 后,点击 Tab 找到 Install 界面。

如果在这里没有显示错误,那就可以尝试在输入框直接输入 / ,看看能否找到相应的命令。

这里以Notion为例,如果能够看到有相应的Notion指令出现,那就代表已经安装成功啦!(取决于Plug-In本身是否包含Command)

如果涉及到需要链接MCP的Plug-in,需要先进行验证,确保MCP链接上了才能运行。

3. 从文档结构,深入了解 Plug-In

想要清晰的了解 Plug-In 与其他功能之间的区别,最直观的方式,便是查看他们的文档结构,以此来了解他们之间的差异

3.1 Plug-In 文档结构

从文档结构上来看,就很直观的能够认识到 Plug-in 与 Skills 之间的区别了,Skills 是Plug-In的下位概念,而Plug-In则是Skills,MCP,Sub-Agent的上位概念。

3.2 以Notion Plug-In为例

可以看到,Notion的Plug-In主要包含了三个功能组件

命令(Commands):包含了六个不同的核心功能命令

技能(Skills):包含了四个主要的Skills

MCP:一个MCP的 Json 格式文件

这么看就很好理解了!Notion 的 Plug-In,就是一个使用了 Skills,Command 和 MCP 功能的APP!

这下各位应该能够理解,Plug-In 和 Skills 之间的具体区别是什么,以及为什么它能够更有效的在团队内部流转了!

那事不宜迟,我们马上开始动手做我们的第一个Plug-In。

4. 从0到1,打造你的第一个插件

"如果有个APP能帮我做 XXX 就好了。"

当这个念头出现时,就是你从用户蜕变为创造者的最佳时机。让我们创建一个最简单的"问候插件",它只包含一个 /summary 命令,但足以让你跑通完整的开发流程。

这次我们的最小可执行架构如下,大家可以先有一个概念:

🔥如果准备好了,那我们就开始吧!下面教学分为两步:

邪修:让Claude Code帮你生成,适合不想了解具体细节的读者

详细步骤:逐步教你创建,适合想要了解具体细节的读者。

1️⃣方式一:邪修👹

这一步很简单,只需要让 Claude Code 帮你创建即可,模板如下:

恭喜你🎉你可以直接跳去第四步了(这就Agent的威力)

2️⃣方式二:按部就班

第一步:创建“蓝图”(目录与清单)

首先,我们需要为插件搭建骨架。打开你的终端,依次执行:

然后创建 .claude-plugin/plugin.json 文件,内容如下:

核心知识:
plugin.json 是每个插件的"身份证",它告诉 Claude 这个插件叫什么、版本多少、作者是谁。name 字段必须使用 kebab-case(小写字母加连字符)格式。

第二步:添加"功能"(创建命令文件)

接下来,我们为插件添加 /summary 命令。

然后创建 commands/hello.md 文件,内容如下:

核心知识:
commands 目录是存放所有自定义命令的地方。文件名决定了命令名(hello.md 对应 /hello)。文件内容是 Markdown 格式,--- 包围的部分是元数据,正文则是给 Claude 的指令,告诉它执行这个命令时该做什么。

第三步:上架“应用商城”(创建市场清单)

现在,插件本身已经做好了,我们需要把它"上架"到我们自己的本地市场里。

在这个文件夹里面,创建一个“.claude-plugin”文件夹。
然后再文件夹内创建一个 “marketplace.json”文件,内容如下:

核心知识:
marketplace.json 文件定义了这个市场里有哪些插件。source 字段指明了插件的存放路径。

第四步:安装并测试你的"作品"

万事俱备!现在,启动 Claude Code,输入以下指令添加Marketplace:

重启Claude Code后,激动人心的时刻来了!在对话框输入 /plugin ,然后选择Marketplace,你就能找到自己的Marketplace,并且里面有属于你自己创造的插件!

恭喜你!你已经完成了从0到1的创造。这个简单的插件只是一个开始,你已经掌握了打造复杂工具的钥匙。

5. 团队协作——让所有人用上同一套工具

当你的插件足够成熟,你可能会想把它分享给团队。插件系统为此提供了完善的机制。

方式一:托管到 GitHub(推荐)

将你的市场目录推送到 GitHub 仓库,团队成员只需一条命令即可添加:

方式二:项目级配置

更优雅的方式是将插件配置写入项目的 .claude/settings.json 文件:

这样,每个团队成员克隆项目后,Claude Code 会自动识别并安装相同的插件,确保所有人使用统一的工具集。

结论:你的下一站——从“好用”到“共联”

今天,我们一起重新认识了 Claude Code,将它从一个"工具"重新定义为一个"平台"。

插件系统,正是 Claude Code 从"好用"到"无敌"的"点睛之笔"。它让你能够将自己的经验、团队的规范、常用的流程,全部封装成可复用、可分享的模块,为你打造一个独一无二、心意相通的伙伴。

你的 Claude,从此将与众不同。

免费AI交流群:@yukerx (TG)