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

插件通过 skills、agents、hooks 和 MCP servers 扩展 Claude Code。插件市场是帮助您发现和安装这些扩展的目录，无需自己构建。想要创建和分发自己的市场？请参阅创建和分发插件市场。

市场如何工作

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

添加市场

这会向 Claude Code 注册目录，以便您可以浏览可用内容。尚未安装任何插件。

安装单个插件

浏览目录并安装您想要的插件。

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

官方 Anthropic 市场

官方 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 自行决定的内容。应用内提交表单将插件添加到社区市场，而不是官方市场。要独立分发插件，请创建您自己的市场并与用户共享。

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

代码智能

代码智能插件启用 Claude Code 的内置 LSP 工具，使 Claude 能够跳转到定义、查找引用并在编辑后立即查看类型错误。这些插件配置语言服务器协议连接，这是为 VS Code 代码智能提供支持的相同技术。这些插件需要在您的系统上安装语言服务器二进制文件。如果您已经安装了语言服务器，当您打开项目时，Claude 可能会提示您安装相应的插件。

语言	插件	所需二进制文件
C/C++	`clangd-lsp`	`clangd`
C#	`csharp-lsp`	`csharp-ls`
Go	`gopls-lsp`	`gopls`
Java	`jdtls-lsp`	`jdtls`
Kotlin	`kotlin-lsp`	`kotlin-language-server`
Lua	`lua-lsp`	`lua-language-server`
PHP	`php-lsp`	`intelephense`
Python	`pyright-lsp`	`pyright-langserver`
Rust	`rust-analyzer-lsp`	`rust-analyzer`
Swift	`swift-lsp`	`sourcekit-lsp`
TypeScript	`typescript-lsp`	`typescript-language-server`

您也可以为其他语言创建自己的 LSP 插件。

如果在安装插件后在 /plugin 错误选项卡中看到 Executable not found in $PATH，请从上表安装所需的二进制文件。

Claude 从代码智能插件获得的功能

安装代码智能插件并且其语言服务器二进制文件可用后，Claude 获得两项功能：

自动诊断：在 Claude 进行的每次文件编辑后，语言服务器分析更改并自动报告错误和警告。Claude 看到类型错误、缺失导入和语法问题，无需运行编译器或 linter。如果 Claude 引入错误，它会注意到并在同一轮中修复问题。这不需要除安装插件外的任何配置。当”发现诊断”指示器出现时，您可以按 Ctrl+O 来内联查看诊断。
代码导航：Claude 可以使用语言服务器跳转到定义、查找引用、获取悬停时的类型信息、列出符号、查找实现和追踪调用层次结构。这些操作为 Claude 提供比基于 grep 的搜索更精确的导航，尽管可用性可能因语言和环境而异。

如果遇到问题，请参阅代码智能故障排除。

外部集成

这些插件捆绑预配置的 MCP servers，以便您可以连接 Claude 到外部服务，无需手动设置：

源代码控制：github、gitlab
项目管理：atlassian（Jira/Confluence）、asana、linear、notion
设计：figma
基础设施：vercel、firebase、supabase
通信：slack
监控：sentry

自动安全审查

security-guidance 插件审查 Claude 所做的每项更改是否存在常见漏洞，并指示 Claude 在同一会话中修复发现的问题。有关其检查内容以及如何添加特定于项目的规则，请参阅在 Claude 编写代码时捕获安全问题。

开发工作流

为常见开发任务添加 skills 和 agents 的插件：

commit-commands：Git 提交工作流，包括提交、推送和 PR 创建
pr-review-toolkit：用于审查拉取请求的专门 agents
agent-sdk-dev：使用 Claude Agent SDK 构建的工具
plugin-dev：用于创建您自己的插件的工具包

输出样式

自定义 Claude 的响应方式：

explanatory-output-style：关于实现选择的教育见解
learning-output-style：用于技能构建的交互式学习模式

社区市场

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

/plugin marketplace add anthropics/claude-plugins-community

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

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

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

尝试：添加演示市场

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

添加市场

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

/plugin marketplace add anthropics/claude-code

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

浏览可用插件

运行 /plugin 打开插件管理器。这会打开一个选项卡式界面，有四个选项卡，您可以使用 Tab 循环切换（或使用 Shift+Tab 向后切换）：

发现：从所有市场浏览可用插件
已安装：查看和管理已安装的插件
市场：添加、删除或更新已添加的市场
错误：查看任何插件加载错误

转到发现选项卡以查看您刚添加的市场中的插件。当您的管理员通过 pluginSuggestionMarketplaces 托管设置将市场列入允许列表时，标记为与您当前工作目录相关的插件会在顶部固定，并带有建议用于此目录标签。

安装插件

选择一个插件以查看其详细信息。详细信息窗格显示插件包含的内容及其成本：

上下文成本估计，因此您可以查看插件将在每个回合中向您的上下文窗口添加多少个令牌（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

请参阅配置范围以了解有关范围的更多信息。

使用您的新插件

安装后，运行 /reload-plugins 以激活插件。插件 skills 由插件名称命名空间，因此 commit-commands 提供诸如 /commit-commands:commit 之类的 skills。通过对文件进行更改并运行来尝试：

/commit-commands:commit

这会暂存您的更改、生成提交消息并创建提交。每个插件的工作方式不同。检查发现选项卡中的插件详细信息以查看它提供的命令和 skills，或访问其主页以获取使用指导。

本指南的其余部分涵盖了添加市场、安装插件和管理配置的所有方式。

添加市场

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

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

GitHub 存储库：owner/repo 格式，例如 anthropics/claude-code
Git URL：任何 git 存储库 URL，包括 GitLab、Bitbucket 和自托管服务器
本地路径：目录或 marketplace.json 文件的直接路径
远程 URL：托管 marketplace.json 文件的直接 URL

从 GitHub 添加

使用 owner/repo 格式添加包含 .claude-plugin/marketplace.json 文件的 GitHub 存储库，其中 owner 是 GitHub 用户名或组织，repo 是存储库名称。例如，anthropics/claude-code 指的是由 anthropics 拥有的 claude-code 存储库：

/plugin marketplace add anthropics/claude-code

从其他 Git 主机添加

通过提供完整 URL 添加任何 git 存储库。这适用于任何 Git 主机，包括 GitLab、Bitbucket 和自托管服务器。包括 .git 后缀，以便 Claude Code 克隆存储库，而不是将 URL 视为托管 marketplace.json 文件的直接链接。同时包括 https:// 前缀。Claude Code v2.1.196 及更高版本会拒绝没有前缀的主机，例如 gitlab.com/company/plugins.git，将其视为无效的 GitHub owner/repo 简写，错误消息会告诉您添加前缀。早期版本会将其误读为 GitHub 存储库路径，并在克隆时失败。使用 HTTPS：

/plugin marketplace add https://gitlab.com/company/plugins.git

使用 SSH：

/plugin marketplace add git@gitlab.com:company/plugins.git

要添加特定分支或标签，请在 # 后附加 ref：

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

从本地路径添加

添加包含 .claude-plugin/marketplace.json 文件的本地目录：

/plugin marketplace add ./my-marketplace

您也可以添加 marketplace.json 文件的直接路径：

/plugin marketplace add ./path/to/marketplace.json

从远程 URL 添加

通过 URL 添加远程 marketplace.json 文件：

/plugin marketplace add https://example.com/marketplace.json

与基于 Git 的市场相比，基于 URL 的市场有一些限制。如果在安装插件时遇到”路径未找到”错误，请参阅故障排除。

安装插件

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

/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 服务器的插件完全免除，与主题和输出样式插件仍然相同的方式。当您安装声明依赖项的插件时，安装输出会列出哪些依赖项与其一起自动安装。您也可以使用直接命令管理插件。列出已安装的插件而不打开菜单：

/plugin list

传递 --enabled 或 --disabled 以仅显示处于该状态的插件。禁用插件而不卸载：

/plugin disable plugin-name@marketplace-name

重新启用已禁用的插件：

/plugin enable plugin-name@marketplace-name

在这些标识符中，plugin-name 是 marketplace entry 中插件的 name，它可能与插件自己的 plugin.json 中的 name 不同。从 Claude Code v2.1.195 开始，/plugin 界面中的启用和禁用适用于两个名称不同的插件，/plugin enable 和 /plugin disable 接受任一名称。当您在早期版本中禁用此类插件时，Claude Code 报告 already disabled 并将其保持启用状态。完全删除插件：

/plugin uninstall plugin-name@marketplace-name

--scope 选项允许您使用 CLI 命令针对特定范围：

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

应用插件更改而不重启

当您在会话期间安装、启用或禁用插件时，运行 /reload-plugins 以在不重启的情况下获取所有更改：

/reload-plugins

Claude Code 重新加载所有活跃插件，并显示插件、skills、agents、hooks、插件 MCP servers 和插件 LSP servers 的计数。重新加载在下一个请求时会产生令牌成本：新加载的组件在附加到对话的内容中宣布自己，而现有历史记录仍然从 prompt cache 读取。提供 MCP servers 的插件在其工具未被 tool search 延迟时成本更高：该更改使缓存失效，下一个请求重新读取整个对话。在这种情况下，/reload-plugins 显示警告并不应用重新加载；传递 --force 以强制应用。有关详细信息，请参阅启用或禁用插件。

管理市场

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

使用交互式界面

运行 /plugin 并转到市场选项卡以：

查看所有已添加的市场及其来源和状态
添加新市场
更新市场列表以获取最新插件
删除您不再需要的市场

使用 CLI 命令

您也可以使用直接命令管理市场。列出所有配置的市场：

/plugin marketplace list

刷新市场的插件列表：

/plugin marketplace update marketplace-name

删除市场：

/plugin marketplace remove marketplace-name

删除市场将卸载您从中安装的任何插件。

配置自动更新

Claude Code 可以在启动时自动更新市场及其已安装的插件。为市场启用自动更新后，Claude Code 会刷新市场数据并将已安装的插件更新到最新版本。如果任何插件已更新，您将看到提示您运行 /reload-plugins 的通知。通过 UI 为单个市场切换自动更新：

运行 /plugin 打开插件管理器
选择市场
从列表中选择市场
选择启用自动更新或禁用自动更新

官方 Anthropic 市场默认启用自动更新。第三方和本地开发市场默认禁用自动更新。管理员还可以在托管设置中的每个 extraKnownMarketplaces 条目上设置 "autoUpdate": true 以为组织市场启用自动更新，而无需每个用户都切换它。要完全禁用 Claude Code 和所有插件的所有自动更新，请设置 DISABLE_AUTOUPDATER 环境变量。有关详细信息，请参阅自动更新。要在禁用 Claude Code 自动更新的同时保持插件自动更新启用，请设置 FORCE_AUTOUPDATE_PLUGINS=1 以及 DISABLE_AUTOUPDATER：

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

当您想手动管理 Claude Code 更新但仍接收自动插件更新时，这很有用。

配置团队市场

团队管理员可以通过将市场配置添加到 .claude/settings.json 来为项目设置自动市场安装。当团队成员信任存储库文件夹时，Claude Code 会提示他们安装这些市场和插件。从 Claude Code v2.1.195 开始，此安装步骤适用于加载插件的每个路径。仅由项目的 .claude/settings.json 启用且来自外部源（如 GitHub 存储库或 npm 包）的插件在团队成员安装之前不会加载。在此之前，Claude Code 会将该插件报告为未安装，并显示要运行的 claude plugin install 命令。将 extraKnownMarketplaces 添加到您项目的 .claude/settings.json：

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

有关完整配置选项（包括 extraKnownMarketplaces 和 enabledPlugins），请参阅插件设置。

安全性

插件和市场是高度受信任的组件，可以使用您的用户权限在您的机器上执行任意代码。仅从您信任的来源安装插件和添加市场。组织可以使用托管市场限制限制用户允许添加的市场。

故障排除

/plugin 命令无法识别

如果您看到”未知命令”或 /plugin 命令未出现：

检查您的版本：运行 claude --version 以查看安装的内容。
更新 Claude Code：
- Homebrew：brew upgrade claude-code，或如果您安装了该 cask，则为 brew upgrade claude-code@latest
- npm：npm install -g @anthropic-ai/claude-code@latest
- 本地安装程序：从设置重新运行安装命令
重启 Claude Code：更新后，重启您的终端并再次运行 claude。

常见问题

市场未加载：验证 URL 是否可访问以及 .claude-plugin/marketplace.json 是否存在于该路径
插件安装失败：检查插件源 URL 是否可访问以及存储库是否公开，或您是否有访问权限
安装后找不到文件：插件被复制到缓存，因此引用插件目录外文件的路径将不起作用
插件 skills 未出现：使用 rm -rf ~/.claude/plugins/cache 清除缓存，重启 Claude Code，然后重新安装插件。

有关详细的故障排除和解决方案，请参阅市场指南中的故障排除。有关调试工具，请参阅调试和开发工具。

代码智能问题

语言服务器未启动：验证二进制文件已安装且在您的 $PATH 中可用。检查 /plugin 错误选项卡以获取详细信息。
高内存使用：rust-analyzer 和 pyright 等语言服务器在大型项目上可能消耗大量内存。如果您遇到内存问题，请使用 /plugin disable <plugin-name> 禁用插件，并改为依赖 Claude 的内置搜索工具。
monorepos 中的误报诊断：如果工作区配置不正确，语言服务器可能会报告内部包的未解析导入错误。这些不会影响 Claude 编辑代码的能力。

后续步骤

构建您自己的插件：请参阅插件以创建 skills、agents 和 hooks
创建市场：请参阅创建插件市场以将插件分发给您的团队或社区
技术参考：请参阅插件参考以获取完整规范

​市场如何工作

​官方 Anthropic 市场

​代码智能

​Claude 从代码智能插件获得的功能

​外部集成

​自动安全审查

​开发工作流

​输出样式

​社区市场

​尝试：添加演示市场

​添加市场

​从 GitHub 添加

​从其他 Git 主机添加

​从本地路径添加

​从远程 URL 添加

​安装插件

​管理已安装的插件

​应用插件更改而不重启

​管理市场

​使用交互式界面

​使用 CLI 命令

​配置自动更新

​配置团队市场

​安全性

​故障排除

​/plugin 命令无法识别

​常见问题

​代码智能问题

​后续步骤

市场如何工作

官方 Anthropic 市场

代码智能

Claude 从代码智能插件获得的功能

外部集成

自动安全审查

开发工作流

输出样式

社区市场

尝试：添加演示市场

添加市场

从 GitHub 添加

从其他 Git 主机添加

从本地路径添加

从远程 URL 添加

安装插件

管理已安装的插件

应用插件更改而不重启

管理市场

使用交互式界面

使用 CLI 命令

配置自动更新

配置团队市场

安全性

故障排除

/plugin 命令无法识别

常见问题

代码智能问题

后续步骤