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

市场如何工作

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

添加市场

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

安装单个插件

浏览目录并安装您想要的插件。
可以将其视为添加应用商店:添加商店让您可以访问浏览其集合,但您仍然需要单独选择要下载的应用。

官方 Anthropic 市场

官方 Anthropic 市场(claude-plugins-official)在您启动 Claude Code 时自动可用。运行 /plugin 并转到发现选项卡以浏览可用内容,或在 claude.com/plugins 查看目录。 要从官方市场安装插件,请使用 /plugin install <name>@claude-plugins-official。例如,要安装 GitHub 集成:
/plugin install github@claude-plugins-official
官方市场由 Anthropic 维护。要向官方市场提交插件,请使用应用内提交表单之一:要独立分发插件,请创建您自己的市场并与用户共享。
官方市场包括多个插件类别:

代码智能

代码智能插件启用 Claude Code 的内置 LSP 工具,使 Claude 能够跳转到定义、查找引用并在编辑后立即查看类型错误。这些插件配置语言服务器协议连接,这是为 VS Code 代码智能提供支持的相同技术。 这些插件需要在您的系统上安装语言服务器二进制文件。如果您已经安装了语言服务器,当您打开项目时,Claude 可能会提示您安装相应的插件。
语言插件所需二进制文件
C/C++clangd-lspclangd
C#csharp-lspcsharp-ls
Gogopls-lspgopls
Javajdtls-lspjdtls
Kotlinkotlin-lspkotlin-language-server
Lualua-lsplua-language-server
PHPphp-lspintelephense
Pythonpyright-lsppyright-langserver
Rustrust-analyzer-lsprust-analyzer
Swiftswift-lspsourcekit-lsp
TypeScripttypescript-lsptypescript-language-server
您也可以为其他语言创建自己的 LSP 插件
如果在安装插件后在 /plugin 错误选项卡中看到 Executable not found in $PATH,请从上表安装所需的二进制文件。

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

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

外部集成

这些插件捆绑预配置的 MCP servers,以便您可以连接 Claude 到外部服务,无需手动设置:
  • 源代码控制githubgitlab
  • 项目管理atlassian(Jira/Confluence)、asanalinearnotion
  • 设计figma
  • 基础设施vercelfirebasesupabase
  • 通信slack
  • 监控sentry

开发工作流

为常见开发任务添加命令和代理的插件:
  • commit-commands:Git 提交工作流,包括提交、推送和 PR 创建
  • pr-review-toolkit:用于审查拉取请求的专门代理
  • agent-sdk-dev:使用 Claude Agent SDK 构建的工具
  • plugin-dev:用于创建您自己的插件的工具包

输出样式

自定义 Claude 的响应方式:
  • explanatory-output-style:关于实现选择的教育见解
  • learning-output-style:用于技能构建的交互式学习模式

尝试:添加演示市场

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

添加市场

在 Claude Code 中,为 anthropics/claude-code 市场运行 plugin marketplace add 命令:
/plugin marketplace add anthropics/claude-code
这会下载市场目录并使其插件对您可用。
2

浏览可用插件

运行 /plugin 打开插件管理器。这会打开一个选项卡式界面,有四个选项卡,您可以使用 Tab 循环切换(或使用 Shift+Tab 向后切换):
  • 发现:从所有市场浏览可用插件
  • 已安装:查看和管理已安装的插件
  • 市场:添加、删除或更新已添加的市场
  • 错误:查看任何插件加载错误
转到发现选项卡以查看您刚添加的市场中的插件。
3

安装插件

选择一个插件以查看其详细信息,然后选择安装范围:
  • 用户范围:在所有项目中为自己安装
  • 项目范围:为此存储库上的所有协作者安装
  • 本地范围:仅在此存储库中为自己安装
例如,选择 commit-commands(添加 git 工作流命令的插件)并将其安装到您的用户范围。您也可以从命令行直接安装:
/plugin install commit-commands@anthropics-claude-code
请参阅配置范围以了解有关范围的更多信息。
4

使用您的新插件

安装后,运行 /reload-plugins 以激活插件。插件命令由插件名称命名空间,因此 commit-commands 提供诸如 /commit-commands:commit 之类的命令。通过对文件进行更改并运行来尝试:
/commit-commands:commit
这会暂存您的更改、生成提交消息并创建提交。每个插件的工作方式不同。检查发现选项卡中的插件描述或其主页以了解它提供的命令和功能。
本指南的其余部分涵盖了添加市场、安装插件和管理配置的所有方式。

添加市场

使用 /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 和自托管服务器: 使用 HTTPS:
/plugin marketplace add https://gitlab.com/company/plugins.git
使用 SSH:
/plugin marketplace add [email protected]: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
要选择不同的安装范围,请使用交互式 UI:运行 /plugin,转到发现选项卡,然后在插件上按 Enter。您将看到以下选项:
  • 用户范围(默认):在所有项目中为自己安装
  • 项目范围:为此存储库上的所有协作者安装(添加到 .claude/settings.json
  • 本地范围:仅在此存储库中为自己安装(不与协作者共享)
您也可能看到具有托管范围的插件——这些由管理员通过托管设置安装,无法修改。 运行 /plugin 并转到已安装选项卡以查看按范围分组的插件。
在安装插件之前,请确保您信任该插件。Anthropic 不控制插件中包含的 MCP servers、文件或其他软件,也无法验证它们是否按预期工作。检查每个插件的主页以获取更多信息。

管理已安装的插件

运行 /plugin 并转到已安装选项卡以查看、启用、禁用或卸载您的插件。键入以按插件名称或描述筛选列表。 您也可以使用直接命令管理插件。 禁用插件而不卸载:
/plugin disable plugin-name@marketplace-name
重新启用已禁用的插件:
/plugin enable plugin-name@marketplace-name
完全删除插件:
/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 的计数。

管理市场

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

使用交互式界面

运行 /plugin 并转到市场选项卡以:
  • 查看所有已添加的市场及其来源和状态
  • 添加新市场
  • 更新市场列表以获取最新插件
  • 删除您不再需要的市场

使用 CLI 命令

您也可以使用直接命令管理市场。 列出所有配置的市场:
/plugin marketplace list
刷新市场的插件列表:
/plugin marketplace update marketplace-name
删除市场:
/plugin marketplace remove marketplace-name
删除市场将卸载您从中安装的任何插件。

配置自动更新

Claude Code 可以在启动时自动更新市场及其已安装的插件。为市场启用自动更新后,Claude Code 会刷新市场数据并将已安装的插件更新到最新版本。如果任何插件已更新,您将看到提示您运行 /reload-plugins 的通知。 通过 UI 为单个市场切换自动更新:
  1. 运行 /plugin 打开插件管理器
  2. 选择市场
  3. 从列表中选择市场
  4. 选择启用自动更新禁用自动更新
官方 Anthropic 市场默认启用自动更新。第三方和本地开发市场默认禁用自动更新。 要完全禁用 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 会提示他们安装这些市场和插件。 extraKnownMarketplaces 添加到您项目的 .claude/settings.json
{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}
有关完整配置选项(包括 extraKnownMarketplacesenabledPlugins),请参阅插件设置

安全性

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

故障排除

/plugin 命令无法识别

如果您看到”未知命令”或 /plugin 命令未出现:
  1. 检查您的版本:运行 claude --version 以查看安装的内容。
  2. 更新 Claude Code
    • Homebrewbrew upgrade claude-code
    • npmnpm update -g @anthropic-ai/claude-code
    • 本地安装程序:从设置重新运行安装命令
  3. 重启 Claude Code:更新后,重启您的终端并再次运行 claude

常见问题

  • 市场未加载:验证 URL 是否可访问以及 .claude-plugin/marketplace.json 是否存在于该路径
  • 插件安装失败:检查插件源 URL 是否可访问以及存储库是否公开(或您有访问权限)
  • 安装后找不到文件:插件被复制到缓存,因此引用插件目录外文件的路径将不起作用
  • 插件 skills 未出现:使用 rm -rf ~/.claude/plugins/cache 清除缓存,重启 Claude Code,然后重新安装插件。
有关详细的故障排除和解决方案,请参阅市场指南中的故障排除。有关调试工具,请参阅调试和开发工具

代码智能问题

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

后续步骤

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