用过 claude code 的人应该都知道,claude code 除了是一个非常强大的 Agent 之外,它还有好几个组件来扩展自身的能力,比如
- Skills(技能)
- subagents(子代理)
- Hooks(钩子)
- MCP 服务器
- Commands(命令)
这些扩展能力单个拎出来都很强大,而 Claude Code Plugin 又可以把上面的东西组合起来使用,更加全方位的去扩展 Claude Code 的功能。
1、开发插件实操演示
1.1 创建插件目录
每个插件都有一个自己独立的目录,在这个目录里面可以去放插件配置文件、相应的技能、代理或钩子
BASH
mkdir hepingfly-plugin
1.2 创建插件配置文件
配置文件要放在 .claude-plugin 这个文件夹下面,所以我们先来创建这个文件夹(要在刚才的插件目录里面去创建)
可以使用下面的命令,也可以自己手动新建文件夹。
BASH
mkdir hepingfly-plugin/.claude-plugin
新建 plugin.json 配置文件, hepingfly-plugin/.claude-plugin/plugin.json
这个配置文件用于定义插件的基本信息,包括名称、描述和版本号。
claude code 会利用这些元数据,在插件管理器中展示您的插件。
JSON
{
"name": "hepingfly-plugin",
"description": "会打印 hello hepingfly",
"version": "1.0.0",
"author": {
"name": "hepingfly"
}
}
| 字段 | 用途 |
|---|---|
| name | 唯一标识符和斜杠命令命名空间。斜杠命令以此为前缀(例如 /hepingfly-plugin:hello)。 |
| description | 在浏览或安装插件时在插件管理器中显示。 |
| version | 使用语义版本控制跟踪发布。 |
| author | 作者名字(可选)。有助于归属。 |
1.3 开发插件功能
上面几步我们把插件基本的配置做好了,下面我们就要开发这个插件具体的功能了。你可以使用 skill、subagent、command、hooks 都可以。
我们以 command 能力来演示:
在你的插件文件夹中创建 commands 目录:
BASH
mkdir hepingfly-plugin/commands
然后我们创建一个 hello.md ,功能非常简单,我们让它打印一句「hepingfly 你好,2026 一路发发发」
hepingfly-plugin/commands/hello.md:
PLAIN
---
description: 打印 hello hepingfly
---
说,hepingfly 你好,2026 一路发发发
测试插件是否能正常执行?
使用下面这条命令去指定 Claude Code 加载插件的位置。
Claude Code 的插件系统需要知道去哪里加载插件。
默认情况下,Claude Code 只会在特定的默认目录中查找插件。
而我们的插件放在项目目录 hepingfly-plugin 中,Claude Code 启动时并不知道这个位置,所以需要显示指定一下
PLAIN
claude --plugin-dir ./hepingfly-plugin
Claude Code 启动后,就能够加载出来我们的插件了。敲个斜杠就能联想出我们插件的名字。
执行结果:
跟我们预期的一致,说明我们这个插件就开发成功了。
到这里,就完成了第一个入门 Claude 插件,后面你可以继续接 skills / subagent / MCP。
等下一篇再继续分享,有任何问题欢迎在评论区交流。