手把手带你做一个 Claude Code plugin 插件（新手必看 ）

用过 claude code 的人应该都知道，claude code 除了是一个非常强大的 Agent 之外，它还有好几个组件来扩展自身的能力，比如

• Skills（技能）
• subagents(子代理)
• Hooks（钩子）
• MCP 服务器
• Commands（命令）

这些扩展能力单个拎出来都很强大，而 Claude Code Plugin 又可以把上面的东西组合起来使用，更加全方位的去扩展 Claude Code 的功能。

1、开发插件实操演示

1.1 创建插件目录

每个插件都有一个自己独立的目录，在这个目录里面可以去放插件配置文件、相应的技能、代理或钩子

mkdir hepingfly-plugin

1.2 创建插件配置文件

配置文件要放在 .claude-plugin 这个文件夹下面，所以我们先来创建这个文件夹（要在刚才的插件目录里面去创建）

可以使用下面的命令，也可以自己手动新建文件夹。

mkdir hepingfly-plugin/.claude-plugin

新建 plugin.json 配置文件， hepingfly-plugin/.claude-plugin/plugin.json

这个配置文件用于定义插件的基本信息，包括名称、描述和版本号。

claude code 会利用这些元数据，在插件管理器中展示您的插件。

{
"name": "hepingfly-plugin",
"description": "会打印 hello hepingfly",
"version": "1.0.0",
"author": {
"name": "hepingfly"
}
}

1.3 开发插件功能

上面几步我们把插件基本的配置做好了，下面我们就要开发这个插件具体的功能了。你可以使用 skill、subagent、command、hooks 都可以。

我们以 command 能力来演示：

在你的插件文件夹中创建 commands 目录：

mkdir hepingfly-plugin/commands

然后我们创建一个 hello.md ，功能非常简单，我们让它打印一句「hepingfly 你好，2026 一路发发发」

hepingfly-plugin/commands/hello.md：

---
description: 打印 hello hepingfly
---
说，hepingfly 你好，2026 一路发发发

测试插件是否能正常执行？

使用下面这条命令去指定 Claude Code 加载插件的位置。

Claude Code 的插件系统需要知道去哪里加载插件。

默认情况下，Claude Code 只会在特定的默认目录中查找插件。

而我们的插件放在项目目录 hepingfly-plugin 中，Claude Code 启动时并不知道这个位置，所以需要显示指定一下

claude --plugin-dir ./hepingfly-plugin

Claude Code 启动后，就能够加载出来我们的插件了。敲个斜杠就能联想出我们插件的名字。

执行结果：

跟我们预期的一致，说明我们这个插件就开发成功了。

到这里，就完成了第一个入门 Claude 插件，后面你可以继续接 skills / subagent / MCP。

等下一篇再继续分享。