插件（Plugins） 是 Claude Code 把 Skills、Agents、Hooks、斜杠命令、MCP Server 打成一个包的能力分发单元，用来解决配置散落、没法分享、没法版本化的问题。
一句话 ：装插件一条命令，写插件一份 plugin.json。
- 五类组件：Skills、Agents、Hooks、命令、MCP Server 能打进同一个插件。
- 市场已可用 ：官方市场
claude-plugins-official有 6 个插件，装完即生效。 - 自研极简 ：manifest 只必填
name、version，本地--plugin-dir就能测。 - 质量可测 ：
claude plugin eval（v2.1.269 起）安装前先看评分。
依据：code.claude.com（插件文档与更新日志）、claude.com/plugins（官方市场）｜核对日期 2026-10-26｜适用 v2.1.269+
事实速览
| 事实 | 结论或取值 | 依据 |
|---|---|---|
| 插件的组成单元 | 5 类：Skills、Agents、Hooks、斜杠命令、MCP Server | code.claude.com |
| manifest 位置与必填字段 | .claude-plugin/plugin.json，必填 name、version |
code.claude.com |
| 组件路径字段 | skills / agents / commands / hooks / mcpServers |
code.claude.com |
| 官方市场安装命令 | claude plugin install <插件名>@claude-plugins-official |
claude.com/plugins |
| 官方市场插件数量与代表 | 6 个：Frontend Design、Superpowers、Code Review、Context7、Skill Creator、Code Simplifier | claude.com/plugins |
| 本地测试方式 | claude --plugin-dir ./my-plugin |
code.claude.com |
| eval 起始版本 | v2.1.269（2026-09-11 发布） | releasebot.io |
插件到底打包了哪五类能力？
说人话：插件是 Skills、Agents、Hooks、斜杠命令、MCP Server 的打包分发单元。以前学的东西，现在都能装进插件里。
拆开看就五类：
- Skill → 插件里的
skills/ - 斜杠命令 → 插件里的
commands/ - Hook → 插件里的
hooks/ - 子代理 → 插件里的
agents/ - MCP Server → 插件里的
mcp-servers/，manifest 字段叫mcpServers
打个比方：Skill 是一本菜谱，MCP 是一个新厨具，插件是整个厨房套装------装一次，全都有。
目录长这样：
perl
my-plugin/
├── .claude-plugin/
│ └── plugin.json # 插件清单（这个目录只放这一个文件）
├── skills/ # 技能
├── agents/ # 子代理
├── commands/ # 斜杠命令
├── hooks/ # 自动化钩子
└── mcp-servers/ # MCP 服务（可选）一个容易踩的坑：组件放插件根目录，.claude-plugin/ 里只放 plugin.json 。把 skills/ 塞进 .claude-plugin/ 里，插件就是不生效。
2026 年下半年，插件生态变了哪三件事？
插件从"极客玩具"变成"能放心用的生产力工具"，靠的是下半年落地的三件事，一件比一件实在。
- 官方市场成型 ：Anthropic 维护
claude-plugins-official市场，在 Claude Code 里直接浏览安装。 - 安全扫描上线：7 月底官方推出插件安全扫描，来路不明的插件风险小多了。
- 评测工具发布 ：9 月 11 日新增
claude plugin eval（v2.1.269 起），装之前就能给插件打分。
分别回答了"从哪装""敢不敢装""装得值不值"。
官方市场怎么装插件？三步走完
整个流程不用离开 Claude Code：先同步目录，再浏览，最后一条命令装完。
步骤 1：同步市场列表
目的是让本地拿到官方市场的最新插件目录，不然看到的可能还是旧列表。
bash
/plugin marketplace update claude-plugins-official预期：命令返回更新结果，市场列表刷新为最新目录。
步骤 2：浏览市场
目的是装之前先看清描述和状态，别装重了。
bash
/plugin预期：打开插件管理界面，能看到已装插件、市场插件列表和每个插件的描述。
步骤 3：安装
目的是把插件装进当前环境，装完即生效（v2.1.269 及以后可用）。
css
claude plugin install <插件名>@claude-plugins-official预期：返回安装成功，
claude plugin list里能看到它，不用重启 Claude Code。
比如装官方市场的 Code Review，把插件名换成 code-review：
css
claude plugin install code-review@claude-plugins-official官方市场这 6 个插件，后端先装哪个？
官方市场现在收录 6 个插件，前端、审查、文档、技能创作各有一个，后端开发者建议先上 Context7。
| 插件 | 用途 | 适合谁 |
|---|---|---|
| Frontend Design | 生成生产级前端界面 | 全栈开发者 |
| Superpowers | 头脑风暴 + 编码技能包 | 所有人 |
| Code Review | AI 代码审查，支持过滤 | 团队开发 |
| Context7 | 实时查询最新文档 | 框架使用者 |
| Skill Creator | 创建并评估自己的技能 | 想自定义的人 |
| Code Simplifier | 精简优化代码 | 维护老代码的人 |
后端开发者优先装 Context7。它让 Claude 直接查最新版框架文档，而不是用训练数据里的旧 API。Spring Boot、MyBatis 这种迭代快的框架，AI 最容易写旧版本语法，Context7 专门治这个。
claude plugin 的子命令有哪些？不用了该 disable 还是 uninstall？
命令族 claude plugin 覆盖了插件从初始化到评测的整个生命周期，一共 11 个子命令。
| 命令 | 作用 |
|---|---|
claude plugin init |
初始化新插件项目 |
claude plugin install |
安装插件 |
claude plugin uninstall |
卸载插件 |
claude plugin enable |
启用插件 |
claude plugin disable |
禁用插件 |
claude plugin update |
更新插件 |
claude plugin list |
列出已安装插件 |
claude plugin details |
查看插件详情 |
claude plugin validate |
校验插件配置 |
claude plugin eval |
跑插件评测套件 |
claude plugin tag |
给插件打标签 |
日常真正高频的就三个：install、update、disable。
结论：不用的插件用 disable，别 uninstall。插件多了影响启动速度和上下文占用，禁用比卸载快，想用随时开回来。
自己写一个插件，最少要几个文件？
最少一个：.claude-plugin/plugin.json。必填字段只有 name 和 version。
perl
my-plugin/
└── .claude-plugin/
└── plugin.json
json
{
"name": "my-plugin",
"version": "1.0.0"
}有内容了再加组件路径，每个字段指向根目录下对应的目录：
json
{
"name": "my-plugin",
"version": "1.0.0",
"skills": "skills",
"agents": "agents",
"commands": "commands",
"hooks": "hooks",
"mcpServers": "mcp-servers"
}字段名和目录名不用一致，mcpServers 指向 mcp-servers 完全没问题，路径对上就行。
步骤 1：本地跑起来
目的是不发布也能验证插件被正确加载。
bash
claude --plugin-dir ./my-plugin（v2.1.269 及以后可用）
预期：Claude Code 以加载该插件的方式启动，插件里的命令可以直接调。
步骤 2：发布前校验
目的是把 manifest 字段和路径错误挡在分发之前。
bash
claude plugin validate ./my-plugin预期：输出校验结果，字段缺失或目录不存在会直接指出来。
实战：Java 项目的规范检查插件怎么写？
直接上手写一个 Java 后端会用的：commit 前自动跑测试 + 一个"检查规范"命令。
目录结构
就三个文件，一个清单、一个命令、一个 hook 配置。
java-quality-plugin/
├── .claude-plugin/
│ └── plugin.json
├── commands/
│ └── 检查规范.md
└── hooks/
└── hooks.jsonplugin.json
清单声明插件名 java-quality，指向两个组件目录。
json
{
"name": "java-quality",
"version": "1.0.0",
"commands": "commands",
"hooks": "hooks"
}commands/检查规范.md
斜杠命令就是一个 Markdown 文件，文件名即命令名，中文名也行。
markdown
检查当前项目的 Java 代码是否符合规范：
1. 用 `mvn checkstyle:check` 跑静态检查
2. 整理出违规项，按"文件:行号 - 问题"格式列出
3. 对每个违规项给出修复建议
4. 询问我是否自动修复，修复后重新跑检查验证装好后输入 /检查规范 就能触发。
hooks/hooks.json
配置格式和 settings.json 里的 hooks 一样，只是搬进插件、随插件分发。
json
{
"hooks": [
{
"type": "PreToolUse",
"matcher": "Bash",
"hook": "node scripts/pre-commit-test.js"
}
]
}效果是 Claude 每次执行 Bash 命令前先触发检查，等于"改完代码自动跑测试"。
一个插件就这么简单：一个命令 + 一个钩子 + 一份清单。价值也在这------把散落在 settings.json 里的配置，打包成可分享、可版本管理、可一键安装的东西。
claude plugin eval 怎么在安装前打分？
评测命令 claude plugin eval 干的事很直白：跑插件作者自带的评测套件，给你一个可复现的分数。装之前先看分，比看口碑靠谱。
bash
claude plugin eval <插件名>命令随 v2.1.269（2026-09-11）发布。它做两件事：
- 运行插件作者随插件附带的评测套件
- 输出可复现的评分结果
以前装插件全靠口碑和读源码，现在插件能自带"考试题"。作者声明"这个插件应该能做到 A、B、C"，你跑一次 eval 就知道到底行不行。可复现的意思是：同一台机器、同一版本，谁跑都是同一个分，横向比同类插件很公平。
建议 ：装第三方插件前先跑 claude plugin eval。分数低或者跑不通的，直接放弃，别拿自己的项目当试验田。
装插件前要守哪四条安全底线？
插件本质是执行别人写的代码，四条底线记牢。
- 优先官方市场：经过审核，还有安全扫描兜底。
- 第三方市场看源码：重点看有没有把文件内容发到外部服务器的逻辑。
- 用 disable 代替卸载：暂时不用的禁用掉，减少攻击面。
- 生产项目别装杂牌插件：越少越安全。
装了插件，等于把"自动执行命令"的权限交出去，这个认知要有。
常见问题
四个问题，每条先给结论再展开。
插件和 Skill 有什么区别？
结论：Skill 是单个技能，插件是打包好的能力集合，Skill 是函数，插件是库。
一个插件里可以装多个 Skill，还能带命令、Hook、Agent。
装插件要花钱吗？
结论：插件免费，运行产生的 token 按正常费率算，不额外收费。
插件能在国产模型上用吗？
结论：能。插件是客户端层功能，和用哪个模型无关。
用 CC Switch 接 DeepSeek，一样能装能用。
团队怎么统一管理插件？
结论 ：插件目录提交到 Git，配合 claude --plugin-dir 或统一市场源，全组装同一批。
总结
- 插件是能力打包单元：五类组件打一包，装一次全生效。
- 官方市场可直接用 ：
claude-plugins-official六个插件，/plugin界面浏览、一条命令安装。 - 自研成本极低 ：一份
plugin.json加组件目录，claude --plugin-dir本地验证。 - 先评分再安装 ：
claude plugin eval看分，四条安全底线兜底。
下一篇：模型选择 2026 版
版本与依据
- 官方文档：code.claude.com（插件、manifest 与 CLI 子命令）；市场页：claude.com/plugins
- 更新日志：code.claude.com（What's new）、releasebot.io
- 核对日期：2026-10-26｜适用版本：v2.1.269 及以上