通过市场发现和安装预构建插件

市场是他人创建和共享的插件目录。使用市场是一个两步过程：

1. 添加市场：这会向 Claude Code 注册目录，以便可以浏览可用内容。尚未安装任何插件
2. 安装单个插件：浏览目录并安装您想要的插件

可以将其视为添加应用商店：添加商店让可以访问浏览其集合，但仍然需要单独选择要下载的应用

官方 Anthropic 市场 claude-plugins-official 在启动 Claude Code 时自动可用。运行 /plugin 并转到发现选项卡以浏览可用内容，或在 claude.com/plugins 查看目录

要从官方市场安装插件，请使用 /plugin install <name>@claude-plugins-official 。例如，要安装 GitHub 集成：

/plugin install github@claude-plugins-official

如果 Claude Code 报告在任何市场中找不到该插件，则市场要么缺失，要么已过期。运行 /plugin marketplace update claude-plugins-official 以刷新它，或如果之前未添加过，运行 /plugin marketplace add anthropics/claude-plugins-official 。然后重试安装

官方市场由 Anthropic 维护，包含由 Anthropic 自行决定的内容

应用内提交表单将插件添加到社区市场，而不是官方市场

要独立分发插件，请创建您自己的市场并与用户共享

官方市场包括多个插件类别

anthropics/claude-plugins-community 上的社区市场托管已通过 Anthropic 自动验证和安全筛选的第三方插件。每个插件都固定到目录中的特定提交 SHA。与官方市场不同，需要手动添加它：

/plugin marketplace add anthropics/claude-plugins-community

然后使用 claude-community 市场名称从中安装插件：

/plugin install <plugin-name>@claude-community

要将您自己的插件提交到社区市场，请参阅创建插件指南中的将插件提交到社区市场

https://code.claude.com/docs/zh-CN/plugins#submit-your-plugin-to-the-community-marketplace

Anthropic 还维护一个 演示插件市场 claude-code-plugins ，其中包含展示插件系统可能性的示例插件。与官方市场不同，需要手动添加此市场

1. 添加市场：在 Claude Code 中，为 anthropics/claude-code 市场运行 plugin marketplace add 命令：

   /plugin marketplace add anthropics/claude-code
   

   这会下载市场目录并使其插件对您可用

2. 浏览可用插件：运行 /plugin 打开插件管理器。这会打开一个选项卡式界面，有四个选项卡，可以使用 Tab 循环切换（或使用 Shift+Tab 向后切换）：
   • 发现：从所有市场浏览可用插件
   • 已安装：查看和管理已安装的插件
   • 市场：添加、删除或更新已添加的市场

   • 错误：查看任何插件加载错误 转到 发现 选项卡以查看刚添加的市场中的插件

     当管理员通过 pluginSuggestionMarketplaces 托管设置将市场列入允许列表时
     
     标记为与当前工作目录相关的插件会在顶部固定，并带有建议用于此目录标签
     

3. 安装插件，选择一个插件以查看其详细信息。详细信息窗格显示插件包含的内容及其成本：
   • 上下文成本估计，因此可以查看插件将在每个回合中向您的上下文窗口添加多少个令牌（Claude Code v2.1.143 及更高版本）
   • 插件的最后更新日期（v2.1.144 及更高版本）
   • 一个将安装部分，列出插件的命令、agents、skills、hooks 和 MCP 及 LSP 服务器，因此可以在安装前查看它添加的确切内容（v2.1.145 及更高版本） 选择安装范围：
     • 用户范围：在所有项目中为自己安装
     • 项目范围：为此存储库上的所有协作者安装

     • 本地范围：仅在此存储库中为自己安装

       例如，选择 commit-commands（添加 git 工作流 skills 的插件）并将其安装到您的用户范围
       

       也可以从命令行直接安装：

       /plugin install commit-commands@claude-code-plugins
       

       请参阅配置范围以了解有关范围的更多信息
       
       https://code.claude.com/docs/zh-CN/settings#configuration-scopes
       

4. 使用您的新插件，安装后，运行 /reload-plugins 以激活插件
   • 插件 skills 由插件名称命名空间，因此 commit-commands 提供诸如 /commit-commands:commit 之类的 skills

   • 通过对文件进行更改并运行来尝试：

     /commit-commands:commit
     

     这会暂存您的更改、生成提交消息并创建提交
     

     每个插件的工作方式不同。检查 发现 选项卡中的插件详细信息以查看它提供的命令和 skills，或访问其主页以获取使用指导

每个插件的工作方式不同。检查发现选项卡中的插件详细信息以查看它提供的命令和 skills，或访问其主页以获取使用指导

使用 /plugin marketplace add 命令从不同来源添加市场：

• GitHub 存储库：owner/repo 格式

  例如 anthropics/claude-code
  

• Git URL：任何 git 存储库 URL，包括 GitLab、Bitbucket 和自托管服务器
• 本地路径：目录或 marketplace.json 文件的直接路径
• 远程 URL：托管 marketplace.json 文件的直接 URL

快捷方式：可以使用 /plugin market 代替 /plugin marketplace，以及使用 rm 代替 remove

添加市场后，可以直接安装插件：

/plugin install plugin-name@marketplace-name

该命令打开该插件的详情，可以在其中选择安装范围。运行 /plugin，转到 发现 选项卡，然后在插件上按 Enter 时，会看到相同的选择：

• 用户范围（默认）：在所有项目中为自己安装
• 项目范围：为此存储库上的所有协作者安装，这会将插件添加到 .claude/settings.json
• 本地范围：仅在此存储库中为自己安装，不与协作者共享

也可能看到具有托管范围的插件。这些由管理员通过托管设置安装，无法修改

要在没有交互式步骤的情况下安装，请使用 claude plugin install shell 命令，该命令默认安装到用户范围，除非传递 –scope

在安装插件之前，请确保信任该插件

Anthropic 不控制插件中包含的 MCP servers、文件或其他软件，也无法验证它们是否按预期工作

检查每个插件的主页以获取更多信息

运行 /plugin 并转到已安装选项卡以 查看 、 启用 、 禁用 或 卸载 插件。该列表按范围分组并排序，以便首先看到问题：具有加载错误或未解决依赖项的插件出现在顶部，然后是收藏夹，禁用的插件折叠在底部的折叠标题后面。从列表中可以：

• 按 f 以收藏或取消收藏选定的插件
• 输入以按插件名称或描述筛选
• 按 Enter 打开插件的详细视图并启用、禁用或卸载它

卸载项目的 .claude/settings.json 启用的插件会询问指的是哪个范围：

• 仅为您禁用它，这会将覆盖写入 .claude/settings.local.json 并为项目保留已安装的插件

• 为所有人卸载它，这会将其从共享的 .claude/settings.json 中删除

  需要 Claude Code v2.1.203 或更高版本。在 v2.1.203 之前，对话框仅提供本地禁用选项
  

详细视图 显示插件贡献的组件：commands、skills、agents、hooks、MCP servers 和 LSP servers。相同的清单也可以从命令行通过 claude plugin details 获得

已安装选项卡 还收集您自己安装但至少两周内未使用过的市场插件，跨越至少 10 个会话，在 最近未使用 标题下。详细视图为每个插件显示一条最后使用行。使用这些来查找您不再使用但仍在增加启动和上下文成本的插件，然后禁用或卸载它们

需要 Claude Code v2.1.187 或更高版本

两种类型的插件永远不会被列为未使用：

• 您的组织管理的插件或您使用 –plugin-dir 加载的插件
• 贡献主题、输出样式、监视器或工作流的插件，因为这些提供的价值无需跟踪调用

当您的组织使用 strictKnownMarketplaces 限制市场时，最近未使用标题和最后使用行都被隐藏

插件的 语言服务器 在提供诊断或回答代码导航请求时被计为已使用，因此其服务器在会话中处于活跃状态的 LSP 插件不会被列为未使用

在 v2.1.203 之前，无法计算语言服务器活动作为使用，因此贡献 LSP 服务器的插件完全免除

与主题和输出样式插件仍然相同的方式

在计算语言服务器活动的版本的第一个会话中，还会重置每个尚未记录任何使用的 LSP 插件的使用记录，因此 Claude Code 不会根据在其服务器活动被跟踪之前记录的数据将您之前安装的插件判断为未使用

在 v2.1.206 之前，该第一个会话可能会在最近未使用下列出一个活跃使用的 LSP 插件并建议审查它

当安装声明依赖项的插件时，安装输出会列出哪些依赖项与其一起自动安装

可以通过交互式 /plugin 界面或 CLI 命令管理市场

略

插件和市场是高度受信任的组件，可以使用用户权限在机器上执行任意代码

仅从信任的来源安装插件和添加市场

组织可以使用托管市场限制限制用户允许添加的市场