插件概览

插件是什么、何时需要它、如何从市场获取、安装范围，以及官方市场与第三方市场的区别。

Claude Code 插件是一个包含 Skill、智能体、Hooks、MCP 服务器或其他组件的目录，Claude Code 把它作为一个单元安装和加载。大多数插件来自市场（marketplace）：一个列出插件及其获取位置的目录。你也可以从别人给你的文件夹加载插件，或者自己构建。

想马上试试，在 Claude Code 终端会话里运行 /plugin，从 Discover 标签页安装一个：它列出 Anthropic 官方市场以及你添加的任何市场里的插件。

插件是什么

插件是一个组件目录，通常带一份清单。清单是 .claude-plugin/plugin.json 这个 JSON 文件，给插件命名，还可以加版本、描述等元数据。组件是插件为 Claude Code 添加的东西，例如：

Skills：Claude 在相关时加载的 SKILL.md 指令，你也可以当作命令运行
Agents：Claude 可以委派的子智能体定义
Hooks：Claude Code 在生命周期节点（如每次编辑之后）运行的命令
MCP servers：插件启用期间 Claude Code 连接的工具服务器

你是否需要插件

Skill、子智能体、Hook 和 MCP 服务器都可以不借助插件独立工作。比如保存在 ~/.claude/skills/ 的 Skill 在你机器上的每个项目里都可用。

当你想把多个 Skill、子智能体、Hook 或 MCP 服务器打包成一个单元时，使用插件。安装插件可以一条命令得到别人搭好的配置，并从其市场获得更新；自己做插件则可以把你的配置交给队友、安装到很多项目里、或发布带版本的发布物。

启用的插件会给你的会话带来什么

启用的插件是每个会话的一部分，而不只是你用到它的那些会话。安装之前值得知道几个后果：

上下文和用量：对 Claude 可以自行调用的每个 Skill、智能体和命令，它们的名字和描述每一回合都在 Claude 的上下文里，这些 token 计入你的用量，并减少上下文窗口的可用空间
进程：插件定义的 MCP 服务器会在启用它的每个会话旁运行，它的 Hook 在各自事件触发
权限：插件运行的东西，是以你的身份运行的。安装前先看「插件安全与信任」

查看插件占用：安装前，在 /plugin 的 Marketplaces 标签页打开插件，Anthropic 官方市场的插件会显示 Context cost 估算；安装后，Installed 标签页的 Not used recently 分组会列出你可以关掉的插件；想停用而不卸载，用 /plugin 禁用，或在 shell 里运行 claude plugin disable。

从市场获取插件

市场是一个带 .claude-plugin/marketplace.json 文件的仓库或目录，列出插件及各自的获取位置。它是目录，不是托管商店。你只需添加一次市场，然后按名字从中安装插件，如 commit-commands@claude-plugins-official。

插件市场不同于 Claude Marketplace。后者是 claude.com/marketplace 这个浏览插件、连接器和合作伙伴产品的网站，不是你能用 /plugin marketplace add 添加的市场。

Claude Code 在你首次启动交互式终端会话时会添加 Anthropic 官方市场（除非托管策略阻止），不会自行添加任何其他市场，包括 Anthropic 的社区市场和演示市场。开发插件时不需要市场：用 --plugin-dir 直接从文件夹加载。

已安装的插件要在会话里可用，需要在每一层都就位：设置（列出你添加的市场和启用的插件）、磁盘（~/.claude/plugins/ 存放 Claude Code 获取并安装的内容）、会话（插件在启动时加载，或在你重新加载插件时加载）。

区分 Anthropic 的市场和第三方市场

市场的名字决定它属于三个层级之一。只有来自 github.com/anthropics/ 仓库的市场才能使用官方和社区名称：

官方：用 Anthropic 官方市场名的市场，包括 claude-plugins-official 和演示市场 claude-code-plugins
社区：用 Anthropic 社区名的市场，如 claude-community
第三方：其他所有市场；你同事或你组织发布的市场也属于第三方

无论哪个层级，你安装的插件都能以你的用户权限运行代码，安装前要先审查。组织可以通过托管设置对市场做允许列表或封锁、强制安装插件，并关闭仅会话加载。

安装范围

安装插件时要选一个范围，范围决定了插件对谁启用：

用户范围：对你在这台电脑上的每个项目启用
项目范围：通过提交进仓库的 .claude/settings.json 对在该仓库工作的所有人启用；每位协作者仍需在自己的机器上安装
本地范围：只对你在这个仓库里启用

在终端、桌面应用的本地会话或 VS Code 扩展里按用户范围安装的插件，在这台电脑上的另外两处也可用，因为三者读取同样的设置文件。云端会话（包括 claude.ai/code 里的浏览器会话）不会加载你本地设置里的插件。

下一步

多数人从安装 Anthropic 官方市场的插件开始：在终端会话运行 /plugin 浏览。要构建自己的插件，官方的「Create a plugin」从空目录开始，到一个可用插件结束。之后还有：发布和分发插件、用 eval 测试插件、衡量插件成本和用量、为团队运行市场、为组织设定插件策略以及插件排障，见官方文档的 Plugins 一节。