Claude Code 插件市场让你无需自己构建就能发现和安装插件——包含 Skills、Agents、Hooks 和 MCP 服务器。官方 Anthropic 市场(claude-plugins-official)随 Claude Code 自动启用,提供代码智能(LSP)、外部集成(GitHub/GitLab/Linear/Slack 等)和工作流插件。你也可以手动添加来自 GitHub、GitLab、本地路径或任意 Git URL 的第三方市场。通过 /plugin 命令集中管理,支持按用户/项目/本地三种范围安装,以及团队统一配置和自动更新。

Claude Code 插件市场:发现、安装与管理插件完整指南

插件通过 Skills、Agents、Hooks 和 MCP 服务器扩展 Claude Code 的功能。插件市场是目录,帮你发现和安装这些扩展,而无需自己构建。

想创建和分发自己的市场?参见 创建插件市场

市场工作原理

市场是他人创建并共享的插件目录。使用市场分两步:

  1. 添加市场:将市场注册为插件来源,此时不会安装任何插件。
  2. 安装插件:浏览目录并选择你需要的插件安装。

类似于添加应用商店:添加商店后可以浏览其内容,但仍需逐个选择下载。

Anthropic 官方市场

官方市场(claude-plugins-official)在 Claude Code 启动时自动可用。运行 /plugin 并进入 Discover 标签页浏览可用插件,或访问 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 自行决定。应用内提交表单将插件添加至社区市场,而非官方市场。想独立分发插件,请创建自己的市场并与用户共享。

官方市场插件分类

代码智能(LSP)

代码智能插件启用 Claude Code 内置的 LSP 工具,让 Claude 可以跳转定义、查找引用、编辑后立即看到类型错误。这些插件配置 Language Server Protocol 连接——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 插件

如果安装插件后看到 Executable not found in $PATH,从上方表格找到并安装对应二进制。

代码智能插件带来的能力:

  • 自动诊断:Claude 每次编辑文件后,语言服务器自动分析变更并报告错误和警告。Claude 可以即时看到类型错误、缺失 import 和语法问题,无需运行编译器或 linter。如果 Claude 引入错误,它会在同一轮中注意到并修复。安装插件即可使用,无需额外配置。当出现“diagnostics found”指示时,按 Ctrl+O 可查看内联诊断。
  • 代码导航:Claude 可利用语言服务器跳转定义、查找引用、悬停获取类型信息、列出符号、查找实现、追溯调用层次。这些操作比基于 grep 的搜索更精确,但可用性可能因语言和环境而异。

如果遇到问题,参见代码智能故障排查

外部集成

这些插件捆绑了预配置的 MCP 服务器,让你无需手动设置即可连接外部服务:

  • 代码托管githubgitlab
  • 项目管理atlassian(Jira/Confluence)、asanalinearnotion
  • 设计figma
  • 基础设施vercelfirebasesupabase
  • 沟通slack
  • 监控sentry

开发工作流

这些插件为常见开发任务添加 Skills 和 Agents:

  • commit-commands:Git commit 工作流,包括 commit、push 和 PR 创建
  • pr-review-toolkit:专门 review pull request 的 Agent
  • agent-sdk-dev:使用 Claude Agent SDK 构建的工具
  • plugin-dev:创建自己插件的工具包

输出样式

定制 Claude 的回答方式:

  • explanatory-output-style:对实现选择提供教育性解释
  • learning-output-style:交互式学习模式,用于培养技能

社区市场

社区市场位于 anthropics/claude-plugins-community,托管通过 Anthropic 自动验证和安全筛查的第三方插件。每个插件在目录中固定到特定 commit SHA。与官方市场不同,你需要手动添加:

/plugin marketplace add anthropics/claude-plugins-community

然后使用 claude-community 作为市场名称安装插件:

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

如何将自己的插件提交到社区市场,参见创建插件指南中的提交部分

尝试:添加演示市场

Anthropic 还维护了一个演示插件市场claude-code-plugins),其中包含示例插件,展示插件系统可以做什么。与官方市场不同,你需要手动添加这个市场。

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

    /plugin marketplace add anthropics/claude-code

    这会下载市场目录,使其中的插件可供你使用。

  2. 运行 /plugin 打开插件管理器。这会打开一个标签页界面,有四个标签页,可用 Tab(或 Shift+Tab 返回)切换:

    • Discover:浏览所有市场中的可用插件
    • Installed:查看和管理已安装的插件
    • Marketplaces:添加、删除或更新已添加的市场
    • Errors:查看插件加载错误

    进入 Discover 标签页,即可看到刚添加的市场中的插件。

  3. 选择一个插件查看详情。详情面板显示插件包含的内容及其成本:

    • Context cost 估算:显示每次对话上下文窗口消耗的 token 数(Claude Code v2.1.143 及以后)
    • 插件的 Last updated 日期(v2.1.144 及以后)
    • Will install 部分列出插件的命令、Agent、Skills、Hooks 以及 MCP 和 LSP 服务器,供你在安装前审查(v2.1.145 及以后)

    选择安装范围:

    • User scope:为你个人安装,跨所有项目生效
    • Project scope:为该仓库所有协作者安装
    • Local scope:仅为你在该仓库中安装

    例如,选择 commit-commands(添加 Git 工作流技能的插件)并安装到用户范围。

    你也可以直接从命令行安装:

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

    关于范围的更多信息,参见配置范围

  4. 安装后,运行 /reload-plugins 激活插件。插件技能以插件名称为命名空间,因此 commit-commands 提供的技能如 /commit-commands:commit

    试试看:修改一个文件,然后运行:

    /commit-commands:commit

    这将暂存你的更改、生成 commit 消息并创建 commit。

    每个插件工作方式不同。在 Discover 标签页查看插件详情以了解其提供的命令和技能,或访问插件主页获取使用指导。

添加市场

使用 /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 添加

添加包含 .claude-plugin/marketplace.json 文件的 GitHub 仓库,使用 owner/repo 格式——其中 owner 是 GitHub 用户名或组织,repo 是仓库名。

例如,anthropics/claude-codeanthropics 组织名下的 claude-code 仓库:

/plugin marketplace add anthropics/claude-code

从其他 Git 托管添加

提供完整 URL 添加任意 Git 仓库。适用于任何 Git 托管服务,包括 GitLab、Bitbucket 和自托管服务器。记得包含 .git 后缀,这样 Claude Code 会克隆仓库而不是将 URL 当作托管 marketplace.json 的直接链接。

使用 HTTPS:

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

使用 SSH:

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

要添加特定分支或标签,在 URL 后附加 # 加引用名:

/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

基于 URL 的市场相比基于 Git 的市场有一些限制。如果安装插件时遇到“path not found”错误,参见故障排查

安装插件

添加市场后,可以直接安装(默认安装到用户范围):

/plugin install plugin-name@marketplace-name

要选择不同的安装范围,使用交互界面:运行 /plugin,进入 Discover 标签,按 Enter 选择一个插件。你会看到以下选项:

  • User scope(默认):为你个人安装,跨所有项目生效
  • Project scope:为该仓库所有协作者安装(写入 .claude/settings.json
  • Local scope:仅为你在该仓库中安装(不与协作者共享)

你可能还会看到 managed 范围——这些由管理员通过托管设置安装,无法修改。

安装插件前请确保你信任该插件。Anthropic 无法控制插件中捆绑的 MCP 服务器、文件或其他软件,也无法验证它们是否如预期工作。查看每个插件的主页获取更多信息。

管理已安装的插件

运行 /plugin 并进入 Installed 标签页,查看、启用、禁用或卸载插件。列表按范围分组,有问题者优先显示:加载错误或依赖未解析的插件排在前面,然后是收藏的插件,禁用的插件折叠在底部。

在列表中你可以:

  • f 收藏或取消收藏所选插件
  • 输入文字过滤插件名称或描述
  • 按 Enter 打开插件详情,并启用、禁用或卸载

当你安装声明依赖的插件时,安装输出会列出自动附带安装的依赖。

你也可以通过直接命令管理插件。

禁用插件而不卸载:

/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 服务器和插件 LSP 服务器的数量。

管理市场

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

使用交互界面

运行 /plugin 并进入 Marketplaces 标签页,可以:

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

使用 CLI 命令

列出所有已配置的市场:

/plugin marketplace list

刷新某个市场的插件列表:

/plugin marketplace update marketplace-name

删除市场:

/plugin marketplace remove marketplace-name

删除市场将卸载从该市场安装的所有插件。

配置自动更新

Claude Code 可以在启动时自动更新市场及其已安装的插件。启用自动更新后,Claude Code 刷新市场数据并将已安装的插件更新到最新版本。如果有插件更新,你会看到通知提示运行 /reload-plugins

通过界面为单个市场切换自动更新:

  1. 运行 /plugin 打开插件管理器
  2. 选择 Marketplaces
  3. 从列表中选择一个市场
  4. 选择 Enable auto-updateDisable auto-update

官方 Anthropic 市场默认启用自动更新;第三方和本地开发市场默认禁用。

管理员可以在托管设置的 extraKnownMarketplaces 条目中设置 "autoUpdate": true,为组织市场启用自动更新,无需每个用户手动设置。

要完全禁用 Claude Code 及所有插件的自动更新,设置 DISABLE_AUTOUPDATER 环境变量。详情参见自动更新

要保持插件自动更新同时禁用 Claude Code 自动更新,可以同时设置 DISABLE_AUTOUPDATERFORCE_AUTOUPDATE_PLUGINS=1

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

当你希望手动管理 Claude Code 更新,但依然接收自动插件更新时,这个配置很有用。

配置团队市场

团队管理员可以通过在 .claude/settings.json 中添加市场配置,为项目设置自动市场安装。当团队成员信任仓库文件夹后,Claude Code 会提示安装这些市场和插件。

在项目的 .claude/settings.json 中添加 extraKnownMarketplaces

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

完整的配置选项(包括 extraKnownMarketplacesenabledPlugins),参见插件设置

安全说明

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

故障排查

/plugin 命令无法识别

如果看到“unknown command”或 /plugin 命令不显示:

  1. 检查版本:运行 claude --version 查看当前版本。
  2. 更新 Claude Code
    • Homebrewbrew upgrade claude-code(如果你安装了 claude-code@latest cask,对应命令为 brew upgrade claude-code@latest
    • npmnpm install -g @anthropic-ai/claude-code@latest
    • 原生安装器:重新运行安装命令
  3. 重启 Claude Code:更新后,重启终端并重新运行 claude

常见问题

  • 市场无法加载:确认 URL 可访问,且 .claude-plugin/marketplace.json 存在于指定路径。
  • 插件安装失败:检查插件源 URL 是否可访问,仓库是否为公开(或你具有访问权限)。
  • 安装后文件找不到:插件被复制到缓存目录,引用插件目录以外文件的路径不会生效。
  • 插件 Skills 未出现:清除缓存 rm -rf ~/.claude/plugins/cache,重启 Claude Code 并重新安装插件。

详细的故障排查解决方案,参见市场指南中的故障排查。调试工具参见调试与开发工具

代码智能问题

  • Language server 未启动:确认二进制已安装且在 $PATH 中。查看 /plugin Errors 标签页获取详情。
  • 内存占用高rust-analyzerpyright 等语言服务器在大型项目上可能消耗大量内存。如果遇到内存问题,使用 /plugin disable <plugin-name> 禁用插件,回退到 Claude 内置搜索工具。
  • Monorepo 中的误报诊断:语言服务器可能因 workspace 配置不正确而报告内部包未解析的 import 错误。这些不影响 Claude 编辑代码的能力。

常见问题

官方市场的插件需要手动安装吗?

是的。官方市场只是一个目录,你需要逐个安装想要的插件。运行 /plugin 进入 Discover 标签浏览所有可用插件,然后按 Enter 选择安装。

项目范围的插件会影响其他协作者吗?

会。项目范围的插件配置写入 .claude/settings.json,该文件通常提交到版本控制,所有信任该仓库的协作者都会看到这些插件。如果只想为自己安装,选择 Local scope。

如何为自己的语言添加代码智能支持?

官方市场未包含的语言,可以创建自定义 LSP 插件。你需要系统中已安装对应语言的 language server 二进制文件。