插件
一旦整个团队都在使用它,一个您信任的配置就会变得更有价值。问题在于如何传播它。您搭建了一个出色的 .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 目录中的各个部分复制到插件自己的文件夹中:
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.jsonHooks 是唯一会脱离 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,保存着名称、版本、描述和作者:
{
"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。一个清单,一次安装。
这就是全部要点。一个可安装的单元,让您信任的配置触达您的整个团队。