文章

Claude Code plugin 安全安装:装之前先看哪些文件

一个 Claude Code plugin 可能同时带进 skill、hook 和 MCP server,有些会在你没下命令时自己运行程序。这篇从在官方目录找 plugin 开始,教你安装前要打开哪些文件、怎么选安装范围,以及装了之后怎么禁用和卸载。

Claude Code plugin 安全安装:装之前先看哪些文件

Claude Code(在终端里使用的 AI 编程助手)的 plugin 是一整套扩展功能。装一次,就可能同时带进 skill、斜线命令、hook 和 MCP server,各自的意思见下一节。

方便的地方,正好也是我觉得要小心的地方。其中几样会在你没下任何命令时自己运行程序,用的还是你的账号权限。官方在安装前会显示这段提醒(我的中文翻译):

Plugin 可以在你的电脑上运行程序,并访问你的文件和 shell。安装、更新或使用 plugin 之前,请确认你信任它。Anthropic 无法控制 plugin 包含哪些 MCP server、文件或其他软件,也无法验证它们会按预期运行,或者日后不会改变。详情请查看各 plugin 的主页。

读到“确认你信任它”,我的第一个疑问是:到底要怎么确认?我把官方的几份文档读了一遍,整理成装 plugin 前后照着做的检查方法。

这篇不推荐任何 plugin。文中“我会怎么做”的部分,都是根据官方文档列出来的步骤。

依据的官方文档查证于 2026-11-14(台北时间):安装与管理 plugin、plugin 概览、plugin 参考手册、plugin 安全说明、组织管理、市场参考手册。市场的部分另外读了 anthropics/claude-plugins-official 的 README 和市场清单。2026-11-17 我又对照上述页面修正了部分说法,并根据当天的 mod 概览 和 mod 管理说明 补充了 mod 的部分。终端命令对照过 Claude Code 2.1.325 的 --help(plugin validate 对照 2.1.326)。命令和界面会随版本变化,请以你安装的版本为准。

第三方扩展为什么会带来风险,我在装了第三方 skill 和 MCP 之后,你的 Coding Agent 多了哪些破口?里讲过。这篇只处理 plugin 的具体检查步骤。

先认识几个名词

  • plugin:一套 Claude Code 扩展功能,可能同时包含下面几种东西。完整名称写成“plugin 名称@市场名称”。
  • 市场(marketplace):plugin 的目录。Claude Code 要先认识一个市场,才能从里面安装 plugin。Anthropic 的官方市场叫 claude-plugins-official,第一次打开 Claude Code 的交互界面时会自动加入。
  • skill:一份写给 Claude 看的操作说明(SKILL.md),Claude 遇到相关工作时会照着做。
  • 斜线命令:在 Claude Code 输入框里以 / 开头的命令,例如 /plugin。
  • hook:在固定时机自动执行的 shell 命令,例如 Claude 每次改完文件就自动排版。用法见Claude Code hooks 教程:自动排版、跑测试与敏感文件提醒。
  • MCP server:让 Claude 连接外部工具或服务的小程序,例如数据库、GitHub 或文档搜索。它可能是一个在你电脑上启动的程序,也可能只是一个网址。
  • shell:终端里负责执行命令的程序。能执行 shell 命令,就几乎能做你在终端里做得到的任何事。

一个 plugin 带进的东西:有些会在沙箱外运行程序

plugin 是一个文件夹,文件按用途放在固定位置。根据官方的参考手册和安全说明,这些文件可以分成两类:只给 Claude 读的文字,以及会运行程序的部分。

位置是什么会自己运行程序吗
.claude-plugin/plugin.jsonplugin 的名片:名称、版本、作者、主页、许可证。也可以直接写入 hook、MCP server 等组件,或指向其他位置的配置文件本身不会,但它声明的 hook 和 server 会
skills/、commands/、agents/写给 Claude 的说明(Markdown 文件)不会,但会影响 Claude 接下来怎么做
hooks/hooks.json在固定时机执行的 shell 命令会,时机一到就执行
hooks/hooks.json 里的 modules(mod)指向一个 JavaScript 文件(例如 register.js),在 Claude Code 里面运行会,还能改写 Claude 的工具调用
monitors/monitors.json在后台持续运行的命令会
.mcp.jsonMCP server 配置:要启动哪个程序,或要连接哪个网址会,本地的 server 由 Claude Code 启动
.lsp.json语言服务器(提供代码跳转、错误提示的后台程序)会
bin/可执行文件,plugin 启用期间 Claude 可以直接调用Claude 调用时才运行,会经过权限规则

官方安全说明里,我认为最该记住的是这一点:Claude Code 的权限规则和沙箱,管的是 Claude 自己发出的工具调用,不管 plugin 自己运行的程序。hook、monitor、MCP server、LSP server 和 mod 都在沙箱外,以你完整的用户权限运行。

我在Claude Code 沙箱设置教程:挡住 SSH 密钥与 token里介绍过怎么开 /sandbox。但就算开了,plugin 的 hook 和 mod 还是在沙箱外面跑。

还有一点容易误解:plugin.json 不是必需的文件。官方说它可以省略;就算有,也只有 name 必须填写,作者、主页、许可证这些字段都可能是空的。所以字段空着不代表它有问题,填得很完整也不代表可以放心。

一个 plugin 里的文件分两类:skills、commands、agents 只给 Claude 读;hooks、mod、monitors、.mcp.json、.lsp.json 会在沙箱外运行程序,bin/ 要等 Claude 调用才运行 概念图:左边是给 Claude 读的文字,右边是会运行程序的部分。安装前要逐一打开右边的文件,标成黄色的 plugin.json 也要看,它可能直接声明 hook 与 MCP server。

官方目录能防冒名,不代表每个 plugin 都审查过

看到“官方”两个字,很容易以为里面的 plugin 都经过 Anthropic 审查。我读了官方 plugin 目录的 README 和清单文件,才确定范围没有这么大。

这个目录是 GitHub 上的 anthropics/claude-plugins-official。这个 repo 同时是两样东西。它存放 plugin,也放着 claude-plugins-official 市场的清单文件 .claude-plugin/marketplace.json。

repo 里有两个放 plugin 的文件夹,README 是这样说明的:

  • /plugins:Anthropic 自己开发和维护的 plugin。每次有人提出修改,这里的每个文件夹都会被检查。
  • /external_plugins:在投稿渠道改到 claude.ai/directory/manage 之前加入的第三方 plugin。另外还有 Anthropic 的频道类 plugin(Discord、fakechat、iMessage 和 Telegram)。

不过,市场清单里的 plugin 大多不在这两个文件夹里。我在 2026-11-14 打开 marketplace.json 时,它列了 317 个 plugin。放在这个 repo 里的只有 55 个,其余 262 个都在 repo 外:

plugin 放在哪里数量
这个 repo 的 /plugins41
这个 repo 的 /external_plugins14
其他公司或开发者自己的 repo261
要在你的电脑上执行命令来获取1

README 写得很直接:这个 repo 的检查覆盖放在这里的 plugin 文件夹,不覆盖放在其他 repo 的 plugin。

官方文档也提醒,市场的名称告诉你这份目录是谁发布的,不代表里面每个 plugin 做了什么。所以不管来自哪个市场,安装前都要检查。安装前的那段提醒也不分市场,内容都一样。

官方目录能帮你少装到冒名的假货。claude-plugins-official 这类官方名称,Claude Code 只接受来自 github.com/anthropics/ 的来源。其他人无法用同样的名称发布市场。

但这不等于每个 plugin 都通过了安全审查。从官方目录装的 plugin,我一样会按后面的步骤检查。

查出 plugin 实际放在哪里

既然多数 plugin 放在别的 repo,装之前一定要先查这件事。在 marketplace.json 里找到 plugin 的条目,看它的 source 字段:

flowchart TD
  A["条目的 source 字段"] --> B{怎么写?}
  B -->|"./plugins/… 或 ./external_plugins/…"| C[官方 repo 的这个文件夹]
  B -->|"对象,source 是 url"| D["url 指向的 repo"]
  B -->|"对象,source 是 git-subdir"| E["url 的 repo 里的 path"]
  D --> F["检查 sha 那一版"]
  E --> F

条目的结构大致如下(数值仅为示意):

1
2
3
4
5
6
7
8
9
10
11
12
{
  "name": "example-plugin",
  "author": { "name": "Example Inc." },
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/example-org/claude-plugins.git",
    "path": "plugins/example-plugin",
    "ref": "v1.2.0",
    "sha": "<40 个字符的 commit SHA>"
  },
  "homepage": "https://example.com"
}

sha 是一个 commit 的编号,代表代码在某一次提交时的样子。根据市场参考手册,条目同时写了 ref 和 sha 时,Claude Code 会检出 sha 这一版。

所以要检查的是那个 commit 的文件,不是对方 repo 现在的最新版。在 GitHub 上,我会用 https://github.com/<账号>/<repo>/tree/<sha>/<path> 这种网址打开那一版的文件夹。

条目也不只是一张索引卡。根据市场参考手册,条目本身也可以写组件字段,效果要看 plugin 有没有 plugin.json:

条目里的字段plugin 有 plugin.jsonplugin 没有 plugin.json
commands、agents、skills、outputStyles、themes默认合并进 plugin.json加载
hooks默认合并进 plugin.json,并按事件替换 plugin.json 里同一个事件的配置加载
mcpServers、lspServers不生效加载

plugin 没有 plugin.json 时,条目就直接当作它的配置文件。条目里如果有这些字段,我也会一起看。

步骤 1:在 /plugin 找到 plugin,先看详细信息

找 plugin 时,我会先打开 plugin 管理界面。在 Claude Code 的输入框里输入:

1
/plugin

根据官方文档,界面会打开在 Discover 标签页,列出你已加入的市场里的 plugin。直接打字可以搜索,按 Enter 打开详细信息。其他标签页是 Installed(已安装)、Marketplaces(已加入的市场)和 Errors(加载错误)。

已经知道名称的话,也可以直接输入:

1
/plugin install <plugin 名称>@claude-plugins-official

在对话里执行这行不会马上安装。它会先打开同一个详细信息面板,让你选好安装范围再确认。

详细信息面板有一个 Will install 区域,列出这个 plugin 会装进哪些命令、agent、skill、hook,以及 MCP 和 LSP server。先看这里有没有 hook、MCP server 或 LSP server。有的话,装了之后就会有程序自动运行,后面的检查要更仔细。

官方市场里大多数 plugin 放在其他 repo。Anthropic 没有这种 plugin 的组件信息时,这个区域可能只显示 Component summary not available for remote plugin。遇到这种情况,就直接按步骤 2 去看源文件。

就算这个区域列出了组件,官方也说明它只告诉你“有 hook”,不告诉你 hook 会执行什么。所以不管这里列了什么,下一步都是去读源文件。

步骤 2:装之前,打开这几个文件

在详细信息面板选 Open homepage 或 View on GitHub,可以打开源代码。两个选项都没有的话,就回到市场的 repo,用“查出 plugin 实际放在哪里”的方法找到 plugin 的文件夹。市场当初是从哪里加入的,可以在终端里用这行确认:

1
claude plugin marketplace list

第一个要打开的一定是 plugin.json。它可以把 hook、MCP server、LSP server 和 monitor 直接写在里面,或指向其他路径的配置文件。所以默认位置找不到某个文件,不代表 plugin 没有那项功能;先看 plugin.json 声明了什么,才知道还要打开哪些文件。

.claude-plugin/plugin.json:谁做的、还声明了什么

先看 author、homepage、repository 和 license,确认主页和 repo 字段指向的,就是你正在看的 repo。名称很像、账号却不一样的,我会先停下来查清楚是谁。

再来看它有没有声明组件或依赖。下面这份是我写的示例:

1
2
3
4
5
6
7
8
9
10
{
  "name": "example-plugin",
  "author": { "name": "Example Inc." },
  "homepage": "https://example.com",
  "hooks": "./config/hooks.json",
  "mcpServers": {
    "example-api": { "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"] }
  },
  "dependencies": ["example-helper"]
}

这份文件我会这样读:

  • hooks 指向 config/hooks.json,不在默认的 hooks/hooks.json。两个位置的 hook 会合并加载,所以两个文件都要看。
  • mcpServers 直接写在 plugin.json 里,安装后会启动 server.js。lspServers 和 experimental.monitors 也能这样写,读法跟后面的 hooks/hooks.json 和 .mcp.json 一样。
  • dependencies 列出这个 plugin 依赖的其他 plugin。根据官方文档,安装时 Claude Code 会以同样的范围把它们一起安装并启用,所以 example-helper 也要按这篇的步骤检查一次。
  • 依赖的写法决定它从哪里来。只写名称的依赖从同一个市场获取;写成 名称@市场 的来自另一个市场,这种跨市场的依赖默认不会自动安装,除非市场明确允许。

hooks/hooks.json:什么时候、自动执行什么

如果只能挑一个文件细看,我会挑这个。每个 hook 都看两件事:事件名称(什么时候执行),以及它执行什么。

要看哪个字段,取决于 type。type 是 command 时看 command 字段;是 http 时看 url,事件内容会发送到那个网址。type 也可能是 mcp_tool、prompt 或 agent。

结构大致如下(内容仅为示意):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          { "type": "command", "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/setup.sh\"" }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/format.sh\"" }
        ]
      }
    ]
  }
}

这份配置逐项这样看:

  • SessionStart:每次打开 Claude Code 就执行 setup.sh,不需要你做任何事。恢复之前的对话、执行 /clear 或对话被压缩时,也会再执行。
  • PostToolUse 加上 "matcher": "Edit|Write":Claude 每次用 Edit 或 Write 工具改完文件,就执行 format.sh。
  • ${CLAUDE_PLUGIN_ROOT} 代表 plugin 安装后所在的文件夹。命令只写“去执行某个脚本”时,要把那个脚本也打开来看,真正做事的是它。

hook 有下面这些行为时,我会先停下来弄清楚原因:

  • 用 curl、wget 下载东西后直接执行
  • 把文件内容或环境变量发送到外部网址
  • 删除或修改项目以外的文件
  • 读取 ~/.ssh、.env 这类存放密钥的位置

这些不一定是恶意的。有些 hook 本来就会把代码片段发送到外部服务分析,通常会写在 README 里。我在意的是自己知不知道它会这么做,以及能不能接受。

hooks.json 里的 modules:在 Claude Code 里面运行的 mod

hooks.json 如果有 "modules": ["./register.js"] 这样的字段,说明这个 plugin 带了 mod。mod 是一个在 Claude Code 里面运行的 JavaScript 程序,不在沙箱里。

根据官方的 mod 说明,它能做到这些事:

  • 用你的权限读写文件、启动程序、连接网络
  • 读到环境变量和配置文件里的 API key
  • 看到你发送的每一条消息和 Claude 的每一次工具调用,并且改写它们
  • 内置的防护没有拦住时,批准原本会被你的 deny、ask 规则或 PreToolUse hook 拦下的工具调用

所以 plugin 带了 mod,我会看得比 hook 更仔细。后面介绍的 plugin details 组件清单不会列出 mod。官方提供的检查方法是先获取 plugin 的文件(例如 clone 下来),再对 plugin 文件夹执行:

1
claude plugin validate <plugin 文件夹>
flowchart TD
  A[执行 plugin validate] --> B{报错了吗?}
  B -->|有| C[不要装]
  B -->|没有| D["看 hooks: 和 calls:"]
  D --> E[读那个 JavaScript 文件]

报错的 mod 不要装,这是官方的提醒,因为有些错误不会阻止它加载。输出里的 hooks: 列出 mod 会接收哪些事件,calls: 列出它会调用哪些功能,例如:

  • $.fs.read:读文件
  • $.process.run:启动程序
  • $.http.fetch:联网
  • $.env.get:读环境变量

.mcp.json:会启动哪些程序、连到哪里

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "mcpServers": {
    "example-docs": {
      "type": "http",
      "url": "https://mcp.example.com/mcp"
    },
    "example-db": {
      "command": "npx",
      "args": ["-y", "@example/db-mcp@1.4.2"],
      "env": { "DB_URL": "${DB_URL}" }
    }
  }
}

这份配置,我会按字段分开看:

  • 有 url 的 server 会连接外部网址。我会确认域名是不是那个服务本身,因为你在 Claude 里通过它查询或发送的内容,都会传到那个网址。
  • 有 command 的 server 会在你的电脑上启动程序。npx -y 包名 会从 npm 下载并运行那个包。
  • 我希望看到写死的版本号(例如 @1.4.2)。没写版本或写 @latest,每次启动都可能跑到不同的程序。
  • env 列出它需要哪些环境变量,通常就是 token 或密码。我给它的权限,只限于它真正需要的范围。

bin/、monitors/ 和 .lsp.json

  • bin/ 里的每个文件都要看。plugin 启用期间,这些文件会被放进 Claude 执行命令时的搜索路径(PATH),Claude 可以像普通命令一样直接调用它们。
  • monitors/monitors.json 是在后台运行的命令,读法跟 hook 一样,看每一个 command。
  • .lsp.json 会启动语言服务器,看它启动的是哪个程序。

skills/、commands/、agents/:快速扫一遍

这些是给 Claude 读的说明,本身不会执行,但说明可以让 Claude 去执行命令。我会快速扫一遍,留意这几种段落:

  • 要 Claude 下载并执行东西
  • 要 Claude 把数据传到外部
  • 要 Claude 跳过你的规则

这类藏在内容里的指令,装了第三方 skill 和 MCP 之后,你的 Coding Agent 多了哪些破口?的“入口一”有详细说明。

用一行命令核对组件清单

自己翻文件夹,难免有漏看的时候。官方安全说明提供了一个核对方法:用 plugin details 列出 Claude Code 在 plugin 文件夹里找到的组件。先把 plugin 所在的 repo clone 下来,切到市场条目里写的 commit,再执行:

1
2
3
4
git clone https://github.com/example-org/claude-plugins.git
cd claude-plugins
git checkout <市场条目里的 sha>
claude --plugin-dir ./plugins/example-plugin plugin details example-plugin

它会打印出 Component inventory(组件清单),列出 skill 和命令、agent、hook(含触发事件)、MCP server 和 LSP server。我会拿它对照刚才看过的文件,有漏看的就回去补上。

这份清单没有覆盖全部,下面这些要另外看:

  • monitor、bin/ 里的文件和 mod 不在清单里,要自己打开来看。
  • 清单列的是这个文件夹里的组件。市场条目另外加上的组件,要回去看条目。
  • dependencies 里的其他 plugin,要各自检查。

装好之后,也可以用这行检查实际安装的那一份:

1
claude plugin details <plugin 名称>

可复制的检查清单

上面的检查整理成一份清单,可以直接贴进笔记或团队文档:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
## Claude Code plugin 安装前检查

- [ ] 从市场条目的 source 和 sha,确认 plugin 实际放在哪个 repo、哪个 commit
- [ ] plugin.json 的作者、主页、repo,和我正在看的来源一致
- [ ] plugin.json 有没有直接声明 hooks、mcpServers、lspServers、monitors,或指向其他路径的配置文件;市场条目有没有另外写组件字段
- [ ] dependencies 列出的每个 plugin,都按这份清单检查过
- [ ] 详细信息面板的 Will install:有没有 hook、MCP server、LSP server
- [ ] hooks/hooks.json:每个 hook 的触发时机和 command(http hook 看 url),以及它调用的脚本
- [ ] hooks.json 有没有 modules(mod);有的话用 claude plugin validate 列出 hooks 和 calls,并读过那个 JS 文件
- [ ] .mcp.json:每个 server 启动的程序(版本有没有写死)或连接网址,需要哪些环境变量
- [ ] bin/、monitors/、.lsp.json:每个会运行的文件
- [ ] skills/、commands/、agents/:没有要 Claude 下载执行、外传数据或跳过规则的内容
- [ ] 用 claude --plugin-dir <文件夹> plugin details <名称> 核对过 hook、MCP server 和 LSP server
- [ ] 决定安装范围(local、user 或 project)和要不要自动更新

安装前的四项检查:确认来源、看详细信息、读会运行程序的文件、用 plugin details 核对 hook、MCP 和 LSP,最后从最小范围安装 概念图:四项检查都在安装之前完成。第三项只看得到你打开的文件,第四项用组件清单核对 hook、MCP 和 LSP server;monitor、bin/ 和 mod 仍要自己看。

步骤 3:从最小的安装范围开始

在详细信息面板按下安装时,要选择安装范围(scope):

范围谁会用到写进哪个配置文件
Local只有你,而且只在这个 repo.claude/settings.local.json
User你自己,这台电脑上的所有项目~/.claude/settings.json
Project这个 repo 的所有协作者.claude/settings.json(会提交进 repo)

第一次用的 plugin,我会按这个顺序扩大范围:

flowchart LR
  A[第一次用的 plugin] --> B["Local:在一个项目里试用"]
  B -->|其他项目也要用| C[User]
  B -->|整个团队要用| D["Project:走代码审查"]

Project 范围的审查做法,见后面的“把检查清单放进团队规则”。在终端里安装的写法如下,不加 --scope 时默认是 user:

1
claude plugin install <plugin 名称>@claude-plugins-official --scope local

安装前,先记住三件事:

  • 安装就等于启用。 除非 plugin 自己设置了 defaultEnabled: false,装好它就开始工作。
  • 依赖会一起装。 plugin 声明了依赖的话,Claude Code 会以同样的范围一起安装并启用,完成信息会列出它们。
  • Project 范围不会自动装到同事的电脑上。 配置提交进 repo 之后,每位协作者仍要自己执行一次安装。

加入其他市场之前,先确认来源

除了官方市场,任何人都可以创建市场。加入市场要比装单个 plugin 更谨慎,因为加入之后,里面的每个 plugin 都能用一行命令装进来。加入市场的命令是:

1
/plugin marketplace add <来源>

来源可以是这几种:

  • GitHub repo,写成 owner/repo。可以用 # 指定标签或分支,例如 your-org/plugins#v1.2.0。
  • 其他 Git 托管平台的完整网址,例如 https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0。
  • 本地文件夹的路径。
  • 指向 marketplace.json 的 https:// 网址。

加入之前,我会先确认这几件事:

  • 这个 repo 是谁的。 只从信任的地方获取链接,例如工具的官方网站或官方文档,不只看搜索结果。名称相似的账号并不少见。
  • 有没有指定版本。 加上 #v1.2.0 这类标签,市场内容就不会随对方每次提交而改变。不过标签本身可以被移动(原理见gh actions-lock 教程:用 lockfile 锁定 GitHub Actions 依赖),所以它只能让变动少一点。
  • 一行安装命令也可能顺便加入市场。 在对话里输入 /plugin install <名称> --marketplace owner/repo 时,若市场还没加入,Claude Code 会先显示来源让你确认。在终端里执行 claude plugin install <名称> --marketplace owner/repo 则不会询问,直接加入市场。看到别人贴这种命令,一样要先确认 owner/repo 是谁。

自动更新会换掉你看过的文件

根据官方文档,Anthropic 的官方市场(例如 claude-plugins-official)默认会自动更新。其他市场,包括第三方市场和本地市场,默认不会。

开启自动更新时,Claude Code 会在后台更新从这个市场安装的 plugin。所以你审查过的文件,可能在你不知道的时候被换掉。

要关闭某个市场的自动更新,在 /plugin 切到 Marketplaces 标签页,选择市场,再选 Disable auto-update。

关掉的代价是不会自动拿到修复,所以我不会全部关掉。我只对第三方或不熟悉的市场关闭自动更新,改成定期手动更新:

flowchart LR
  A[比对新旧 sha 的差异] --> B[看配置文件与新依赖]
  B --> C[执行 plugin update]
  C --> D[重新加载后生效]

比对差异的网址是 https://github.com/<账号>/<repo>/compare/<旧 sha>...<新 sha>。比对时特别看 plugin.json、hooks/hooks.json、.mcp.json 和新增的依赖。手动更新的命令是:

1
claude plugin update <plugin 名称>@<市场名称>

更新后要重启 Claude Code,或在对话里执行下面这行,才会生效:

1
/reload-plugins

装了之后:先禁用,确定不用再卸载

我会先确认自己到底装了什么。这行会列出每个 plugin 的版本、安装范围和状态:

1
claude plugin list

处理方式由轻到重有三种:禁用、卸载 plugin、移除整个市场。

装了之后的三种处理:禁用会保留文件;卸载时依赖会留着、cache 留 14 天;移除市场会连同装过的 plugin 一起卸载;另外提醒自动更新会换掉看过的文件 概念图:由轻到重的三种处理方式。怀疑出事时先禁用,确定不用了再卸载。

禁用:文件还在,之后可以重新启用

暂时不用,或者怀疑它有问题时,我会先走这一步。在 /plugin 的 Installed 标签页选中 plugin 后按空格键,或输入下面这行打开面板操作:

1
/plugin disable

在终端里则是:

1
claude plugin disable <plugin 名称>@<市场名称>

禁用后文件还在,之后可以用 claude plugin enable 重新启用。如果还有其他启用中的 plugin 依赖它,禁用会失败,并列出要先禁用哪些。

遇到不明状况、想先全部停下来,可以用这行禁用所有 plugin:

1
claude plugin disable --all

卸载:范围要和安装时一样

在输入框里输入:

1
/plugin uninstall

或在终端里执行:

1
claude plugin uninstall <plugin 名称>@<市场名称> --scope <当初的范围>

--scope 要和安装时一样,不写的话默认是 user。卸载时有几件事要特别留意:

  • 从最后一个安装范围卸载时,plugin 的数据文件夹 ~/.claude/plugins/data/<id>/ 会一起删除。plugin 保存的选项和密钥也会跟着删掉。加上 --keep-data 才会保留文件夹。
  • 程序文件本身会在 ~/.claude/plugins/cache/ 多留 14 天,才由后台清理删除。确定不再信任它,我会自己删掉 ~/.claude/plugins/cache/<市场名称>/<plugin 名称>/。
  • 当初跟着安装的依赖不会一起卸载。加上 --prune 会一并卸载没有其他 plugin 需要的依赖,之后也可以用这行清理:

    1
    
    claude plugin prune
    
  • Project 范围的 plugin 在界面上卸载时,会问你要选 Disable for me 还是 Uninstall for everyone。前者只对自己禁用,写进你的 .claude/settings.local.json。后者从共享的 .claude/settings.json 里去掉,影响所有协作者。

卸载 plugin 不会让曾经交给它的 token 失效。如果是因为怀疑 plugin 有问题才卸载它,我会把这些 token 也换掉。后续处理可以参考装了第三方 skill 和 MCP 之后,你的 Coding Agent 多了哪些破口?的“出事之后”清单。

移除市场:连同装过的 plugin 一起卸载

在输入框里输入:

1
/plugin marketplace remove <市场名称>

从这个市场安装的所有 plugin 会一起被卸载。

把检查清单放进团队规则

团队里每个人都可能装 plugin,只有我一个人小心还不够,要有共同的做法。我会从三个层面着手。

写进项目规则

我会把上面的检查清单放进 CLAUDE.md、AGENTS.md 或 PR 模板,约定“新增 plugin 或市场时,要附上这份清单”。规则文件怎么写,我在AGENTS.md 怎么写:让 Coding Agent 读懂你的项目规则里整理过。

把配置文件当成代码来审查

项目要推荐 plugin 时,我会在 .claude/settings.json 写两个字段:

  • extraKnownMarketplaces:要认识哪些市场
  • enabledPlugins:要启用哪些 plugin
1
2
3
4
5
6
7
8
9
10
{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true
  }
}

这个文件会提交进 repo,所以我把改它当成改代码,一样要经过 PR 审查。也可以把它加进 CODEOWNERS(指定哪些文件由谁审核的配置文件),让熟悉这份检查清单的人负责批准。

官方文档另外说明了两点。第一,在 repo 里写了 enabledPlugins 不会自动安装,协作者要自己执行:

1
claude plugin install <名称>@<市场> --scope project

第二,extraKnownMarketplaces 只在协作者已经信任的文件夹里生效。

在组织层面限制市场来源

公司如果统一管理 Claude Code 的配置(managed settings),管理员可以限制市场来源。strictKnownMarketplaces 只允许特定来源,blockedMarketplaces 则屏蔽特定来源。官方的允许列表示例如下:

1
2
3
4
5
6
7
{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "anthropics/claude-plugins-official" },
    { "source": "github", "repo": "your-org/*" },
    { "source": "skills-dir" }
  ]
}

前两行只允许官方市场和公司自己账号下的市场。

第三行的 skills-dir 处理放在 skill 文件夹里的 plugin。~/.claude/skills/ 和项目 .claude/skills/ 里带有 .claude-plugin/plugin.json 的文件夹,会继续以 plugin 的形式加载。只有 SKILL.md 的普通 skill 不受这份清单影响。

管理员也可以设置 pluginTrustMessage,在安装前的提醒后面加上公司内部的说明,例如审查流程的链接。

什么情况怎么做

我想…怎么做
找 plugin/plugin 的 Discover 标签页;或用 /plugin install <名称>@claude-plugins-official 先打开详细信息
知道 plugin 实际放在哪看 marketplace.json 条目的 source 和 sha
知道装了会自动执行什么先看 plugin.json 声明的组件,再读 hooks/hooks.json、.mcp.json、bin/、monitors/、.lsp.json
知道 mod 会做什么claude plugin validate <文件夹>,看 hooks: 和 calls:,再读那个 JavaScript 文件
知道还会一起装哪些 plugin看 plugin.json 的 dependencies,每个都按清单检查
核对 hook、MCP、LSP 有没有漏看clone 后执行 claude --plugin-dir <文件夹> plugin details <名称>;monitor、bin/、mod 另外看
先小范围试用安装时选 Local
加入别的市场从官方链接确认 owner/repo,用 #标签 指定版本
不让看过的文件在后台被换掉/plugin → Marketplaces → Disable auto-update,改成手动更新并先看差异
暂时不用claude plugin disable <名称>@<市场>
怀疑出事,先全部停下claude plugin disable --all
完全卸载claude plugin uninstall <名称>@<市场> --scope <范围> --prune,需要时删掉 cache 文件夹
让团队做法一致检查清单写进项目规则,.claude/settings.json 走 PR 审查

结论

整理完这篇,我给自己定的规则只有一条:装 plugin 之前,先弄清楚它会在什么时候、用我的权限做什么事。官方目录和 Will install 只是起点,会运行程序的文件要自己读。确定要装,就从最小的范围开始。

想继续往下读,可以看我写的这几篇:

本文由作者按照 CC BY 4.0 进行授权