发现并安装插件

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

插件通过 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

官方市场插件分类

代码智能（LSP）

代码智能插件启用 Claude Code 内置的 LSP 工具，让 Claude 可以跳转定义、查找引用、即时查看类型错误。这些插件需要系统中已安装对应的 language server 二进制文件。

语言	插件	所需二进制
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 插件。

代码智能插件带来两种能力：

自动诊断：Claude 每次编辑文件后，language server 自动分析变更并报告错误和警告（类型错误、缺少 import、语法问题）。Claude 发现自己引入错误后，会在同一轮中修复。按 Ctrl+O 可查看内联诊断。
代码导航：Claude 可跳转定义、查找引用、获取悬停类型信息、列出符号、查找实现、追溯调用层次——比 grep 搜索更精准。

外部集成

预配置的 MCP 服务器插件，无需手动设置即可连接外部服务：

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

开发工作流

commit-commands：Git commit 工作流（commit、push、PR 创建）
pr-review-toolkit：PR 审查专用 Agent
agent-sdk-dev：Claude Agent SDK 开发工具
plugin-dev：创建自己插件的工具包

输出样式

explanatory-output-style：对实现选择提供教育性解释
learning-output-style：交互式学习模式

添加演示市场

Anthropic 维护了一个演示插件市场（claude-code-plugins），展示插件系统的可能性。需要手动添加：

/plugin marketplace add anthropics/claude-code

添加市场

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

从 GitHub 添加

/plugin marketplace add anthropics/claude-code

使用 owner/repo 格式，仓库中须包含 .claude-plugin/marketplace.json 文件。

从其他 Git 托管添加

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

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

# 指定分支或标签
/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 添加

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

安装插件

添加市场后，直接安装（默认安装到用户范围）：

/plugin install plugin-name@marketplace-name

选择安装范围：运行 /plugin → Discover 标签 → 按 Enter 选择插件，可以选择：

范围	说明
User scope（默认）	为你个人安装，跨所有项目生效
Project scope	为该仓库所有协作者安装（写入 `.claude/settings.json`）
Local scope	仅为你在该仓库中安装（不与协作者共享）

managed scope（托管范围）：由管理员通过托管设置安装，普通用户无法修改。

运行 /plugin → Installed 标签查看所有已安装插件（按范围分组）。

管理已安装的插件

bash

# 禁用插件（不卸载）
/plugin disable plugin-name@marketplace-name

# 重新启用
/plugin enable plugin-name@marketplace-name

# 完全卸载
/plugin uninstall plugin-name@marketplace-name

# 指定范围操作
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

无需重启应用插件变更

安装、启用或禁用插件后，运行：

/reload-plugins

Claude Code 重载所有活跃插件并显示插件、Skills、Agents、Hooks、插件 MCP 服务器和插件 LSP 服务器的数量。

管理市场

交互界面

运行 /plugin → Marketplaces 标签：查看所有市场（来源和状态）、添加新市场、更新列表、删除不需要的市场。

CLI 命令

bash

# 列出所有已配置的市场
/plugin marketplace list

# 刷新市场的插件列表
/plugin marketplace update marketplace-name

# 删除市场
/plugin marketplace remove marketplace-name

配置自动更新

开启后，Claude Code 在启动时自动更新市场和已安装插件。有更新时会提示运行 /reload-plugins。

通过 /plugin → Marketplaces → 选择市场 → 开启/关闭 Enable auto-update 来单独控制。

官方 Anthropic 市场默认开启自动更新；第三方和本地开发市场默认关闭。

完全禁用自动更新：设置 DISABLE_AUTOUPDATER 环境变量。
禁用 Claude Code 自身更新但保留插件自动更新：

bash

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

团队统一市场配置

管理员可在 .claude/settings.json 中配置自动安装市场。团队成员信任项目目录时，Claude Code 会提示安装这些市场和插件：

json

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

完整配置选项见插件设置。

安全说明

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

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

故障排查

`/plugin` 命令无法识别

运行 claude --version 确认版本
更新 Claude Code：npm update -g @anthropic-ai/claude-code
重启 Claude Code

故障排查题

问题	解决方法
市场无法加载	确认 URL 可访问，且 `.claude-plugin/marketplace.json` 存在
插件安装失败	检查插件源 URL 是否可访问，仓库是否为公开或你有访问权限
安装后文件找不到	插件复制到缓存目录，引用目录外文件的路径不起作用
插件 Skills 未出现	运行 `rm -rf ~/.claude/plugins/cache`，重启 Claude Code 并重新安装

代码智能问题

Language server 未启动：确认二进制文件已安装且在 $PATH 中，查看 /plugin Errors 标签
内存占用高：大项目上 rust-analyzer 和 pyright 可能消耗大量内存，可运行 /plugin disable <plugin-name> 禁用
Monorepo 中的误报：内部包可能因 workspace 未正确配置而报未解析 import，不影响 Claude 编辑代码

常见问题

Q: 官方市场的插件需要手动安装吗？

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

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

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

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

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

发现并安装插件 ​

市场工作原理 ​

Anthropic 官方市场 ​

官方市场插件分类 ​

代码智能（LSP） ​

外部集成 ​

开发工作流 ​

输出样式 ​

添加演示市场 ​

添加市场 ​

从 GitHub 添加 ​

从其他 Git 托管添加 ​

从本地路径添加 ​

从远程 URL 添加 ​

安装插件 ​

管理已安装的插件 ​

无需重启应用插件变更 ​

管理市场 ​

交互界面 ​

CLI 命令 ​

配置自动更新 ​

团队统一市场配置 ​

安全说明 ​

故障排查 ​

/plugin 命令无法识别 ​

故障排查题 ​

代码智能问题 ​

相关文档 ​

常见问题 ​

发现并安装插件

市场工作原理

Anthropic 官方市场

官方市场插件分类

代码智能（LSP）

外部集成

开发工作流

输出样式

添加演示市场

添加市场

从 GitHub 添加

从其他 Git 托管添加

从本地路径添加

从远程 URL 添加

安装插件

管理已安装的插件

无需重启应用插件变更

管理市场

交互界面

CLI 命令

配置自动更新

团队统一市场配置

安全说明

故障排查

`/plugin` 命令无法识别

故障排查题

代码智能问题

相关文档

常见问题