{/* TRANSLATED — 已翻译为中文 */}

> ## 文档索引
> 获取完整文档索引：https://code.claude.com/docs/llms.txt
> 使用此文件发现所有可用页面，然后进一步探索。

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

> 从市场查找和安装插件，为 Claude Code 扩展新技能、代理和功能。

插件为 Claude Code 扩展技能、代理、hooks 和 MCP 服务器。插件市场是帮助你发现和安装这些扩展的目录，无需自行构建。

想要创建和分发你自己的市场？请参阅[创建和分发插件市场](/en/plugin-marketplaces)。

## 市场工作原理

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

<Steps>
  <Step title="添加市场">
    将目录注册到 Claude Code，以便你可以浏览可用内容。此时不会安装任何插件。
  </Step>

  <Step title="安装单个插件">
    浏览目录并安装你想要的插件。
  </Step>
</Steps>

可以将其想象为添加应用商店：添加商店让你可以浏览其收藏，但你仍然需要单独选择要下载的应用。

## Anthropic 官方市场

Anthropic 官方市场（`claude-plugins-official`）在你启动 Claude Code 时自动可用。运行 `/plugin` 并转到 **Discover** 标签页浏览可用内容，或在 [claude.com/plugins](https://claude.com/plugins) 查看目录。

要从官方市场安装插件，使用 `/plugin install <name>@claude-plugins-official`。例如，安装 GitHub 集成：

```shell theme={null}
/plugin install github@claude-plugins-official
```

如果 Claude Code 报告在任何市场中都找不到该插件，你的市场缺失或已过时。运行 `/plugin marketplace update claude-plugins-official` 刷新，或如果之前未添加过则运行 `/plugin marketplace add anthropics/claude-plugins-official`。然后重试安装。

<Note>
  官方市场由 Anthropic 策展，收录由 Anthropic 自行决定。应用内提交表单将插件添加到[社区市场](#community-marketplace)而非官方市场。要独立分发插件，[创建你自己的市场](/en/plugin-marketplaces)并与用户分享。
</Note>

官方市场包含几类插件：

### 代码智能

代码智能插件启用 Claude Code 内置的 LSP 工具，使 Claude 能够跳转到定义、查找引用，并在编辑后立即看到类型错误。这些插件配置 [Language Server Protocol](https://microsoft.github.io/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 插件](/en/plugins-reference#lsp-servers)。

<Note>
  如果你在 `/plugin` Errors 标签页中安装插件后看到 `Executable not found in $PATH`，请从上表安装所需的二进制文件。
</Note>

#### Claude 从代码智能插件获得的能力

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

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

如果遇到问题，请参阅[代码智能故障排除](#code-intelligence-issues)。

### 外部集成

这些插件捆绑了预配置的 [MCP 服务器](/en/mcp)，让你无需手动设置即可将 Claude 连接到外部服务：

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

### 自动安全审查

`security-guidance` 插件检查 Claude 所做的每个更改是否存在常见漏洞，并指示 Claude 在同一会话中修复发现的问题。参阅[在 Claude 编写代码时捕获安全问题](/en/security-guidance)了解它检查什么以及如何添加项目特定规则。

### 开发工作流

为常见开发任务添加技能和代理的插件：

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

### 输出样式

自定义 Claude 的响应方式：

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

## 社区市场

[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) 上的社区市场托管了已通过 Anthropic 自动化验证和安全筛选的第三方插件。每个插件在目录中固定到特定的 commit SHA。与官方市场不同，你需要手动添加它：

```shell theme={null}
/plugin marketplace add anthropics/claude-plugins-community
```

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

```shell theme={null}
/plugin install <plugin-name>@claude-community
```

要将你自己的插件提交到社区市场，请参阅创建插件指南中的[将你的插件提交到社区市场](/en/plugins#submit-your-plugin-to-the-community-marketplace)。

## 试一试：添加演示市场

Anthropic 还维护了一个[演示插件市场](https://github.com/anthropics/claude-code/tree/main/plugins)（`claude-code-plugins`），包含展示插件系统功能的示例插件。与官方市场不同，你需要手动添加它。

<Steps>
  <Step title="添加市场">
    在 Claude Code 中，为 `anthropics/claude-code` 市场运行 `plugin marketplace add` 命令：

    ```shell theme={null}
    /plugin marketplace add anthropics/claude-code
    ```

    这会下载市场目录并使其插件对你可用。
  </Step>

  <Step title="浏览可用插件">
    运行 `/plugin` 打开插件管理器。这会打开一个带四个标签页的界面，你可以使用 **Tab**（或 **Shift+Tab** 向后）循环切换：

    * **Discover**：浏览你所有市场中的可用插件
    * **Installed**：查看和管理你已安装的插件
    * **Marketplaces**：添加、移除或更新你添加的市场
    * **Errors**：查看任何插件加载错误

    转到 **Discover** 标签页查看你刚添加的市场中的插件。
  </Step>

  <Step title="安装插件">
    选择一个插件查看其详情。详情面板显示插件包含的内容和成本：

    * {/* min-version: 2.1.143 */}**上下文成本**估算，让你看到插件每轮会为你的[上下文窗口](/en/features-overview#understand-context-costs)添加多少 tokens（Claude Code v2.1.143 及更高版本）
    * {/* min-version: 2.1.144 */}插件的**最后更新**日期（v2.1.144 及更高版本）
    * {/* min-version: 2.1.145 */}**将安装**部分，列出插件的命令、代理、技能、hooks 以及 MCP 和 LSP 服务器，让你在安装前确切查看它添加了什么（v2.1.145 及更高版本）

    选择安装范围：

    * **用户范围**：为你自己跨所有项目安装
    * **项目范围**：为该仓库的所有协作者安装
    * **本地范围**：仅为你自己在此仓库中安装

    例如，选择 **commit-commands**（一个添加 git 工作流技能的插件）并安装到你的用户范围。

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

    ```shell theme={null}
    /plugin install commit-commands@claude-code-plugins
    ```

    参阅[配置范围](/en/settings#configuration-scopes)了解更多关于范围的信息。
  </Step>

  <Step title="使用你的新插件">
    安装后，运行 `/reload-plugins` 激活插件。插件技能按插件名称命名空间化，因此 **commit-commands** 提供像 `/commit-commands:commit` 这样的技能。

    通过对文件进行更改并运行来试用：

    ```shell theme={null}
    /commit-commands:commit
    ```

    这会暂存你的更改，生成提交消息并创建提交。

    每个插件的工作方式不同。在 **Discover** 标签页中检查插件的详情以查看它提供的命令和技能，或访问其主页获取使用指导。
  </Step>
</Steps>

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

## 添加市场

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

<Tip>
  **快捷方式**：你可以使用 `/plugin market` 代替 `/plugin marketplace`，使用 `rm` 代替 `remove`。
</Tip>

* **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` 仓库：

```shell theme={null}
/plugin marketplace add anthropics/claude-code
```

### 从其他 Git 主机添加

通过提供完整 URL 添加任何 git 仓库。这适用于任何 Git 主机，包括 GitLab、Bitbucket 和自托管服务器。包含 `.git` 后缀以便 Claude Code 克隆仓库而非将 URL 视为指向托管 `marketplace.json` 文件的直接链接。

使用 HTTPS：

```shell theme={null}
/plugin marketplace add https://gitlab.com/company/plugins.git
```

使用 SSH：

```shell theme={null}
/plugin marketplace add git@gitlab.com:company/plugins.git
```

要添加特定分支或标签，附加 `#` 后跟引用：

```shell theme={null}
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
```

### 从本地路径添加

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

```shell theme={null}
/plugin marketplace add ./my-marketplace
```

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

```shell theme={null}
/plugin marketplace add ./path/to/marketplace.json
```

### 从远程 URL 添加

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

```shell theme={null}
/plugin marketplace add https://example.com/marketplace.json
```

<Note>
  基于 URL 的市场与基于 Git 的市场相比有一些限制。如果你在安装插件时遇到"path not found"错误，请参阅[故障排除](/en/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)。
</Note>

## 安装插件

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

```shell theme={null}
/plugin install plugin-name@marketplace-name
```

要选择不同的[安装范围](/en/settings#configuration-scopes)，使用交互式 UI：运行 `/plugin`，转到 **Discover** 标签页，然后在插件上按 **Enter**。你会看到以下选项：

* **用户范围**（默认）：为你自己跨所有项目安装
* **项目范围**：为该仓库的所有协作者安装（添加到 `.claude/settings.json`）
* **本地范围**：仅为你自己在此仓库中安装（不与协作者共享）

你可能还会看到具有 **managed** 范围的插件——这些是管理员通过[托管设置](/en/settings#settings-files)安装的，无法修改。

<Warning>
  安装插件前请确保你信任该插件。Anthropic 不控制插件中包含的 MCP 服务器、文件或其他软件，也无法验证它们是否按预期工作。检查每个插件的主页了解更多信息。
</Warning>

## 管理已安装的插件

运行 `/plugin` 并转到 **Installed** 标签页查看、启用、禁用或卸载你的插件。列表按范围分组并排序，以便你首先看到问题：加载错误或未解析依赖的插件出现在顶部，然后是你的收藏夹，禁用的插件折叠在底部的折叠标题下。

从列表中你可以：

* 按 `f` 收藏或取消收藏所选插件
* 输入以按插件名称或描述过滤
* 按 Enter 打开插件的详情视图并启用、禁用或卸载它

当你安装声明依赖的插件时，安装输出会列出与其一起自动安装的依赖项。

你也可以使用直接命令管理插件。

禁用插件而不卸载：

```shell theme={null}
/plugin disable plugin-name@marketplace-name
```

重新启用已禁用的插件：

```shell theme={null}
/plugin enable plugin-name@marketplace-name
```

完全移除插件：

```shell theme={null}
/plugin uninstall plugin-name@marketplace-name
```

`--scope` 选项让你可以使用 CLI 命令针对特定范围：

```shell theme={null}
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project
```

### 无需重启即可应用插件更改

当你在会话期间安装、启用或禁用插件时，运行 `/reload-plugins` 无需重启即可获取所有更改：

```shell theme={null}
/reload-plugins
```

Claude Code 重新加载所有活动插件并显示插件、技能、代理、hooks、插件 MCP 服务器和插件 LSP 服务器的计数。

## 管理市场

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

### 使用交互式界面

运行 `/plugin` 并转到 **Marketplaces** 标签页：

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

### 使用 CLI 命令

你也可以使用直接命令管理市场。

列出所有已配置的市场：

```shell theme={null}
/plugin marketplace list
```

从市场刷新插件列表：

```shell theme={null}
/plugin marketplace update marketplace-name
```

移除市场：

```shell theme={null}
/plugin marketplace remove marketplace-name
```

<Warning>
  移除市场将卸载你从中安装的所有插件。
</Warning>

### 配置自动更新

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

通过 UI 为各个市场切换自动更新：

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

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

管理员也可以在托管设置中的每个 [`extraKnownMarketplaces`](/en/settings#extraknownmarketplaces) 条目上设置 `"autoUpdate": true`，为组织市场启用自动更新，无需每个用户手动切换。

要完全禁用 Claude Code 和所有插件的所有自动更新，设置 `DISABLE_AUTOUPDATER` 环境变量。详情请参阅[自动更新](/en/setup#auto-updates)。

要在禁用 Claude Code 自动更新的同时保持插件自动更新，设置 `FORCE_AUTOUPDATE_PLUGINS=1` 和 `DISABLE_AUTOUPDATER`：

```bash theme={null}
export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1
```

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

## 配置团队市场

团队管理员可以通过将市场配置添加到 `.claude/settings.json` 来设置项目的自动市场安装。当团队成员信任仓库文件夹时，Claude Code 会提示他们安装这些市场和插件。

将 `extraKnownMarketplaces` 添加到你项目的 `.claude/settings.json`：

```json theme={null}
{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}
```

关于完整的配置选项（包括 `extraKnownMarketplaces` 和 `enabledPlugins`），请参阅[插件设置](/en/settings#plugin-settings)。

## 安全

插件和市场是高度受信任的组件，可以在你的机器上以你的用户权限执行任意代码。仅安装来自你信任来源的插件和添加市场。组织可以使用[托管市场限制](/en/plugin-marketplaces#managed-marketplace-restrictions)限制用户允许添加哪些市场。

## 故障排除

### /plugin 命令未被识别

如果你看到"unknown command"或 `/plugin` 命令未出现：

1. **检查你的版本**：运行 `claude --version` 查看安装的版本。
2. **更新 Claude Code**：
   * **Homebrew**：`brew upgrade claude-code`（或如果你安装了该 cask 则 `brew upgrade claude-code@latest`）
   * **npm**：`npm install -g @anthropic-ai/claude-code@latest`
   * **原生安装程序**：重新运行[设置](/en/setup)中的安装命令
3. **重启 Claude Code**：更新后，重启终端并再次运行 `claude`。

### 常见问题

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

关于详细的故障排除和解决方案，请参阅市场指南中的[故障排除](/en/plugin-marketplaces#troubleshooting)。关于调试工具，请参阅[调试和开发工具](/en/plugins-reference#debugging-and-development-tools)。

### 代码智能问题

* **语言服务器未启动**：验证二进制文件已安装且在你的 `$PATH` 中可用。检查 `/plugin` Errors 标签页了解详情。
* **高内存使用**：`rust-analyzer` 和 `pyright` 等语言服务器在大型项目上可能消耗大量内存。如果遇到内存问题，使用 `/plugin disable <plugin-name>` 禁用插件，改用 Claude 的内置搜索工具。
* **monorepo 中的误报诊断**：如果工作区未正确配置，语言服务器可能报告内部包的未解析导入错误。这些不影响 Claude 编辑代码的能力。

## 后续步骤

* **构建你自己的插件**：参阅[插件](/en/plugins)创建技能、代理和 hooks
* **创建市场**：参阅[创建插件市场](/en/plugin-marketplaces)向你的团队或社区分发插件
* **技术参考**：参阅[插件参考](/en/plugins-reference)获取完整规范