目录一、前言二、Claude Code 插件介绍2.1 Claude Code 插件是什么2.2 Claude Code 插件核心组成2.3 插件能做什么2.4 工作原理与生命周期2.5 插件配置方式2.6 插件的最小结构三、Claude Code 插件使用3.1 插件管理常用命令3.2 插件安装3.2.1 进入官方插件市场3.2.2 执行插件安装3.2.3 插件检查3.2.4 插件加载3.2.5 插件使用3.3 代码智能插件安装使用3.3.1 智能代码插件安装3.3.2 智能代码插件使用3.3.3 外部集成工具3.4 整合Codex 插件使用3.4.1 添加插件市场3.4.2 安装Codex 插件3.4.3 使用 Codex 生态下的插件3.5 插件管理3.5.1 添加插件市场3.4.2 管理插件3.4.3 应用插件更改而不重启3.4.4 管理市场3.4.5 配置团队市场3.4.6 安全性说明3.5 插件安装失败问题处理3.5.1 /plugin命令无法识别3.5.2 其他常见问题3.6 自定义插件前置准备3.6.1 何时使用插件与独立配置3.6.2 插件的最小结构3.6.3 创建你的第一个插件3.6.4 开发更复杂的插件3.7 自定义插件开发3.7.1 输入提示词生成插件3.7.2 安装新插件3.7.3 调试插件中的问题3.7.4 共享你的插件3.7.5 向官方市场提供你的插件四、写在文末一、前言今年最火热的大模型当属Claude Code了除了AI编程带来的令人惊讶的高效还能完成各类复杂的任务同时其生态也在持续扩大自己版图比如配套的Skills技能市场插件市场以及与其他社区进行深度联动融合都为Claude Code带来了极高的热度本篇接下来将详细介绍Claude Code中一个非常重要且实用的功能即Claude Code插件。二、Claude Code 插件介绍2.1 Claude Code 插件是什么Claude Code 插件系统将 Claude Code 从一个基础的 AI 编程助手升级为了一个可高度定制、能不断适应个人或团队工作流的开发平台。它的核心价值在于通过模块化的方式让开发者能轻松地扩展、分享和复用各种功能从而提升编码和协作效率。官方插件地址Plugins for Claude | Claude by Anthropic2.2 Claude Code 插件核心组成一个完整的 Claude Code 插件可以包含以下一个或多个核心组件类似于“功能增强包”插件 一组可复用的 Claude Code 扩展能力集合一个插件可以包含斜杠命令Slash Commands子代理AgentsSkills能力说明Hooks事件钩子MCP 服务器外部工具/服务LSP 服务器代码智能插件的核心目标只有一个让 Claude Code 能力像工具箱一样被复用而不是每个项目重复配置2.3 插件能做什么插件系统让 Claude Code 的应用场景变得非常广泛团队协作与知识传承可以为复杂的代码模块创建专属“领域专家”子代理帮助新成员快速上手实现团队知识的沉淀。标准化开发流程将包含复杂环境准备和启动命令的流程封装成插件团队成员只需一个简单的斜杠命令如/run-pipeline即可标准化执行。个人效率工具链开发者可以将自己常用的工具、脚本打包成个人插件在不同电脑或项目中快速恢复熟悉的开发环境。2.4 工作原理与生命周期插件的运作遵循一套标准流程保证了其稳定性和可移植性定义插件通过根目录下的plugin.json清单文件定义自身结构、元数据和组件位置。发现Claude Code启动时会自动扫描并加载已安装插件目录下的组件。集成加载的组件会无缝集成到工作环境中斜杠命令、子代理等即可像内置功能一样被调用。便携性插件内部通过${CLAUDE_PLUGIN_ROOT}等环境变量引用路径确保了在不同操作系统和安装位置下都能正常工作。2.5 插件配置方式Claude Code 支持两种扩展方式方式命令形式适合场景独立配置.claude//hello个人使用、单项目、快速实验插件.claude-plugin//plugin-name:hello团队共享、跨项目、版本化什么时候用独立配置只在当前项目使用个人工作流尚未稳定的实验性配置想要简短命令名如/review什么时候用插件要在多个项目复用要分享给团队或社区需要版本控制、升级、回滚计划通过市场分发可以接受命名空间命令避免冲突最佳实践先在.claude/中迭代 → 稳定后打包为插件2.6 插件的最小结构在开发Claude Code 插件时需要按照一定的结构规范下面是插件的最小结构形式my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单必需 ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置重要规则说明.claude-plugin/目录中只能放plugin.json其他目录必须在插件根目录三、Claude Code 插件使用接下来通过实际案例操作演示下Claude Code 插件的使用3.1 插件管理常用命令为了方便接下来对插件的学习和使用下面列举了Claude Code的插件相关的常用命令/plugin # 打开插件管理器 /plugin install # 安装插件 /plugin uninstall # 卸载 /plugin enable/disable # 启用 / 禁用 /plugin marketplace add # 添加市场 /plugin marketplace rm # 移除市场3.2 插件安装可以从插件市场发现和安装插件以使用新命令、代理和功能扩展 Claude Code插件通过 skills、agents、hooks 和MCP servers 扩展Claude Code插件市场是帮助您发现和安装这些扩展的目录无需自己构建3.2.1 进入官方插件市场官方插件市场 Plugins for Claude | Claude by Anthropic进入官方插件市场可以看到提供了很多插件官方插件市场(claude-plugins-official)在您启动 Claude Code 时自动可用。运行 /plugin 并转到发现选项卡以浏览可用内容要从官方市场安装插件请使用 /plugininstallnameclaude-plugins-official。例如要安装GitHub集成在打开Claude Code 命令行窗口后只需要输入下面这段命令即可/plugin install githubclaude-plugins-official插件名字从哪里来的呢以下面这个插件为例点击这个插件进去点击右侧的复制按钮将会得到一串安装插件的命令claude plugin install code-reviewclaude-plugins-official3.2.2 执行插件安装添加官方插件市场这一步必须要做相当于是告诉Claude Code 你要从哪里安装插件后面还会从很多插件市场添加插件/plugin marketplace add anthropics/claude-code这行命令把 Anthropic 官方的插件市场注册到你的 Claude Code 里。anthropics/claude-code是 GitHub 上的仓库地址Claude Code 会从这里读取可用的插件列表。默认情况下通过 /plugins 可以进入到插件页面输入上面的命令点击安装看到下面的效果说明就安装成功了3.2.3 插件检查然后可以输入 /plugin 命令检查一下可以看到在下面的页面有多个tab页面比如当你把上面的插件市场添加进去之后插件市场就可以展示出相关的插件在这里可以直接搜索相关插件进行过滤比如搜索前端设计的插件选中之后直接安装在这里操作就更方便了3.2.4 插件加载插件安装完成后需要执行下面这个加载命令才能显示出上面安装的插件稍作等待后就可以展示出已安装的插件当然也可以通过 /plugin 进入检查进去之后在已安装的那个TAB页可以看到3.2.5 插件使用基于上面安装的code-review 插件对我们项目中的某段代码进行review在项目中打开Claude Code 终端然后输入下面的提示词基于/code-review 这个插件对FeeComplexRuleController这个类中的addFeeComplexRule这个接口进行代码review等待一会之后Claude Code 调用该插件最终完成了对我指定接口代码的review并给出了详细的review分析结论3.3 代码智能插件安装使用代码智能插件启用Claude Code的内置LSP工具使Claude能够跳转到定义、查找引用并在编辑后立即查看类型错误。这些插件配置语言服务器协议连接这是为 VSCode代码智能提供支持的相同技术。这些插件需要在您的系统上安装语言服务器二进制文件。如果你已经安装了语言服务器当您打开项目时Claude可能会提示您安装相应的插件。3.3.1 智能代码插件安装在官方插件市场搜索 lsp 可以看到有不同编程语言的lsp插件参考上面的方式在终端窗口中执行下面的命令完成安装这里我选择Java的lsp/plugin install jdtls-lspclaude-plugins-official或者拷贝官方的安装命令claude plugin install jdtls-lspclaude-plugins-official3.3.2 智能代码插件使用加载成功后让AI编写一段代码然后基于这个插件对代码做类型检查使用java语言编写一个冒泡排序并基于jdtls-lsp插件做类型检查可以看到整个过程是按照预期的流程进行的3.3.3 外部集成工具有一些插件还捆绑了预配置的 MCP Servers以便开发者可以连接Claude到外部服务无需手动设置比如下面这些源代码控制github、gitlab项目管理atlassian (Jira/Confluence) asana、 linear、notion设计figma基础设施vercel、firebase、supabase通信slack监控sentry比如当你安装了figma插件之后就可以直接基于使用figma开发的原型设计稿直接进行编码开发了在官方插件中有详细的说明3.4 整合Codex 插件使用对于已经在使用Claude Code的开发者这个插件提供了一个低成本的Codex试用入口。而对OpenAI而言这是在竞争对手的地盘上建立存在感的一次聪明尝试。对开发者来说也可以在不同的AI工具直接快速切换。下面具体介绍下使用过程。3.4.1 添加插件市场进入到codex-cc的gitGitHub - openai/codex-plugin-cc: Use Codex from Claude Code to review code or delegate tasks. · GitHub在Claude Code 命令行窗口执行第一条命令进行插件市场添加/plugin marketplace add openai/codex-plugin-cc3.4.2 安装Codex 插件执行第二条安装Codex 插件命令安装完成后记得重新加载3.4.3 使用 Codex 生态下的插件上一步装完之后此时就能看到接下去就能执行codex的像个命令了执行这个命令后看到下面的输出说明就可以开始使用Codex 生态下的相关插件了3.5 插件管理3.5.1 添加插件市场使用 /plugin marketplace add 命令从不同来源添加市场不同的市场都有自己特定的插件这样都可以加载进去使用GitHub 存储库owner/repo 格式(例如,anthropics/claude-code)Git URL任何git 存储库 URL(GitLab、Bitbucket、自托管)本地路径目录或marketplace.json 文件的直接路径远程URL托管marketplace.json 文件的直接URL1从GitHub 添加使用 owner/repo 格式添加包含.claude-plugin/marketplace.json 文件的GitHub存储库其中owner 是GitHub用户名或组织,repo 是存储库名称。例如,anthropics/claude-code 指的是由 anthropics 拥有的 claude-code 存储库/plugin marketplace add anthropics/claude-code2从其他Git主机添加通过提供完整URL添加任何git 存储库。这适用于任何Git 主机包括GitLab、Bitbucket 和自托管服务器:使用HTTPS:/plugin marketplace add https://gitlab.com/company/plugins.git如果要添加特定分支的或者特定标签的请在#后附加ref/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.03使用SSH添加/plugin marketplace add gitgitlab.com:company/plugins.git4从本地路径添加添加包含.claude-plugin/marketplace.json 文件的本地目录/plugin marketplace add ./my-marketplace也可以添加 marketplace.json 文件的直接路径/plugin marketplace add ./path/to/marketplace.json5从远程URL添加通过URl添加远程 marketplace.json 文件/plugin marketplace add https://example.com/marketplace.json3.4.2 管理插件运行 /plugin 并转到已安装选项卡以查看、启用、禁用或卸载您的插件。键入以按插件名称或描述筛选列表。您也可以使用直接命令管理插件。禁用插件而不卸载/plugin disable plugin-namemarketplace-name重新启用已禁用的插件/plugin enable plugin-namemarketplace-name完全删除插件/plugin uninstall plugin-namemarketplace-name-- scope 选项允许您使用CLI命令针对特定范围claude plugin install formatteryour-org --scope project claude plugin uninstall formatteryour-org --scope project3.4.3 应用插件更改而不重启当你在会话期间安装启用或禁用插件时运行/reload-plugins 以在不重启的情况下获取所有更改:Claude Code重新加载所有活跃插件并显示重新加载的命令、skills、agents、hooks、插件MCPservers和插件LSP servers 的计数。3.4.4 管理市场您可以通过交互式/plugin 界面或CLI命令管理市场。1使用交互式界面运行 /plugin 并转到市场选项卡以查看所有已添加的市场及其来源和状态添加新市场更新市场列表以获取最新插件删除您不再需要的市场2使用CLI命令也可以使用直接命令管理市场。列出所有配置的市场。刷新市场的插件列表:/plugin marketplace update marketplace-name3删除插件市场/plugin marketplace remove marketplace-name3.4.5 配置团队市场团队管理员可以通过将市场配置添加到.claude/settings.json来为项目设置自动市场安装。当团队成员信任存储库文件夹时Claude Code会提示他们安装这些市场和插件。将 extraKnownMarketplaces 添加到您项目的.claude/settings.json 有关完整配置选项(包括 extraKnownMarketplaces 和 enabledPlugins){ extraknownMarketplaces:{ my-team-tools: { source: { source:github, repo: your-org/claude-plugins } } } }3.4.6 安全性说明插件和市场是高度受信任的组件可以使用您的用户权限在您的机器上执行任意代码。仅从您信任的来源安装插件和添加市场。组织可以使用托管市场限制限制用户允许添加的市场。3.5 插件安装失败问题处理在安装插件过程中可能会遇到各种错误下面介绍几种。3.5.1 /plugin命令无法识别如果看到”未知命令”或/plugin命令未出现:检查您的版本:运行claude --version 以查看安装的内容。更新 Claude CodeHomebrew: brew upgrade claude-codenpm: npm update -g anthropic-ai/claude-code本地安装程序从设置重新运行安装命令重启 Claude Code更新后重启您的终端并再次运行claude。3.5.2 其他常见问题市场未加载验证 URL是否可访问以及.claude-plugin/marketplace.json 是否存在于该路径插件安装失败检查插件源URL是否可访问以及存储库是否公开(或您有访问权限)安装后找不到文件插件被复制到缓存因此引用插件目录外文件的路径将不起作用插件 skills 未出现使用 rm -rf ~/.claude/plugins/cache 清除缓存,重 Claude Code,然后重新安装插件。3.6 自定义插件前置准备上面分享的是如何在Claude Code中使用外部或其他三方插件也支持在Claude Code 中自己创建插件。创建自定义插件以使用 skills、agents、hooks 和 MCP servers 扩展Claude Code。Plugins 让你能够使用自定义功能扩展Claude Code这些功能可以在项目和团队中共享。本指南涵盖如何使用 skills、agents、hooks和MCP servers 创建自己的插件。3.6.1 何时使用插件与独立配置Claude Code支持两种方式来添加自定义 skills、agents和 hooks方法Skill 名称适合场景独立(.claude/目录)/hello个人工作流、项目特定的自定义、快速实验插件(包含.claude-plugin/plugin.json的目录/plugin-name:hello与团队成员共享、分发到社区、版本化发布、跨项目重用在以下情况下使用独立配置你正在为单个项目自定义Claude Code配置是个人的不需要共享你在打包skills或hooks之前进行实验你想要简短的skill名称如 /hello 或/deploy在以下情况下使用插件:你想与团队或社区共享功能你需要在多个项目中使用相同的skills/agents你想要版本控制和轻松更新扩展你通过市场分发你可以接受命名空间化的skills,如/my-plugin:hel1o(命名空间可防止插件之间的冲突)3.6.2 插件的最小结构在开发Claude Code 插件时需要按照一定的结构规范下面是插件的最小结构形式my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单必需 ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置插件结构概览你已创建了一个带有skill的插件但插件可以包含更多内容:自定义agents、hooks、MCP servers和LSP servers目录位置目的.claude-plugin/插件根包含plugin.json清单(如果组件使用默认位置则可选)commands/插件根作为Markdown文件的 Skillsagents/插件根自定义agent定义skills/插件根带有 skIL.md文件的Agent Skillshooks/插件根hooks.json中的事件处理程序.mcp.json插件根MCP server 配置.1sp.json插件根用于代码智能的LSP server 配置settings.json插件根启用插件时应用的默认设置3.6.3 创建你的第一个插件你已成功创建并测试了一个包含以下关键组件的插件:插件清单(.claude-plugin/plugin.json):描述你的插件的元数据Skills目录(skf11s/):包含你的自定义skillsSkill参数($ARGUMENTS):捕获用户输入以实现动态行为3.6.4 开发更复杂的插件一旦你对基本插件感到满意你可以创建更复杂的扩展。向你的插件添加Skills插件可以包含 Agent Skills 以扩展Claude 的功能。Skills 是模型调用的:Claude 根据任务上下文自动使用它们。在你的插件根目录添加一个ski11s/目录其中包含包含 SKILL.md 文件的Skill文件夹my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单必需 ├── skills/ # Skills └── code-review └── Skill.md每个 SKILL.md 需要包含 name 和 description 字段的frontmatter,后跟说明关于Skill的编写在之前的文章中有详细的说明有兴趣可以参考。3.7 自定义插件开发接下来演示如何创建一个自定义的插件3.7.1 输入提示词生成插件不需要从0到1 自己完全写直接让Claude Code 帮我们创建然后基于它创建的插件进行完善即可给出下面的提示词帮我创建一个代码审查播件包含 skill、agent 和MCP server。输入提示词后Claude Code 开始构建插件通过输出日志可以发现整个过程是按照计划推进最终完成了插件的开发打开之后在插件目录中创建了skills的子目录3.7.2 安装新插件通过自然语言安装本次新插件将当前目录下的code-review-plugin 进行安装然后等待其安装完成即可通过/plugins命令可以看到已经成功加载后续就可以在本地使用这个自定义开发的插件了3.7.3 调试插件中的问题如果你的插件不按预期工作:检查结构:确保你的目录在插件根目录而不是在.claude-plugin/内单独测试组件:分别检查每个命令、agent和hook使用验证和调试工具:有关CLI命令和故障排除技术3.7.4 共享你的插件当你的插件准备好共享时:添加文档:包含一个 README.md其中包含安装和使用说明版本化你的插件:在你的 plugin.json 中使用语义版本控制创建或使用市场:通过插件市场分发以供安装与他人测试:在更广泛分发之前让团队成员测试插件一旦你的插件发布到了插件市场中其他人可以使用发现和安装插件中的说明安装它。3.7.5 向官方市场提供你的插件如果觉得自己的插件不错能够让更多人用起来可以提供给官方要向官方Anthropic市场提交插件请使用以下应用内提交表单之一Claude.aiApp unavailable in region | Claude by AnthropicApp unavailable in region | Claude by Anthropic四、写在文末本文通过较大的篇幅详细介绍了Claude Code 中插件的使用并通过案例演示了如何使用官方插件三方插件以及自定义开发插件的过程希望对看到的同学有用本篇到此结束感谢观看。
【AI智能体】Claude Code 插件从使用到项目实战详解
目录一、前言二、Claude Code 插件介绍2.1 Claude Code 插件是什么2.2 Claude Code 插件核心组成2.3 插件能做什么2.4 工作原理与生命周期2.5 插件配置方式2.6 插件的最小结构三、Claude Code 插件使用3.1 插件管理常用命令3.2 插件安装3.2.1 进入官方插件市场3.2.2 执行插件安装3.2.3 插件检查3.2.4 插件加载3.2.5 插件使用3.3 代码智能插件安装使用3.3.1 智能代码插件安装3.3.2 智能代码插件使用3.3.3 外部集成工具3.4 整合Codex 插件使用3.4.1 添加插件市场3.4.2 安装Codex 插件3.4.3 使用 Codex 生态下的插件3.5 插件管理3.5.1 添加插件市场3.4.2 管理插件3.4.3 应用插件更改而不重启3.4.4 管理市场3.4.5 配置团队市场3.4.6 安全性说明3.5 插件安装失败问题处理3.5.1 /plugin命令无法识别3.5.2 其他常见问题3.6 自定义插件前置准备3.6.1 何时使用插件与独立配置3.6.2 插件的最小结构3.6.3 创建你的第一个插件3.6.4 开发更复杂的插件3.7 自定义插件开发3.7.1 输入提示词生成插件3.7.2 安装新插件3.7.3 调试插件中的问题3.7.4 共享你的插件3.7.5 向官方市场提供你的插件四、写在文末一、前言今年最火热的大模型当属Claude Code了除了AI编程带来的令人惊讶的高效还能完成各类复杂的任务同时其生态也在持续扩大自己版图比如配套的Skills技能市场插件市场以及与其他社区进行深度联动融合都为Claude Code带来了极高的热度本篇接下来将详细介绍Claude Code中一个非常重要且实用的功能即Claude Code插件。二、Claude Code 插件介绍2.1 Claude Code 插件是什么Claude Code 插件系统将 Claude Code 从一个基础的 AI 编程助手升级为了一个可高度定制、能不断适应个人或团队工作流的开发平台。它的核心价值在于通过模块化的方式让开发者能轻松地扩展、分享和复用各种功能从而提升编码和协作效率。官方插件地址Plugins for Claude | Claude by Anthropic2.2 Claude Code 插件核心组成一个完整的 Claude Code 插件可以包含以下一个或多个核心组件类似于“功能增强包”插件 一组可复用的 Claude Code 扩展能力集合一个插件可以包含斜杠命令Slash Commands子代理AgentsSkills能力说明Hooks事件钩子MCP 服务器外部工具/服务LSP 服务器代码智能插件的核心目标只有一个让 Claude Code 能力像工具箱一样被复用而不是每个项目重复配置2.3 插件能做什么插件系统让 Claude Code 的应用场景变得非常广泛团队协作与知识传承可以为复杂的代码模块创建专属“领域专家”子代理帮助新成员快速上手实现团队知识的沉淀。标准化开发流程将包含复杂环境准备和启动命令的流程封装成插件团队成员只需一个简单的斜杠命令如/run-pipeline即可标准化执行。个人效率工具链开发者可以将自己常用的工具、脚本打包成个人插件在不同电脑或项目中快速恢复熟悉的开发环境。2.4 工作原理与生命周期插件的运作遵循一套标准流程保证了其稳定性和可移植性定义插件通过根目录下的plugin.json清单文件定义自身结构、元数据和组件位置。发现Claude Code启动时会自动扫描并加载已安装插件目录下的组件。集成加载的组件会无缝集成到工作环境中斜杠命令、子代理等即可像内置功能一样被调用。便携性插件内部通过${CLAUDE_PLUGIN_ROOT}等环境变量引用路径确保了在不同操作系统和安装位置下都能正常工作。2.5 插件配置方式Claude Code 支持两种扩展方式方式命令形式适合场景独立配置.claude//hello个人使用、单项目、快速实验插件.claude-plugin//plugin-name:hello团队共享、跨项目、版本化什么时候用独立配置只在当前项目使用个人工作流尚未稳定的实验性配置想要简短命令名如/review什么时候用插件要在多个项目复用要分享给团队或社区需要版本控制、升级、回滚计划通过市场分发可以接受命名空间命令避免冲突最佳实践先在.claude/中迭代 → 稳定后打包为插件2.6 插件的最小结构在开发Claude Code 插件时需要按照一定的结构规范下面是插件的最小结构形式my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单必需 ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置重要规则说明.claude-plugin/目录中只能放plugin.json其他目录必须在插件根目录三、Claude Code 插件使用接下来通过实际案例操作演示下Claude Code 插件的使用3.1 插件管理常用命令为了方便接下来对插件的学习和使用下面列举了Claude Code的插件相关的常用命令/plugin # 打开插件管理器 /plugin install # 安装插件 /plugin uninstall # 卸载 /plugin enable/disable # 启用 / 禁用 /plugin marketplace add # 添加市场 /plugin marketplace rm # 移除市场3.2 插件安装可以从插件市场发现和安装插件以使用新命令、代理和功能扩展 Claude Code插件通过 skills、agents、hooks 和MCP servers 扩展Claude Code插件市场是帮助您发现和安装这些扩展的目录无需自己构建3.2.1 进入官方插件市场官方插件市场 Plugins for Claude | Claude by Anthropic进入官方插件市场可以看到提供了很多插件官方插件市场(claude-plugins-official)在您启动 Claude Code 时自动可用。运行 /plugin 并转到发现选项卡以浏览可用内容要从官方市场安装插件请使用 /plugininstallnameclaude-plugins-official。例如要安装GitHub集成在打开Claude Code 命令行窗口后只需要输入下面这段命令即可/plugin install githubclaude-plugins-official插件名字从哪里来的呢以下面这个插件为例点击这个插件进去点击右侧的复制按钮将会得到一串安装插件的命令claude plugin install code-reviewclaude-plugins-official3.2.2 执行插件安装添加官方插件市场这一步必须要做相当于是告诉Claude Code 你要从哪里安装插件后面还会从很多插件市场添加插件/plugin marketplace add anthropics/claude-code这行命令把 Anthropic 官方的插件市场注册到你的 Claude Code 里。anthropics/claude-code是 GitHub 上的仓库地址Claude Code 会从这里读取可用的插件列表。默认情况下通过 /plugins 可以进入到插件页面输入上面的命令点击安装看到下面的效果说明就安装成功了3.2.3 插件检查然后可以输入 /plugin 命令检查一下可以看到在下面的页面有多个tab页面比如当你把上面的插件市场添加进去之后插件市场就可以展示出相关的插件在这里可以直接搜索相关插件进行过滤比如搜索前端设计的插件选中之后直接安装在这里操作就更方便了3.2.4 插件加载插件安装完成后需要执行下面这个加载命令才能显示出上面安装的插件稍作等待后就可以展示出已安装的插件当然也可以通过 /plugin 进入检查进去之后在已安装的那个TAB页可以看到3.2.5 插件使用基于上面安装的code-review 插件对我们项目中的某段代码进行review在项目中打开Claude Code 终端然后输入下面的提示词基于/code-review 这个插件对FeeComplexRuleController这个类中的addFeeComplexRule这个接口进行代码review等待一会之后Claude Code 调用该插件最终完成了对我指定接口代码的review并给出了详细的review分析结论3.3 代码智能插件安装使用代码智能插件启用Claude Code的内置LSP工具使Claude能够跳转到定义、查找引用并在编辑后立即查看类型错误。这些插件配置语言服务器协议连接这是为 VSCode代码智能提供支持的相同技术。这些插件需要在您的系统上安装语言服务器二进制文件。如果你已经安装了语言服务器当您打开项目时Claude可能会提示您安装相应的插件。3.3.1 智能代码插件安装在官方插件市场搜索 lsp 可以看到有不同编程语言的lsp插件参考上面的方式在终端窗口中执行下面的命令完成安装这里我选择Java的lsp/plugin install jdtls-lspclaude-plugins-official或者拷贝官方的安装命令claude plugin install jdtls-lspclaude-plugins-official3.3.2 智能代码插件使用加载成功后让AI编写一段代码然后基于这个插件对代码做类型检查使用java语言编写一个冒泡排序并基于jdtls-lsp插件做类型检查可以看到整个过程是按照预期的流程进行的3.3.3 外部集成工具有一些插件还捆绑了预配置的 MCP Servers以便开发者可以连接Claude到外部服务无需手动设置比如下面这些源代码控制github、gitlab项目管理atlassian (Jira/Confluence) asana、 linear、notion设计figma基础设施vercel、firebase、supabase通信slack监控sentry比如当你安装了figma插件之后就可以直接基于使用figma开发的原型设计稿直接进行编码开发了在官方插件中有详细的说明3.4 整合Codex 插件使用对于已经在使用Claude Code的开发者这个插件提供了一个低成本的Codex试用入口。而对OpenAI而言这是在竞争对手的地盘上建立存在感的一次聪明尝试。对开发者来说也可以在不同的AI工具直接快速切换。下面具体介绍下使用过程。3.4.1 添加插件市场进入到codex-cc的gitGitHub - openai/codex-plugin-cc: Use Codex from Claude Code to review code or delegate tasks. · GitHub在Claude Code 命令行窗口执行第一条命令进行插件市场添加/plugin marketplace add openai/codex-plugin-cc3.4.2 安装Codex 插件执行第二条安装Codex 插件命令安装完成后记得重新加载3.4.3 使用 Codex 生态下的插件上一步装完之后此时就能看到接下去就能执行codex的像个命令了执行这个命令后看到下面的输出说明就可以开始使用Codex 生态下的相关插件了3.5 插件管理3.5.1 添加插件市场使用 /plugin marketplace add 命令从不同来源添加市场不同的市场都有自己特定的插件这样都可以加载进去使用GitHub 存储库owner/repo 格式(例如,anthropics/claude-code)Git URL任何git 存储库 URL(GitLab、Bitbucket、自托管)本地路径目录或marketplace.json 文件的直接路径远程URL托管marketplace.json 文件的直接URL1从GitHub 添加使用 owner/repo 格式添加包含.claude-plugin/marketplace.json 文件的GitHub存储库其中owner 是GitHub用户名或组织,repo 是存储库名称。例如,anthropics/claude-code 指的是由 anthropics 拥有的 claude-code 存储库/plugin marketplace add anthropics/claude-code2从其他Git主机添加通过提供完整URL添加任何git 存储库。这适用于任何Git 主机包括GitLab、Bitbucket 和自托管服务器:使用HTTPS:/plugin marketplace add https://gitlab.com/company/plugins.git如果要添加特定分支的或者特定标签的请在#后附加ref/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.03使用SSH添加/plugin marketplace add gitgitlab.com:company/plugins.git4从本地路径添加添加包含.claude-plugin/marketplace.json 文件的本地目录/plugin marketplace add ./my-marketplace也可以添加 marketplace.json 文件的直接路径/plugin marketplace add ./path/to/marketplace.json5从远程URL添加通过URl添加远程 marketplace.json 文件/plugin marketplace add https://example.com/marketplace.json3.4.2 管理插件运行 /plugin 并转到已安装选项卡以查看、启用、禁用或卸载您的插件。键入以按插件名称或描述筛选列表。您也可以使用直接命令管理插件。禁用插件而不卸载/plugin disable plugin-namemarketplace-name重新启用已禁用的插件/plugin enable plugin-namemarketplace-name完全删除插件/plugin uninstall plugin-namemarketplace-name-- scope 选项允许您使用CLI命令针对特定范围claude plugin install formatteryour-org --scope project claude plugin uninstall formatteryour-org --scope project3.4.3 应用插件更改而不重启当你在会话期间安装启用或禁用插件时运行/reload-plugins 以在不重启的情况下获取所有更改:Claude Code重新加载所有活跃插件并显示重新加载的命令、skills、agents、hooks、插件MCPservers和插件LSP servers 的计数。3.4.4 管理市场您可以通过交互式/plugin 界面或CLI命令管理市场。1使用交互式界面运行 /plugin 并转到市场选项卡以查看所有已添加的市场及其来源和状态添加新市场更新市场列表以获取最新插件删除您不再需要的市场2使用CLI命令也可以使用直接命令管理市场。列出所有配置的市场。刷新市场的插件列表:/plugin marketplace update marketplace-name3删除插件市场/plugin marketplace remove marketplace-name3.4.5 配置团队市场团队管理员可以通过将市场配置添加到.claude/settings.json来为项目设置自动市场安装。当团队成员信任存储库文件夹时Claude Code会提示他们安装这些市场和插件。将 extraKnownMarketplaces 添加到您项目的.claude/settings.json 有关完整配置选项(包括 extraKnownMarketplaces 和 enabledPlugins){ extraknownMarketplaces:{ my-team-tools: { source: { source:github, repo: your-org/claude-plugins } } } }3.4.6 安全性说明插件和市场是高度受信任的组件可以使用您的用户权限在您的机器上执行任意代码。仅从您信任的来源安装插件和添加市场。组织可以使用托管市场限制限制用户允许添加的市场。3.5 插件安装失败问题处理在安装插件过程中可能会遇到各种错误下面介绍几种。3.5.1 /plugin命令无法识别如果看到”未知命令”或/plugin命令未出现:检查您的版本:运行claude --version 以查看安装的内容。更新 Claude CodeHomebrew: brew upgrade claude-codenpm: npm update -g anthropic-ai/claude-code本地安装程序从设置重新运行安装命令重启 Claude Code更新后重启您的终端并再次运行claude。3.5.2 其他常见问题市场未加载验证 URL是否可访问以及.claude-plugin/marketplace.json 是否存在于该路径插件安装失败检查插件源URL是否可访问以及存储库是否公开(或您有访问权限)安装后找不到文件插件被复制到缓存因此引用插件目录外文件的路径将不起作用插件 skills 未出现使用 rm -rf ~/.claude/plugins/cache 清除缓存,重 Claude Code,然后重新安装插件。3.6 自定义插件前置准备上面分享的是如何在Claude Code中使用外部或其他三方插件也支持在Claude Code 中自己创建插件。创建自定义插件以使用 skills、agents、hooks 和 MCP servers 扩展Claude Code。Plugins 让你能够使用自定义功能扩展Claude Code这些功能可以在项目和团队中共享。本指南涵盖如何使用 skills、agents、hooks和MCP servers 创建自己的插件。3.6.1 何时使用插件与独立配置Claude Code支持两种方式来添加自定义 skills、agents和 hooks方法Skill 名称适合场景独立(.claude/目录)/hello个人工作流、项目特定的自定义、快速实验插件(包含.claude-plugin/plugin.json的目录/plugin-name:hello与团队成员共享、分发到社区、版本化发布、跨项目重用在以下情况下使用独立配置你正在为单个项目自定义Claude Code配置是个人的不需要共享你在打包skills或hooks之前进行实验你想要简短的skill名称如 /hello 或/deploy在以下情况下使用插件:你想与团队或社区共享功能你需要在多个项目中使用相同的skills/agents你想要版本控制和轻松更新扩展你通过市场分发你可以接受命名空间化的skills,如/my-plugin:hel1o(命名空间可防止插件之间的冲突)3.6.2 插件的最小结构在开发Claude Code 插件时需要按照一定的结构规范下面是插件的最小结构形式my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单必需 ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置插件结构概览你已创建了一个带有skill的插件但插件可以包含更多内容:自定义agents、hooks、MCP servers和LSP servers目录位置目的.claude-plugin/插件根包含plugin.json清单(如果组件使用默认位置则可选)commands/插件根作为Markdown文件的 Skillsagents/插件根自定义agent定义skills/插件根带有 skIL.md文件的Agent Skillshooks/插件根hooks.json中的事件处理程序.mcp.json插件根MCP server 配置.1sp.json插件根用于代码智能的LSP server 配置settings.json插件根启用插件时应用的默认设置3.6.3 创建你的第一个插件你已成功创建并测试了一个包含以下关键组件的插件:插件清单(.claude-plugin/plugin.json):描述你的插件的元数据Skills目录(skf11s/):包含你的自定义skillsSkill参数($ARGUMENTS):捕获用户输入以实现动态行为3.6.4 开发更复杂的插件一旦你对基本插件感到满意你可以创建更复杂的扩展。向你的插件添加Skills插件可以包含 Agent Skills 以扩展Claude 的功能。Skills 是模型调用的:Claude 根据任务上下文自动使用它们。在你的插件根目录添加一个ski11s/目录其中包含包含 SKILL.md 文件的Skill文件夹my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单必需 ├── skills/ # Skills └── code-review └── Skill.md每个 SKILL.md 需要包含 name 和 description 字段的frontmatter,后跟说明关于Skill的编写在之前的文章中有详细的说明有兴趣可以参考。3.7 自定义插件开发接下来演示如何创建一个自定义的插件3.7.1 输入提示词生成插件不需要从0到1 自己完全写直接让Claude Code 帮我们创建然后基于它创建的插件进行完善即可给出下面的提示词帮我创建一个代码审查播件包含 skill、agent 和MCP server。输入提示词后Claude Code 开始构建插件通过输出日志可以发现整个过程是按照计划推进最终完成了插件的开发打开之后在插件目录中创建了skills的子目录3.7.2 安装新插件通过自然语言安装本次新插件将当前目录下的code-review-plugin 进行安装然后等待其安装完成即可通过/plugins命令可以看到已经成功加载后续就可以在本地使用这个自定义开发的插件了3.7.3 调试插件中的问题如果你的插件不按预期工作:检查结构:确保你的目录在插件根目录而不是在.claude-plugin/内单独测试组件:分别检查每个命令、agent和hook使用验证和调试工具:有关CLI命令和故障排除技术3.7.4 共享你的插件当你的插件准备好共享时:添加文档:包含一个 README.md其中包含安装和使用说明版本化你的插件:在你的 plugin.json 中使用语义版本控制创建或使用市场:通过插件市场分发以供安装与他人测试:在更广泛分发之前让团队成员测试插件一旦你的插件发布到了插件市场中其他人可以使用发现和安装插件中的说明安装它。3.7.5 向官方市场提供你的插件如果觉得自己的插件不错能够让更多人用起来可以提供给官方要向官方Anthropic市场提交插件请使用以下应用内提交表单之一Claude.aiApp unavailable in region | Claude by AnthropicApp unavailable in region | Claude by Anthropic四、写在文末本文通过较大的篇幅详细介绍了Claude Code 中插件的使用并通过案例演示了如何使用官方插件三方插件以及自定义开发插件的过程希望对看到的同学有用本篇到此结束感谢观看。
