插件（Plugin）是 Claude Code 中 最高级别的扩展机制 ，用于将命令、代理、Skills、钩子、MCP、LSP 等能力 打包、版本化、共享和分发 。
插件 = 一组可复用的 Claude Code 扩展能力集合
一个插件可以包含：
插件的核心目标只有一个： 让 Claude Code 的能力像工具箱"一样被复用，而不是每个项目重复配置
插件 vs 独立配置（如何选择）
Claude Code 支持两种扩展方式：
什么时候用独立配置？
什么时候用插件？
最佳实践： 先在 .claude/ 中迭代 → 稳定后打包为插件
.claude/
插件的最小结构（必须记住）
my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单（必需） ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置
重要规则
插件清单（plugin.json）
插件的"身份证"，决定：
示例：
{ "name": "my-first-plugin", "description": "A greeting plugin to learn the basics", "version": "1.0.0", "author": { "name": "Your Name" } }
关键字段说明：
斜杠命令（最常用插件能力）
1、命令定义方式
commands/hello.md
对应命令：
/my-first-plugin:hello
2、命令内容示例
--- description: Greet the user with a friendly message --- Greet the user warmly and ask how you can help them today.
3、命令参数
使用 $ARGUMENTS 捕获用户输入：
Greet the user named "$ARGUMENTS" warmly.
调用：
/my-first-plugin:hello Alex
本地测试插件（开发必会）
使用 --plugin-dir 直接加载插件目录：
claude --plugin-dir ./my-plugin
特点：
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b
插件还能做什么
插件市场（Plugin Marketplace）
插件通过 市场 分发，本质是一个插件目录仓库。
官方市场
安装插件：
/plugin install plugin-name@claude-plugins-official
插件安装范围
推荐：
典型插件分类
1、代码智能（LSP）
需要本地安装对应语言服务器
2、外部集成（MCP）
本质： 插件 = MCP 服务器 + 配置
3、开发工作流
插件管理常用命令
/plugin # 打开插件管理器 /plugin install # 安装插件 /plugin uninstall # 卸载 /plugin enable/disable # 启用 / 禁用 /plugin marketplace add # 添加市场 /plugin marketplace rm # 移除市场
从 .claude/ 迁移到插件（核心思路）
迁移后：
什么时候你一定要用插件？
插件，是 Claude Code 从"个人 AI 助手"走向"工程化工具"的分水岭
