Claude Code凯神实战指南－第六章：Plugins全攻略——一键安装海量扩展，还能自己造轮子

第六章Plugins全攻略——一键安装海量扩展还能自己造轮子 项目简介这是由凯神精心打造的一套完整的 Claude Code 实战教程系列从零基础环境安装到企业级安全合规全面系统地覆盖 Claude Code 的所有核心功能。8个完整章节包含Commands / MCP / Hooks / Skills / Plugins / 团队协作 / 企业安全 等全部内容。全中文编写实战导向每个章节都经过真实场景验证帮助你快速从零开始到能独立管理企业级项目。‍ 关于作者Lenyan 凯神一名即将进入社会的应届生开发工程师。在学习 Claude Code 的过程中深刻体验到它能极大提升开发效率。凯神把自己的学习笔记和实践经验整理成这套教程希望帮助更多同学和新人开发者快速掌握这个强大工具。这套教程的初衷很简单让大家真正用上 Claude Code提升编程效率少走弯路。凯神的观点做好指挥官让 AI 为你工作。 笔记链接目录1、Claude Code 实战指南 - 从零到起飞✨第一章2、Claude Code 实战指南 - 30命令与快捷键✨第二章3、Claude Code 实战指南 - 自定义Commands让AI秒懂你✨第三章4、Claude Code 实战指南 - MCP、Hooks与Subagent实战✨第四章5、Claude Code 实战指南 - Skills定制给Claude装能力✨第五章6、Claude Code 实战指南 - Plugins全攻略✨第六章7、Claude Code 实战指南 - 企业级协作规范与CICD✨第七章8、Claude Code 实战指南 - 企业深水区密钥安全✨第八章立即开始学习 →点击上方任意章节开始你的 Claude Code 之旅目录1. 前言2. Plugin 核心概念2.1 Plugin 是什么2.2 Plugin vs Commands / Skills / MCP2.3 生态现状3. 5 分钟安装第一个 Plugin3.1 前置检查3.2 浏览与安装 Marketplace4. Plugin 管理全流程4.1 安装 PluginDiscover 标签页4.2 管理已安装的 PluginInstalled 标签页4.3 管理 Marketplace 源Marketplaces 标签页5. 创建自定义 Plugin5.1 Plugin 结构规范5.2 plugin.json 详解5.3 实战Hello World Plugin5.4 进阶带 Skill 的完整 Plugin5.5 开发最佳实践6. 发布与分享6.1 发布前检查清单6.2 发布到 GitHub6.3 提交到官方 Marketplace7. 故障排查8. 常见问题 FAQ9. 总结10. 参考资料下一步学习1. 前言学完 Skills你已经能给 Claude 装上各种专属能力包了。但你有没有想过一个问题——辛辛苦苦写好的 Commands Skills Hooks 配置换个项目又得重来一遍想分享给团队成员手动复制粘贴Plugin 就是解决这个问题的终极方案痛点Plugin 怎么解决类比配置不可移植一个 Plugin 打包所有配置一键安装手机备份恢复分享靠手动复制Marketplace 搜一下装一下App Store更新全靠自己盯自动更新作者推了新版你自动获得APP 自动更新找好用的工具费时间社区 200 Plugin 直接选排行榜推荐说白了Plugin 可分享、可安装、可自动更新的 Commands Skills Hooks MCP 打包体。2. Plugin 核心概念2.1 Plugin 是什么Plugin 是 Claude Code 的扩展包——把 Commands、Skills、Hooks、MCP 配置打包成一个可安装、可分享、可自动更新的整体。类比理解手机Claude Code操作系统iOS/AndroidClaude Code 核心App StorePlugin Marketplace安装的 APP已安装的 PluginsAPP 自动更新Plugin 自动更新核心价值价值说明可复用一次开发多个项目使用可分享通过 Marketplace 一键安装不用手动复制模块化每个 Plugin 专注一个领域互不干扰社区驱动200 社区 Plugin 开箱即用2.2 Plugin vs Commands / Skills / MCP很多人问“我已经有 Commands 和 Skills 了为什么还要 Plugin”一张表说清楚维度CommandsSkillsMCPPlugins定义Markdown 提示词专业 Agent 能力外部服务集成打包的扩展存放位置.claude/commands/.claude/skills/.mcp.json.claude/plugins/可分享性❌ 手动复制❌ 手动复制⚠️ 需配置✅ 一键安装自动更新❌ 手动更新❌ 手动更新⚠️ 部分支持✅ 自动更新包含内容单个提示词多个文件配置服务器配置全部都能包含适用场景简单重复任务复杂专业任务外部 API 调用所有场景关键区别Plugin 是一个**“超集”**概念——Plugin Commands Skills Hooks MCP 配置 文档打包成一个可以一键安装和分享的整体。何时用什么决策指南Commands项目内简单重复任务如/format-code——够用就行别上 PluginSkills项目内复杂专业任务如代码注释生成——能力需要积累和复用MCP需要调用外部服务如 GitHub API、数据库——解决连接问题Plugins✅想分享给团队或社区的任何功能——打包分发的最佳选择2.3 生态现状三大 Marketplace平台地址特点Anthropic 官方 Marketplacecode.claude.com/plugins审核严格质量保证Jeremy Longshore 社区合集github.com/jeremylongshore/claude-code-plugins-plus200 Plugin持续更新Composio Integrationcomposio.dev集成 2000 外部工具热门 Plugin 分类速查分类典型 Plugin用途来源热度文档处理document-skillsPDF/PPTX/XLSX 全套文档处理Anthropic 官方⭐⭐⭐⭐⭐示例学习example-skills官方 Skill 开发示例Anthropic 官方⭐⭐⭐代码质量code-review-expert自动代码审查社区⭐⭐⭐⭐项目管理task-master-ai任务拆解和跟踪社区⭐⭐⭐⭐API 集成connect-appsGmail/Slack/GitHub 联动社区⭐⭐⭐⭐⭐数据分析data-viz-pro数据可视化社区⭐⭐⭐说明document-skills是 Anthropic 官方出品的文档处理套件来自anthropics/skills源安装后包含document-skills:pdf、document-skills:pptx、document-skills:xlsx等多个 Skill一次安装全部可用。3. 5 分钟安装第一个 Plugin3.1 前置检查# 1. 确认 Claude Code 版本需 v2.1claude--version# 2. 确认在项目目录中cd/path/to/your/projectPlugin 功能于 2025 年 10 月 9 日随 Claude Code v2.1 发布。如果版本过低先升级。3.2 浏览 Marketplace方式一对话内/plugin命令最方便在 Claude Code 对话中直接输入/plugin会进入 Plugin 管理界面切换到Marketplace标签页即可浏览所有可用 Plugin。方式二CLI 命令# 添加社区 Marketplace 源第一次用需要先添加claude plugin marketplaceaddanthropics/skills# 查看已添加的 Marketplace 源claude plugin marketplace list添加成功后就能从该源浏览和安装 Plugin 了。实战添加 Marketplace 源并安装 Plugin以添加 VoltAgent Subagent 代理库为例完整流程# 1. 添加 Marketplace 源claude plugin marketplaceaddVoltAgent/awesome-claude-code-subagents# 2. 从该源安装你需要的 Pluginclaude plugininstallplugin-name或者在对话中输入/plugin切换到Installed界面自行浏览安装。网络问题如果安装过程中遇到超时或下载失败需要检查代理软件配置# Windows PowerShell根据自己的代理端口修改$env:HTTP_PROXY http://127.0.0.1:7897$env:HTTPS_PROXY http://127.0.0.1:7897# macOS / LinuxexportHTTP_PROXYhttp://127.0.0.1:7897exportHTTPS_PROXYhttp://127.0.0.1:7897方式三Web 浏览器直接访问官方 Marketplace 网页https://code.claude.com/plugins4. Plugin 管理全流程在 Claude Code 对话中输入/plugin进入图形化管理界面。界面顶部有四个标签页覆盖所有管理场景标签页功能Discover浏览并安装 Plugin默认打开Installed查看和管理已安装的 PluginMarketplaces管理 Plugin 源Errors排查加载错误界面导航↑↓上下移动空格快速安装/切换回车进入详情ESC返回上级4.1 安装 PluginDiscover 标签页打开/plugin默认进入Discover标签页列出所有已添加 Marketplace 源中的可用 Plugin安装步骤用↑↓移动光标选中想安装的 Plugin按回车查看详情或直接按空格快速安装在详情页选择安装范围确认安装安装范围说明范围说明适用场景Install for you (user scope)个人级你的所有项目都可用日常通用工具推荐Install for all collaborators on this repository (project scope)项目级整个仓库的协作者共享团队协作项目Install for you, in this repo only (local scope)本地仓库级仅自己在此项目可用本地测试、不想影响他人三种安装来源来源操作方式Marketplace Plugin推荐在 Discover 标签页直接选中安装GitHub URL在 Discover 页顶部输入 GitHub 仓库地址本地目录在 Discover 页顶部输入本地路径开发测试用找不到想装的 Plugin先去Marketplaces标签页添加对应的源再回 Discover 刷新列表。4.2 管理已安装的 PluginInstalled 标签页切换到Installed标签页查看所有已启用的 Plugin列表中同时显示 Plugin 系统安装的扩展和 MCP 连接每条显示名称、版本和状态。更新 / 禁用 / 卸载操作选中某个 Plugin按回车进入详情可执行以下操作操作效果更新升级到最新版本有新版本时显示禁用临时停用保留文件下次可重新启用卸载彻底删除 Plugin 及其所有文件自动更新Claude Code 启动时会自动检查所有 Plugin 更新无需手动触发。4.3 管理 Marketplace 源Marketplaces 标签页切换到Marketplaces标签页管理 Plugin 的来源界面列出所有已添加的 Marketplace 源每个源显示可用 / 已安装的 Plugin 数量以及最后更新时间。添加新 Marketplace 源在 Marketplaces 标签页选择添加源输入源地址格式用户名/仓库名确认添加后Discover 标签页自动同步新来源的 Plugin推荐 Marketplace 源源地址内容推荐指数anthropics/skills官方 Skills 套件含 document-skills 全家桶⭐⭐⭐⭐⭐anthropics/claude-plugins-officialAnthropic 官方 Plugin⭐⭐⭐⭐VoltAgent/awesome-claude-code-subagents100 专家 Subagent详见第04章⭐⭐⭐⭐jeremylongshore/claude-code-plugins-plus社区 200 Plugin持续更新⭐⭐⭐Marketplace 源详情示例anthropics/skillsanthropic-agent-skills (anthropics/skills) 3 available · 1 installed · Updated 2026/3/6 ✅ document-skills (installed) Collection of document processing suite including Excel... ○ example-skills Collection of example skills demonstrating various capabi...推荐先装document-skills官方文档处理套件安装后自动获得 pdf、pptx、xlsx 等全套 Skill一次搞定所有文档格式。5. 创建自定义 Plugin5.1 Plugin 结构规范Plugin 本质上是一个目录里面有个.claude-plugin/plugin.json清单文件加上你要打包的各种能力。最小结构一个 Skillmy-plugin/ ├── .claude-plugin/ │ └── plugin.json # 必需Plugin 清单 └── skills/ └── my-skill/ └── SKILL.md完整结构所有能力my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 必需Plugin 清单只有这个在 .claude-plugin/ 内 ├── README.md # 推荐使用文档 ├── LICENSE # 推荐开源协议 ├── skills/ # 可选Agent Skills │ └── my-skill/ │ └── SKILL.md ├── commands/ # 可选Slash Commands │ └── my-command.md ├── agents/ # 可选自定义 Agent 定义 ├── hooks/ # 可选事件钩子 │ └── hooks.json ├── .mcp.json # 可选MCP 服务配置 └── settings.json # 可选Plugin 启用时的默认设置⚠️常见踩坑commands/、skills/、agents/、hooks/都放在插件根目录不要放进.claude-plugin/里——那里只放plugin.json。各目录职责速查目录/文件职责.claude-plugin/plugin.jsonPlugin 清单定义名称/版本/作者skills/Agent Skills含 SKILL.md 的子目录commands/Slash 命令Markdown 文件agents/自定义 Agent 定义hooks/事件处理器hooks.json.mcp.jsonMCP 服务配置settings.jsonPlugin 启用时应用的默认设置5.2 plugin.json 详解plugin.json放在.claude-plugin/目录下是 Plugin 的「身份证」。完整示例{name:my-awesome-plugin,description:一句话说明这个 Plugin 做什么,version:1.0.0,author:{name:Your Name},license:MIT,homepage:https://github.com/yourname/my-plugin,repository:https://github.com/yourname/my-plugin}字段速查字段是否必填说明name✅Plugin 唯一标识同时是 Skill 的命名空间前缀description✅功能描述Marketplace 中用于搜索和展示version✅语义化版本号主.次.补丁如1.0.0author推荐作者信息name/email/urllicense推荐开源协议推荐MIT或Apache-2.0homepage可选项目主页或文档地址repository可选代码仓库地址关键点name字段决定了 Skill 的调用前缀。Plugin 名叫my-plugin里面的helloSkill 就要用/my-plugin:hello来触发——命名空间设计防止多个 Plugin 的 Skill 名称冲突。5.3 实战Hello World Plugin5 分钟从零创建并测试你的第一个 PluginStep 1创建目录结构mkdir-phello-plugin/.claude-pluginmkdir-phello-plugin/skills/hello**Step 2创建清单 **.claude-plugin/plugin.json{name:hello-plugin,description:一个简单的问候示例 Plugin,version:1.0.0,author:{name:Your Name},license:MIT}**Step 3创建 Skill **skills/hello/SKILL.md--- description: Greet the user with a friendly message --- 用友好的方式向用户打招呼。 步骤 1. 获取当前系统时间 2. 根据时间段上午/下午/晚上调整问候语 3. 用轻松愉快的语气回复 示例输出 早上好现在是 10:23新的一天有什么我能帮你的Step 4本地测试不需要安装直接用--plugin-dir标志加载# 加载插件并启动 Claude Codeclaude --plugin-dir ./hello-plugin# 启动后在对话里输入注意命名空间格式/hello-plugin:hello看到问候输出第一个 Plugin 就跑通了--plugin-dir是开发专用标志每次修改 Skill 后重启 Claude Code 即可生效无需安装。要同时测试多个 Plugin可以多次指定claude --plugin-dir ./plugin-a --plugin-dir ./plugin-bStep 5带参数的 Skill$ARGUMENTS占位符可以捕获用户输入的文本让 Skill 动态响应--- description: Greet the user with a personalized message --- 用友好的方式向名叫 $ARGUMENTS 的用户打招呼让问候更有温度。重启后测试/hello-plugin:hello 凯神# Claude 会用你传入的名字问候5.4 进阶带 Skill 的完整 Plugin创建一个代码质量检查 Plugin演示 Skill Commands 的组合威力项目结构code-quality-checker/ ├── .claude-plugin/ │ └── plugin.json ├── README.md ├── skills/ │ └── code-review/ │ └── SKILL.md └── commands/ └── check.md.claude-plugin/plugin.json{name:code-quality-checker,description:自动检查代码质量按严重程度给出改进建议,version:1.0.0,author:{name:Your Name},license:MIT}skills/code-review/SKILL.md--- description: Reviews code for best practices, security issues, and quality problems. Use when reviewing code, checking PRs, or analyzing code quality. --- # 代码质量检查专家 ## 角色定义 你是一位资深代码审查专家擅长发现代码质量问题并给出具体改进建议。 ## 检查维度 1. **命名规范**变量名/函数名是否语义清晰 2. **函数复杂度**单个函数是否过长或嵌套过深 3. **重复代码**是否存在可抽取的重复逻辑 4. **错误处理**异常边界是否覆盖 5. **安全隐患**是否存在注入/XSS 等风险 ## 输出格式 按严重程度排序 - 严重必须修复 - 警告建议修复 - 建议可以改进 每条包含问题描述 代码位置 修复建议commands/check.md对指定代码进行质量检查。 参数$ARGUMENTS可选指定检查的文件路径 步骤 1. 如果指定了文件路径只检查该文件 2. 如果未指定检查最近修改的文件通过 git diff --name-only 获取 3. 按 5 个维度逐项分析输出分级报告测试claude --plugin-dir ./code-quality-checker# 触发 Skill自动识别帮我检查这段代码的质量# 显式调用命令注意命名空间/code-quality-checker:check src/app.tsPlugin 的「超集」威力在这里体现得很清楚Commands 提供触发入口Skills 提供专业能力打包在一起就是可分享的完整工具。5.5 开发最佳实践1. 先用独立配置再转 Plugin阶段方式原因实验期直接放.claude/skills/Skill 名短/hello迭代快准备共享打包成 PluginSkill 带命名空间/my-plugin:hello便于分发2. 语义化版本号版本号格式主.次.补丁如 1.2.3 - 主版本1.x.x破坏性变更不向后兼容 - 次版本x.2.x新增功能向后兼容 - 补丁版x.x.3Bug 修复3. README 必须包含四个部分部分内容功能说明这个 Plugin 做什么解决什么问题安装方法从 Marketplace 或 GitHub 安装的命令使用示例至少一个真实使用场景含 Skill 调用格式配置说明如果有可配置项的话4. Skill description 是关键SKILL.mdfrontmatter 中的description决定 Claude 能否自动识别场景并激活 Skill# ❌ 太模糊自动激活不准 description: Code review tool # ✅ 明确触发场景自动识别准确 description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.6. 发布与分享6.1 发布前检查清单必须完成✅.claude-plugin/plugin.json格式正确name/description/version填写完整✅README.md包含安装和使用说明含 Skill 调用格式/插件名:skill名✅LICENSE文件存在推荐 MIT✅ 用claude --plugin-dir .本地测试通过所有 Skill 和命令正常工作推荐完成⭐CHANGELOG.md记录每个版本的变更内容⭐ GitHub 仓库添加 Topics 标签如claude-code-plugin便于被搜索⭐ README 中注明最低 Claude Code 版本要求6.2 发布到 GitHub# 1. 初始化仓库cdmy-plugingitinitgitadd.gitcommit-mfeat: initial release v1.0.0# 2. 推送到 GitHubgitremoteaddorigin https://github.com/yourname/my-plugin.gitgitbranch-Mmaingitpush-uorigin main创建 Release让别人能按版本安装进入 GitHub 仓库页面点击Releases → Draft a new releaseTag version 填v1.0.0必须以v开头填写本次发布说明点击Publish release发布后其他人就能通过 GitHub URL 直接安装# 在 /plugin 界面的 Discover 页顶部输入 GitHub 地址安装# 或用 CLIclaude plugininstallhttps://github.com/yourname/my-plugin在 README 中加个版本徽章一眼看出当前版本6.3 提交到官方 Marketplace想让全球 Claude Code 用户都能搜到你的 Plugin直接用应用内提交表单不需要 Fork 仓库、提 PR一个表单搞定平台提交入口Claude.aiclaude.ai/settings/plugins/submitAnthropic Consoleplatform.claude.com/plugins/submit提交前确认审核项要求.claude-plugin/plugin.json格式正确必填字段完整README安装和使用说明完整含 Skill 调用格式代码安全无恶意代码依赖来源可信功能完整--plugin-dir测试全部通过提交后等待 Anthropic 审核通常 1-3 个工作日。审核通过后你的 Plugin 就会出现在官方 Marketplace全球 Claude Code 用户都能一键安装。7. 故障排查7.1 安装问题现象原因解决方法Plugin not found名称拼写错误或 Marketplace 源未添加先在 Marketplaces 标签页添加源再到 Discover 搜索下载超时网络问题设置代理或切换 npm 镜像源/plugin命令不存在Claude Code 版本过低升级到 v1.0.33运行claude --version确认# 网络问题换国内镜像源npmconfigsetregistry https://registry.npmmirror.com# 需要代理根据自己的代理端口修改exportHTTP_PROXYhttp://127.0.0.1:7897exportHTTPS_PROXYhttp://127.0.0.1:78977.2 运行时问题现象原因解决方法Skill 调用格式不对忘记命名空间前缀Plugin 内的 Skill 用/插件名:skill名格式Skill 未自动激活SKILL.md 的 description 描述太模糊明确写出触发场景如 “Use when reviewing code…”Hook 脚本权限错误脚本缺少执行权限chmod x hooks/my-hook.sh配置修改不生效未重启 Claude Code修改 Plugin 内容后需重启7.3 开发调试现象原因解决方法--plugin-dir加载失败目录结构不正确确认.claude-plugin/plugin.json存在于插件根目录Plugin 中 Skill 找不到skills/ 放错位置skills/必须在插件根目录不能在.claude-plugin/内plugin.json 解析报错JSON 格式错误用在线 JSON 验证工具检查确认冒号后有空格、无多余逗号# 启用详细日志排查问题exportCLAUDE_LOG_LEVELdebug claude --plugin-dir ./my-plugin8. 常见问题 FAQQ1Plugin 和 Skill 到底啥区别一句话Skill 是能力本身Plugin 是把能力打包成可安装、可分享的形式。Plugin 可以包含 Skill也可以包含 Commands、Hooks、MCP 配置等。Q2Plugin 更新会覆盖我的配置吗不会。更新时保留你的config.json个人配置只更新 Plugin 代码文件skills/、commands/ 等。Q3Plugin 开发需要懂编程吗类型需要编程说明只有 Commands 的 Plugin❌ 不需要写 Markdown 就行包含 Skills 的 Plugin❌ 不需要写 MarkdownSKILL.md带脚本的 Plugin✅ 需要Python/JavaScript 基础带 MCP Server 的 Plugin✅ 需要Node.js/Python 开发经验Q4Plugin 可以离线使用吗安装在本地的 Plugin 可以离线使用。但如果 Plugin 内部调用了外部 API如 GitHub API那部分功能需要联网。Q5Plugin 支持哪些编程语言语言支持度适用场景JavaScript/TypeScript⭐⭐⭐⭐⭐MCP 集成、CLI 工具Python⭐⭐⭐⭐⭐数据处理、AI 集成Shell Script⭐⭐⭐⭐系统操作、自动化Go / Rust⭐⭐高性能工具需编译为可执行文件Q6如何查看 Plugin 使用了多少 Token可以通过/cost命令查看整体 Token 消耗。Plugin 本身不单独计费Token 消耗取决于 Plugin 加载的提示词量和对话内容。Q7可以同时安装多个版本的 Plugin 吗不可以。同一个 Plugin 只能安装一个版本。如果需要在不同项目使用不同版本可以用项目级安装默认隔离。Q8Plugin 报错如何获取帮助查看 Plugin 的 README 和 GitHub Issues在 Anthropic Discord 的#claude-code-plugins频道提问提 GitHub Issue 时包含系统环境、Claude Code 版本、Plugin 版本、完整错误信息9. 总结本章你已掌握Plugin 本质可分享的 Commands Skills Hooks MCP 打包体一键安装、自动更新核心区别Plugin 是超集概念解决了 Commands/Skills 无法便捷分享的痛点生态现状官方 Marketplace 社区 200 Plugin按需选择安装管理/plugin界面的 Discover / Installed / Marketplaces 三大标签页全程图形化操作自定义开发.claude-plugin/plugin.json清单 skills/commands/标准结构--plugin-dir秒测试发布分享GitHub Release 发布 官方 Marketplace 表单提交让全世界用上你的 Plugin10. 参考资料Plugin 相关资源Claude Code 官方 Plugin 文档知乎深度讲解Claude Code Plugin 完整指南知乎教程Claude Code Plugin 实战与最佳实践ClaudeCN 中文文档Plugin 开发与使用下一步学习章节主题你将学到第07章从单兵到团队——企业级协作规范、CI/CD 与安全合规实战团队协作规范、GitHub Actions CI/CD 集成、安全权限配置、成本控制第08章企业深水区——密钥安全、团队配置与合规审计全攻略团队配置统一化、Git Hooks 自动审查、API Key 分级管理、GDPR/SOC2 合规、安全扫描作者简介一名正在实习的Java开发工程师热爱技术分享专注于性能优化和系统架构设计。觉得有用的话可以点点赞 (/ω)支持一下。如果愿意的话关注一下。会对你有更多的帮助。每周都会不定时更新哦 人 。版权声明本文为原创技术文章转载请注明出处。