文档索引

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

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

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

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

想要创建和分发你自己的市场？请参阅创建和分发插件市场。

市场工作原理

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

添加市场
将目录注册到 Claude Code，以便你可以浏览可用内容。此时不会安装任何插件。
安装单个插件
浏览目录并安装你想要的插件。

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

Anthropic 官方市场

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。然后重试安装。

Note

官方市场由 Anthropic 策展，收录由 Anthropic 自行决定。应用内提交表单将插件添加到社区市场而非官方市场。要独立分发插件，创建你自己的市场并与用户分享。

官方市场包含几类插件：

代码智能

代码智能插件启用 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 插件。

Note

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

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

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

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

如果遇到问题，请参阅代码智能故障排除。

外部集成

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

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

自动安全审查

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

开发工作流

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

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 上的社区市场托管了已通过 Anthropic 自动化验证和安全筛选的第三方插件。每个插件在目录中固定到特定的 commit SHA。与官方市场不同，你需要手动添加它：

/plugin marketplace add anthropics/claude-plugins-community

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

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

要将你自己的插件提交到社区市场，请参阅创建插件指南中的将你的插件提交到社区市场。

试一试：添加演示市场

Anthropic 还维护了一个演示插件市场（claude-code-plugins），包含展示插件系统功能的示例插件。与官方市场不同，你需要手动添加它。

添加市场
在 Claude Code 中，为 anthropics/claude-code 市场运行 plugin marketplace add 命令：
```
/plugin marketplace add anthropics/claude-code
```
这会下载市场目录并使其插件对你可用。
浏览可用插件
运行 /plugin 打开插件管理器。这会打开一个带四个标签页的界面，你可以使用 Tab（或 Shift+Tab 向后）循环切换：
- Discover：浏览你所有市场中的可用插件
- Installed：查看和管理你已安装的插件
- Marketplaces：添加、移除或更新你添加的市场
- Errors：查看任何插件加载错误
转到 Discover 标签页查看你刚添加的市场中的插件。
安装插件
选择一个插件查看其详情。详情面板显示插件包含的内容和成本：
- 上下文成本估算，让你看到插件每轮会为你的上下文窗口添加多少 tokens（Claude Code v2.1.143 及更高版本）
- 插件的最后更新日期（v2.1.144 及更高版本）
- 将安装部分，列出插件的命令、代理、技能、hooks 以及 MCP 和 LSP 服务器，让你在安装前确切查看它添加了什么（v2.1.145 及更高版本）
选择安装范围：
- 用户范围：为你自己跨所有项目安装
- 项目范围：为该仓库的所有协作者安装
- 本地范围：仅为你自己在此仓库中安装
例如，选择 commit-commands（一个添加 git 工作流技能的插件）并安装到你的用户范围。
你也可以直接从命令行安装：
```
/plugin install commit-commands@claude-code-plugins
```
参阅配置范围了解更多关于范围的信息。
使用你的新插件
安装后，运行 /reload-plugins 激活插件。插件技能按插件名称命名空间化，因此 commit-commands 提供像 /commit-commands:commit 这样的技能。
通过对文件进行更改并运行来试用：
```
/commit-commands:commit
```
这会暂存你的更改，生成提交消息并创建提交。
每个插件的工作方式不同。在 Discover 标签页中检查插件的详情以查看它提供的命令和技能，或访问其主页获取使用指导。

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

添加市场

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

Tip

快捷方式：你可以使用 /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 和自托管服务器。包含 .git 后缀以便 Claude Code 克隆仓库而非将 URL 视为指向托管 marketplace.json 文件的直接链接。

使用 HTTPS：

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

使用 SSH：

/plugin marketplace add [email protected]: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 添加

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

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

Note

基于 URL 的市场与基于 Git 的市场相比有一些限制。如果你在安装插件时遇到"path not found"错误，请参阅故障排除。

安装插件

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

/plugin install plugin-name@marketplace-name

要选择不同的安装范围，使用交互式 UI：运行 /plugin，转到 Discover 标签页，然后在插件上按 Enter。你会看到以下选项：

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

你可能还会看到具有 managed 范围的插件——这些是管理员通过托管设置安装的，无法修改。

Warning

安装插件前请确保你信任该插件。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 重新加载所有活动插件并显示插件、技能、代理、hooks、插件 MCP 服务器和插件 LSP 服务器的计数。

管理市场

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

使用交互式界面

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

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

使用 CLI 命令

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

列出所有已配置的市场：

/plugin marketplace list

从市场刷新插件列表：

/plugin marketplace update marketplace-name

移除市场：

/plugin marketplace remove marketplace-name

Warning

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

配置自动更新

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

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

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

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

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

要完全禁用 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"
      }
    }
  }
}

关于完整的配置选项（包括 extraKnownMarketplaces 和 enabledPlugins），请参阅插件设置。

安全

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

故障排除

/plugin 命令未被识别

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

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

常见问题

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

关于详细的故障排除和解决方案，请参阅市场指南中的故障排除。关于调试工具，请参阅调试和开发工具。

代码智能问题

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

后续步骤

构建你自己的插件：参阅插件创建技能、代理和 hooks
创建市场：参阅创建插件市场向你的团队或社区分发插件
技术参考：参阅插件参考获取完整规范

文档索引

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

市场工作原理

添加市场

安装单个插件

Anthropic 官方市场

代码智能

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

外部集成

自动安全审查

开发工作流

输出样式

社区市场

试一试：添加演示市场

添加市场

浏览可用插件

安装插件

使用你的新插件

添加市场

从 GitHub 添加

从其他 Git 主机添加

从本地路径添加

从远程 URL 添加

安装插件

管理已安装的插件

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

管理市场

使用交互式界面

使用 CLI 命令

配置自动更新

配置团队市场

安全

故障排除

/plugin 命令未被识别

常见问题

代码智能问题

后续步骤