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 的功能。插件市场是目录,帮你发现和安装这些扩展,而无需自己构建。
想创建和分发自己的市场?参见 创建插件市场。
市场工作原理
市场是他人创建并共享的插件目录。使用市场分两步:
- 添加市场:将市场注册为插件来源,此时不会安装任何插件。
- 安装插件:浏览目录并选择你需要的插件安装。
类似于添加应用商店:添加商店后可以浏览其内容,但仍需逐个选择下载。
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 服务器,让你无需手动设置即可连接外部服务:
- 代码托管:
github、gitlab - 项目管理:
atlassian(Jira/Confluence)、asana、linear、notion - 设计:
figma - 基础设施:
vercel、firebase、supabase - 沟通:
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),其中包含示例插件,展示插件系统可以做什么。与官方市场不同,你需要手动添加这个市场。
-
在 Claude Code 中运行
plugin marketplace add命令,添加anthropics/claude-code市场:/plugin marketplace add anthropics/claude-code这会下载市场目录,使其中的插件可供你使用。
-
运行
/plugin打开插件管理器。这会打开一个标签页界面,有四个标签页,可用 Tab(或 Shift+Tab 返回)切换:- Discover:浏览所有市场中的可用插件
- Installed:查看和管理已安装的插件
- Marketplaces:添加、删除或更新已添加的市场
- Errors:查看插件加载错误
进入 Discover 标签页,即可看到刚添加的市场中的插件。
-
选择一个插件查看详情。详情面板显示插件包含的内容及其成本:
- 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关于范围的更多信息,参见配置范围。
-
安装后,运行
/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-code 指 anthropics 组织名下的 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。
通过界面为单个市场切换自动更新:
- 运行
/plugin打开插件管理器 - 选择 Marketplaces
- 从列表中选择一个市场
- 选择 Enable auto-update 或 Disable auto-update
官方 Anthropic 市场默认启用自动更新;第三方和本地开发市场默认禁用。
管理员可以在托管设置的 extraKnownMarketplaces 条目中设置 "autoUpdate": true,为组织市场启用自动更新,无需每个用户手动设置。
要完全禁用 Claude Code 及所有插件的自动更新,设置 DISABLE_AUTOUPDATER 环境变量。详情参见自动更新。
要保持插件自动更新同时禁用 Claude Code 自动更新,可以同时设置 DISABLE_AUTOUPDATER 和 FORCE_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"
}
}
}
}
完整的配置选项(包括 extraKnownMarketplaces 和 enabledPlugins),参见插件设置。
安全说明
插件和市场是高度受信任的组件,可以以你的用户权限在机器上执行任意代码。只从你信任的来源安装插件和添加市场。组织可以使用托管市场限制来限制用户允许添加的市场。
故障排查
/plugin 命令无法识别
如果看到“unknown command”或 /plugin 命令不显示:
- 检查版本:运行
claude --version查看当前版本。 - 更新 Claude Code:
- Homebrew:
brew upgrade claude-code(如果你安装了claude-code@latestcask,对应命令为brew upgrade claude-code@latest) - npm:
npm install -g @anthropic-ai/claude-code@latest - 原生安装器:重新运行安装命令
- Homebrew:
- 重启 Claude Code:更新后,重启终端并重新运行
claude。
常见问题
- 市场无法加载:确认 URL 可访问,且
.claude-plugin/marketplace.json存在于指定路径。 - 插件安装失败:检查插件源 URL 是否可访问,仓库是否为公开(或你具有访问权限)。
- 安装后文件找不到:插件被复制到缓存目录,引用插件目录以外文件的路径不会生效。
- 插件 Skills 未出现:清除缓存
rm -rf ~/.claude/plugins/cache,重启 Claude Code 并重新安装插件。
详细的故障排查解决方案,参见市场指南中的故障排查。调试工具参见调试与开发工具。
代码智能问题
- Language server 未启动:确认二进制已安装且在
$PATH中。查看/pluginErrors 标签页获取详情。 - 内存占用高:
rust-analyzer和pyright等语言服务器在大型项目上可能消耗大量内存。如果遇到内存问题,使用/plugin disable <plugin-name>禁用插件,回退到 Claude 内置搜索工具。 - Monorepo 中的误报诊断:语言服务器可能因 workspace 配置不正确而报告内部包未解析的 import 错误。这些不影响 Claude 编辑代码的能力。
常见问题
官方市场的插件需要手动安装吗?
是的。官方市场只是一个目录,你需要逐个安装想要的插件。运行 /plugin 进入 Discover 标签浏览所有可用插件,然后按 Enter 选择安装。
项目范围的插件会影响其他协作者吗?
会。项目范围的插件配置写入 .claude/settings.json,该文件通常提交到版本控制,所有信任该仓库的协作者都会看到这些插件。如果只想为自己安装,选择 Local scope。
如何为自己的语言添加代码智能支持?
官方市场未包含的语言,可以创建自定义 LSP 插件。你需要系统中已安装对应语言的 language server 二进制文件。