安装与管理插件

安装插件会把它的 Skill、智能体、Hook 和 MCP 服务器加到你机器上的 Claude Code 里。本页面向在自己机器或账号上使用插件的人，无论是在终端、桌面应用、IDE 还是云端会话：讲安装、选择范围、添加市场，以及保持插件更新。

如果你用的是 claude.ai 聊天或 Cowork 而不是 Claude Code，见 claude.com 上的插件文档；Claude Code 打印了错误，去查官方的插件排障页。如果有人给你一条 @ 名字不是 claude-plugins-official 的安装命令，先添加那个市场。

安装插件

下面以从 Anthropic 官方市场安装 commit-commands（添加提交相关命令）为例。同样的步骤适用于任何其他插件：换上它的名字和它所属市场的名字即可；如果插件来自别的市场，先添加那个市场。

在终端里（在项目里用 claude 启动 Claude Code）：

1. 用安装命令打开插件详情：运行 /plugin install 加插件名和市场名。在会话里这条命令不会立即安装，而是打开 /plugin 面板的该插件详情，让你先审阅并选择范围：

   /plugin install commit-commands@claude-plugins-official

   想改为浏览，不带插件名运行 /plugin：面板打开 Discover 标签页，列出你添加的每个市场里的插件，可以输入搜索，对某个插件按 Enter 打开详情

2. 审阅插件加了什么：详情面板显示插件描述，还可能显示 Will install（插件添加的命令、智能体、Skill、Hook、MCP 和 LSP 服务器）、Last updated（官方市场里的插件），以及 Context cost（官方市场里的插件会给出两个 token 估算：Every turn 是插件给你每条消息增加的量，When invoked 是它的 Skill 和智能体被 Claude 加载后增加的量）。插件可以运行 Hook 和 MCP 服务器，所以安装前先读详情

3. 选择范围：三个安装选项——Install for you（用户范围）：你在这台机器的每个项目里都有这个插件；Install for all collaborators on this repository（项目范围）：对在这个仓库里工作的每个人启用；Install for you, in this repo only（本地范围）：只在这个仓库里对你启用。选定范围后，Claude Code 会连同它声明的依赖一起安装插件，并打印安装摘要

4. 阅读安装摘要：摘要的最后一句告诉你插件在当前会话里是否可用：Plugin is now active.（立即生效，无需重新加载）；活动但自带的 MCP 服务器需要配置；Run /reload-plugins to activate.（面板关闭，Claude Code 替你运行重新加载）；The plugin couldn't be loaded（到 /plugin 的 Errors 标签页看原因）

5. 确认插件可用：输入 /，在插件名下找它的 Skill，形如 /<plugin>:<skill>；对 commit-commands，会出现 /commit-commands:commit。也可以打开 /plugin 的 Installed 标签页，或在 shell 里运行 claude plugin list

在桌面应用里（本地或 SSH 会话的 Code 标签页）：点提示框旁的 + 按钮，选 Plugins，再选 Add plugin，找到插件并选它，然后选择范围。之后想启用、禁用或卸载，用 + > Plugins > Manage plugins；桌面应用的云端会话里没有插件浏览器。

在 VS Code 里：在提示框输入 /plugins 打开 Manage plugins，在 Plugins 标签页搜索插件并点 Install（如果标签页没列出任何插件，先在 Marketplaces 标签页添加 anthropics/claude-plugins-official），然后选择范围。改动无需重启就应用到打开的会话。

云端会话（包括 claude.ai/code 的浏览器）没有插件浏览器，也不会加载你在自己机器上安装的插件。

选择安装范围

插件的安装范围决定谁得到这个插件，以及哪个设置文件把它记录为已启用：

• 用户范围：插件对你在这台机器的每个项目里启用。条目写在 ~/.claude/settings.json 的 enabledPlugins 里
• 项目范围：插件对在这个仓库里工作的每个人启用。条目写在你提交的 .claude/settings.json 里。提交这个条目会为协作者启用插件，但并不会把它下载到他们机器上
• 本地范围：插件只在这个仓库里对你启用。条目写在 .claude/settings.local.json

有些插件被作者设为默认关闭（通过 defaultEnabled 字段），这种插件安装后保持关闭，直到你用 claude plugin enable <name> 打开。同一个插件在多个范围都有设置时，本地设置覆盖项目设置，项目设置覆盖用户设置。同一台电脑上的终端、桌面应用本地会话和 VS Code 扩展读取同样的设置文件，所以你在其中任何一个里按用户范围安装的插件，在另外两个里也可用。

JetBrains IDE 没有自己的插件浏览器（它的插件在 IDE 终端里运行 Claude Code，用终端标签页的步骤）；claude -p 等非交互运行里 /plugin 不运行，已安装的插件会加载，用 shell 里的 claude plugin 命令安装和管理；Agent SDK 通过 SDK 的 plugin 选项加载插件。如果你是在测试磁盘上插件副本的插件作者，用 --plugin-dir 启动 Claude Code，为一个会话加载它而不是安装它。

来自你 claude.ai 账号的插件：你的 claude.ai 账号是和你安装来源的市场并列的另一个插件来源：你为 claude.ai 账号打开的每个插件，以及你的组织为其成员打开的每个插件，都会在你以该账号登录时于每次启动 Claude Code 时后台同步。官方原文还涵盖添加市场的各种方式、更新、自动更新、禁用与卸载插件的命令。