加载中
加载中

插件

一旦整个团队都在使用它,一个您信任的配置就会变得更有价值。问题在于如何传播它。您搭建了一个出色的 .claude 目录,里面有 skills、subagents 和 hooks,然后呢?每个人都在机器之间复制粘贴文件,并寄希望于它们保持同步。插件解决了这个问题。插件正是 Claude Code 用来打包配置并将其从一个人传递给下一个人的方式。

这件事有两面,我们会两面都讲。首先是使用别人发布的插件。其次是在您构建出值得分享的东西之后,如何打包自己的插件。

什么是插件

插件是一个可安装的单元。它打包了您原本需要手动分享的一切:skills、subagents、hooks,以及 MCP 服务器配置,再加上更长尾的内容,比如语言服务器协议(language server protocol)服务器、后台监控程序和主题。一个版本,一次安装。

插件所在的位置决定了您如何安装它。在一个会话中,您可以直接按名称安装一个:

/plugin install github@claude-plugins-official

该命令会先打开插件的详情,以便您查看并选择作用域。然后 Claude Code 会安装它并打印一段简短的摘要。它要么说该插件已经在此会话中处于活跃状态,要么提到 /reload-plugins,并由 Claude Code 为您执行该重新加载操作。只有在重新加载警告您的下一条消息将重新读取整个对话时,您才需要介入:运行 /reload-plugins --force 以强制激活插件。

为您的团队添加市场(marketplace)

对于团队来说,更好的做法是一次性添加一个私有市场(marketplace)。市场是插件借以解析的共享来源:

/plugin marketplace add your-org/claude-plugins

您可以随意命名它。添加之后,此后的每次安装都会通过它来解析。您将获得集中化的发现、版本跟踪和更新,而不是散落在每个人的笔记本电脑上。

您可以从 Discover 标签页浏览可用内容。它会列出您的市场上的插件,方便您搜索和选择。

安装前请先阅读

这是最重要的部分。插件会以您的权限在您的机器上运行代码。它的 hooks 会在每次匹配的工具调用时触发。所以,如果您因为某个插件的 skills 而安装它,无论您是否阅读过,您也会一并获得它的 PreToolUse 和 Stop hooks。

想想这意味着什么。一个社区插件可能附带一个 Stop hook,每次都会调用某个网络端点,而您的配置中不会有任何内容警告您这一点。这不是要您避开插件的理由,而是要您先看一看的理由。

在安装之前,查看插件的详情。Claude Code 会向您展示它将安装的内容,并估算上下文成本,同时附上一条明确的提示:Anthropic 并不控制第三方插件内部的内容。

关于插件的来源,有两点值得了解:

  • 插件能出现在社区市场上,是因为编写它的人把它提交给了 Anthropic。
  • 官方市场则在自己独立的审核流程上进行策划。

但被列出并不等于值得信任。所以规则依然成立:只从您真正信任的来源安装插件和添加市场,并在启用之前先检查插件实际会做什么。

组件与您自己的组件并行运行

插件不会覆盖您的配置。它的组件与您自己的组件并行运行。这在大多数情况下是好事,但它也带来了一些您应该了解的后果。

Hooks 会叠加。插件的 PreToolUse hook 和您自己的 PreToolUse hook 会在每次工具调用时都触发。两者互不替代。这正是您要先阅读详情的原因。

Skills、agents 和 commands 都以插件名称命名空间化,因此它们永远不会与您的发生冲突。

一旦插件安装完成,您就可以从插件面板中查看它添加的一切内容,对其进行管理,并将其卸载。

打包您自己的插件

现在来看另一面。一旦您搭建出一个可用的 .claude 目录,不要让您的团队在机器之间复制粘贴它。把它打包起来。

好消息是,您不必重写任何东西。您只需将 .claude 目录中的各个部分复制到插件自己的文件夹中:

text
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.json

Hooks 是唯一会脱离 settings.json 的部分:把 hooks 对象复制到 hooks/hooks.json 中。其余部分 Claude Code 会按约定自动发现。在分享插件之前,您可以用它所在的文件夹启动一个会话来试用它:

claude --plugin-dir ./svg-splitter-review

一旦它能正常工作,就从 .claude 中删除原件,并从 settings.json 中取出 hooks 对象。在您这样做之前,每个 hook 都会运行两次。

清单(manifest)

除此之外,还有一个可选的清单(manifest)。它位于 .claude-plugin/plugin.json,保存着名称、版本、描述和作者:

json
{
  "name": "svg-splitter-review",
  "version": "0.1.0",
  "description": "Reviews the SVG Splitter repo",
  "author": {
    "name": "Lewis Menelaws"
  }
}

这个清单是可选的。省略它,Claude Code 仍会按目录约定发现您的组件。但有几个细节值得了解:

  • 名称是唯一必填的字段。 它会将您的 skills 命名空间化为 /plugin-name:skill-name,所以该插件中的某个 skill 会以 /svg-splitter-review:<skill-name> 的形式运行。这样可以确保您的 skills 不会与任何人的发生冲突。
  • 像对待任何其他依赖一样为其设置版本号。 这正是让更新和版本跟踪能够在您的团队中正常工作的原因。

要点

两条简单的规则涵盖了这一切中的大部分内容:

  • 使用插件时,先阅读再安装。插件会以您的权限运行代码,所以要先看看它的 hooks、agents 和 MCP 服务器。
  • 构建插件时,一旦它可用就立即打包您的 .claude。一个清单,一次安装。

这就是全部要点。一个可安装的单元,让您信任的配置触达您的整个团队。