Claude Code Plugins 是将 Slash Commands、Skills、Subagents、MCP、Hooks 等多种扩展能力打包成可一键安装的扩展包，极大简化了团队协作和功能分发。通过插件，开发者无需手动配置多个命令和代理，只需一条命令即可完成集成和自动化。本文以 pr-review 插件为例，详细讲解插件目录结构、安装/卸载命令、与 Skill 的本质区别及最佳实践，帮助你高效掌握 Claude Code 插件体系。

Claude Code Plugins：一键安装捆绑 Commands + Subagents + Hooks 的扩展包

Claude Code Plugins 是 Claude Code 的最高级扩展机制，允许你将 Slash Commands（斜杠命令）、Skills（AI 能力单元）、Subagents（专职代理）、MCP（外部数据接入）、Hooks（事件钩子）等多种组件，打包成一个可分发、可复用、可一键安装的插件包。插件极大提升了团队协作、自动化和环境一致性，适合需要批量分发、自动配置、团队标准化的场景。

如果你还不熟悉 Claude Code 的基础架构，建议先阅读 Claude Code 完全入门：从安装到掌握核心功能 了解整体生态。

插件是什么，解决什么问题？

在 Claude Code 体系中，Plugin（插件）是分发单元，它可以包含多个 Commands、Subagents、Hooks、MCP 等能力，打包后通过一条命令即可安装到任意项目或用户环境中。相比单独的 Skill（能力单元），Plugin 更像是一个“功能合集”，适合批量分发和团队协作。

典型场景：

• 团队成员一键获得完整的代码审查、DevOps、文档生成等自动化工作流
• 企业标准工具链快速落地，减少环境配置误差
• 插件市场统一管理、升级和权限控制

插件结构与核心组成

Claude Code 插件采用结构化目录，核心清单为 .claude-plugin/plugin.json。以官方 pr-review 插件为例，目录结构如下：

pr-review/
├── .claude-plugin/
│   └── plugin.json       # 插件清单（名称、描述、版本、作者等）
├── commands/             # Slash Commands（如 /review-pr、/check-security）
│   ├── review-pr.md
│   ├── check-security.md
│   └── check-tests.md
├── agents/               # Subagents（如 security-reviewer、test-checker）
│   ├── security-reviewer.md
│   ├── test-checker.md
│   └── performance-analyzer.md
├── mcp/                  # MCP 配置（如 github-config.json）
│   └── github-config.json
├── hooks/                # Hooks（如 pre-review.js）
│   └── pre-review.js
├── README.md             # 插件文档
└── ...                   # 其他配置、脚本、测试等

主要组件说明

• plugin.json：插件元数据，包含名称、描述、版本、作者、依赖等。
• commands/：Markdown 格式的 Slash Commands，每个文件定义一个命令。
• agents/：Subagent 定义，专职 AI 代理（如安全审查、测试分析）。
• mcp/：MCP 服务器配置，实现与 GitHub、Kubernetes 等外部系统集成。
• hooks/：事件钩子脚本，实现自动校验、格式化等自动化流程。

更多关于各模块的原理和用法，可参考 Slash Commands 完整参考、Subagents：把复杂任务委托给专职 AI 代理、Hooks 完全指南。

插件的安装与卸载

一键安装

插件安装极其简单，只需一条命令：

/plugin install pr-review

安装完成后，Claude Code 会自动注册所有命令、子代理、MCP、Hooks 等，输出如下：

✅ 3 slash commands installed
✅ 3 subagents configured
✅ 2 MCP servers connected
✅ 4 hooks registered
✅ Ready to use!

你可以立即使用插件内的所有命令，例如：

/review-pr
/check-security
/check-tests

卸载插件

如需卸载插件，使用：

/plugin uninstall pr-review

此命令会彻底移除所有相关命令、代理、钩子和配置，环境恢复到安装前的状态。

插件管理常用命令

• 查看已安装插件：

  /plugin list --installed

• 禁用/启用插件：

  /plugin disable pr-review
  /plugin enable pr-review

• 更新插件：

  /plugin update pr-review

插件与 Skill 的区别

• Skill（技能）：最小的 AI 能力单元，通常只实现一个功能（如代码重构、文档生成），适合个人或项目级复用。详细见 Claude Code Skills 体系详解。
• Plugin（插件）：分发单元，可以打包多个 Skill、Slash Command、Subagent、MCP、Hook 等，适合团队/组织级分发和自动化配置。

简单理解：Skill 是“能力”，Plugin 是“工具包”。

以 pr-review 插件为例的完整工作流

1. 用户输入 /review-pr
2. 插件自动执行 pre-review 钩子，校验 Git 仓库状态
3. 通过 MCP 连接 GitHub，拉取 PR 数据
4. 分别调用 security-reviewer、test-checker、performance-analyzer 三个子代理，完成安全、测试、性能分析
5. 汇总所有分析结果，输出完整的 PR 审查报告

示例输出：

✅ Security: No critical issues found
⚠️  Testing: Coverage is 65%, recommend 80%+
✅ Performance: No significant impact
📝 Recommendations: Add tests for edge cases

插件开发与本地测试

开发自定义插件时，可用本地目录加载方式测试：

claude --plugin-dir ./my-plugin

支持热重载，修改后可用 /reload-plugins 立即生效。

插件分发与市场

Claude Code 官方和社区均支持插件市场（Marketplace）分发，企业也可自建私有市场。插件市场支持权限控制、版本锁定、插件黑白名单等高级策略，便于大规模团队管理。

添加市场示例：

/plugin marketplace add owner/repo-name

插件最佳实践与注意事项

• 插件应聚焦单一领域，避免功能过于分散
• 必须包含清晰的 README 和使用示例
• 版本号采用语义化管理，便于升级和回滚
• 不要在插件中硬编码敏感信息，敏感配置应通过环境变量或用户输入
• 发布前务必本地全量测试，确保所有命令、代理、钩子均可用

常见问题与排查建议

• 插件无法安装？

  • 检查 Claude Code 版本兼容性，确保 plugin.json 语法正确，网络和权限正常。

• 命令/代理未生效？

  • 确认插件已启用，结构目录无误，命令或代理文件名与配置一致。

• MCP 连接失败？

  • 检查环境变量、MCP 服务端配置和网络连通性。

更多排查建议见文末 FAQ。

---

FAQ

Q: 插件和 Skill 有什么本质区别？ A: 插件是“分发单元”，可打包多个命令、技能、子代理、钩子等，适合团队和市场分发；Skill 是“能力单元”，更适合单一功能复用，通常手动配置。

Q: 插件支持热更新或本地开发吗？ A: 支持。开发时可用 claude --plugin-dir ./my-plugin 加载本地插件，修改后用 /reload-plugins 热重载，无需重启。

Q: 如何彻底卸载插件？会残留配置吗？ A: 使用 /plugin uninstall 插件名 即可彻底卸载，所有命令、代理、钩子和相关配置都会一并移除，不会残留。

Q: 插件可以访问哪些系统资源？有安全隔离吗？ A: 插件内的 subagent 运行在受限沙箱，不能注册 hooks/mcpServers/permissionMode，避免权限提升，保障主环境安全。

---

通过 Claude Code Plugins，你可以将复杂的自动化工作流、团队标准、DevOps 工具链等一键分发给所有成员，实现高效协作和环境一致性。建议优先采用插件机制，最大化 Claude Code 的自动化和复用价值。