Claude Code Plugins

---

0. 定位声明

适用版本：Claude Code Plugin 系统（2025 年 11 月 Public Beta 起）
前置知识：
  - 了解 Claude Code 基本用法（终端安装与运行）
  - 了解 MCP（Model Context Protocol）基本概念
  - 了解 Markdown 文件格式
  - 了解基本的 JSON 配置文件编写
不适用范围：
  - 本文不覆盖 Claude API 直接调用
  - 不适用于 Claude.ai 网页版（插件系统仅适用于 Claude Code CLI）
  - 不覆盖第三方托管版本的特有行为

---

1. 一句话本质

Claude Code Plugins 是什么？

就好比手机的"App"，每个插件把一组工具打包在一起——自定义命令、专属 AI 代理、自动化钩子、外部工具接入——安装后就能用，不需要的时候一键关掉，整个团队都能共享同一套配置。

更完整地说：

• 它是什么：一种轻量级扩展包格式，用于封装和分发对 Claude Code 的自定义能力。
• 解决什么问题：开发者或团队要把各种定制配置（自定义命令、钩子脚本、MCP 服务器配置、AI 代理提示词）带着走、共享给别人，以前只能手动复制粘贴 .claude/ 目录；插件系统让这件事变得标准化、可版本化、可市场化。
• 怎么用：在 Claude Code 中通过 /plugin install 安装，通过 /plugin enable/disable 按需激活，用 plugin.json + 几个目录结构就能自己创建一个。

---

2. 背景与根本矛盾

历史背景

Claude Code 于 2025 年初发布，定位是"住在终端里的 AI 编程助手"。早期，用户可以通过 .claude/ 目录下放置 CLAUDE.md、命令文件、MCP 配置来定制行为，但这些配置是项目本地的、手工管理的、无法方便分发的。

随着使用规模扩大，出现了几个痛点：

1. 跨项目复用困难——每个新仓库都要重新配置
2. 团队标准化困难——不同成员的 Claude Code 行为不一致
3. 社区生态碎片化——好用的配置难以共享

2025 年 11 月，Anthropic 发布 Claude Code Plugins Public Beta，用一套统一的包格式解决上述问题，同时允许任何人（个人/组织）托管"插件市场"。

根本矛盾（Trade-off）

维度	取舍关系
灵活性 vs 一致性	插件让用户高度灵活地组合能力，但团队如果每人安装不同插件，又会造成行为不一致。解决方式：通过 .claude/settings.json 的仓库级配置强制统一
功能丰富 vs 上下文窗口	安装越多插件（尤其是 Skills），系统提示词越长，模型可用上下文减少。解决方式：按需 enable/disable，用"懒加载"减少上下文占用
开放共享 vs 安全风险	任何人都能发布插件，插件可执行 MCP 服务器、钩子脚本等高权限操作。Anthropic 明确警告：安装前需确认信任来源，官方无法验证第三方插件安全性
低门槛创作 vs 生产稳定性	Markdown + JSON 极低的创作门槛让生态繁荣，但也意味着插件质量参差不齐

---

3. 核心概念与领域模型

关键术语表

术语	费曼式定义	正式定义
Plugin（插件）	一个装有各种工具的"礼盒"，可以整体安装或卸载	一个符合规范的目录结构，包含 plugin.json 元数据及可选的命令/代理/技能/钩子等组件
Marketplace（市场）	一个插件目录，告诉 Claude Code “这里有哪些插件可以安装”	一个包含 marketplace.json 的 Git 仓库或本地目录，作为插件的分发渠道
Command（命令）	类似快捷键，输入 /my-command 就触发一段预设的指令	commands/ 目录下的 Markdown 文件，定义了触发时 Claude 应执行的行为
Agent（代理）	一个专门做某类工作的 AI 小助手，有自己的"性格设定"和工具限制	agents/ 目录下的 Markdown 文件，定义了特定任务的系统提示和工具集
Skill（技能）	教给 Claude 的一套隐性知识，Claude 会在合适时机自动用上	skills/<name>/SKILL.md 文件，Claude 根据任务上下文自主决策是否调用
Hook（钩子）	在特定时刻自动执行的脚本，比如每次提交代码前自动做检查	hooks/hooks.json 中配置的事件监听器，在 Claude Code 工作流关键节点触发
MCP Server	让 Claude 能调用外部工具（数据库、API、浏览器等）的"翻译官"	通过 .mcp.json 配置的 Model Context Protocol 服务器，提供额外工具能力

领域模型

Marketplace（市场）
  └── 包含多个 Plugin（插件）
          ├── .claude-plugin/
          │     └── plugin.json        ← 元数据（名称/版本/作者/依赖）
          ├── commands/
          │     └── *.md               ← 自定义斜杠命令（用户主动触发）
          ├── agents/
          │     └── *.md               ← 专用代理定义（有独立系统提示）
          ├── skills/
          │     └── <skill-name>/
          │             └── SKILL.md   ← 自动调用的技能文档
          ├── hooks/
          │     └── hooks.json         ← 事件钩子配置
          ├── .mcp.json                ← MCP 服务器配置
          └── settings.json           ← 默认配置覆盖（仅支持 agent 键）

用户视角：
  /plugin marketplace add <url>        ← 订阅市场
  /plugin install <name>@<market>      ← 安装插件
  /plugin enable/disable               ← 按需激活（影响上下文大小）
  /plugin uninstall                    ← 完全移除

实体关系说明：

• 一个市场可以托管多个插件
• 一个插件可以包含命令、代理、技能、钩子、MCP 的任意组合（全部可选）
• 命令是用户主动触发（/command-name），技能是模型自动调用
• 代理拥有独立系统提示，一个插件可通过 settings.json 将某个代理设为默认主代理

---

4. 对比与选型决策

同类扩展机制横向对比

对比维度	Claude Code Plugins	直接编辑 .claude/ 目录	VS Code 插件	Cursor Rules
可分发性	✅ 可发布到市场，一条命令安装	❌ 手动复制粘贴	✅ 完整市场体系	⚠️ 需共享文件
团队统一	✅ 仓库级 settings.json 自动安装	⚠️ 需 Git 追踪 .claude/	✅ devcontainer 可强制	⚠️ 需手动同步
上下文开销	中（可按需 enable/disable）	低（仅加载已配置项）	无（不影响 AI 上下文）	低
学习成本	低（Markdown + JSON）	极低	高（TypeScript API）	极低
安全审计	⚠️ 官方无法验证第三方插件	自己可控	✅ 有市场审核机制	自己可控

选型决策树

需要扩展 Claude Code 能力？
├── 只是单个项目用？
│     └── → 直接在 .claude/ 目录下配置，无需插件
├── 需要跨项目复用或分享给他人？
│     ├── 内部团队共享
│     │     └── → 创建内部插件 + 私有市场，通过 settings.json 统一部署
│     └── 开源/公开发布
│           └── → 创建插件 + 提交到 Anthropic 官方市场或 ccplugins 社区列表
├── 只需要连接一个外部工具（如数据库/API）？
│     └── → 考虑直接用 MCP Server，不一定需要完整插件
└── 需要组合多种能力（命令+代理+钩子+MCP）？
      └── → 插件是最合适的封装单元

---

5. 工作原理与实现机制

静态结构：插件目录规范

my-plugin/                         ← 插件根目录
├── .claude-plugin/
│   └── plugin.json                ← 唯一必须文件（插件元数据）
├── commands/
│   └── <command-name>.md          ← 斜杠命令（用户主动触发）
├── agents/
│   └── <agent-name>.md            ← 专用代理（有独立系统提示）
├── skills/
│   └── <skill-name>/
│       └── SKILL.md               ← 技能（模型自动调用）
├── hooks/
│   └── hooks.json                 ← 事件钩子配置
├── .mcp.json                      ← MCP 服务器配置
├── settings.json                  ← 默认设置（仅支持 agent 键）
└── README.md                      ← 插件文档

⚠️ 关键约束（常见错误）：
commands/、agents/、skills/、hooks/ 必须放在插件根目录，不能放在 .claude-plugin/ 目录内。.claude-plugin/ 里只放 plugin.json。

plugin.json 最小化示例（Claude Code 2025.11+）：

{
  "name": "my-plugin",
  "description": "一句话描述这个插件的功能",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

动态行为：插件安装与激活流程

步骤 1：添加市场
用户执行：/plugin marketplace add <git-url 或本地路径>
  ↓
Claude Code 读取 .claude-plugin/marketplace.json
  ↓
将市场信息写入用户级配置（~/.claude/settings.json）

步骤 2：安装插件
用户执行：/plugin install <plugin-name>@<marketplace>
  ↓
Claude Code 克隆/复制插件目录到本地存储
  ↓
解析 plugin.json、commands/、agents/、skills/、hooks/、.mcp.json
  ↓
提示用户重启 Claude Code

步骤 3：运行时加载（重启后）
Claude Code 启动
  ↓
读取所有 enabled 插件配置
  ↓
将 commands/ 注册为可用斜杠命令
将 skills/ 中的 SKILL.md 注入系统提示上下文
将 agents/ 注册为可调用代理
将 hooks/ 中的事件监听器挂载到工作流节点
启动/连接 .mcp.json 中配置的 MCP 服务器

步骤 4：运行时调用
用户输入 /my-command
  ↓ Claude 读取 commands/my-command.md 中的指令并执行

或 Claude 自动识别任务需要某 Skill
  ↓ 读取 skills/<name>/SKILL.md，按技能文档指导执行

关键设计决策

决策 1：为什么用 Markdown 而不是代码来定义命令和代理？

• 这样设计：命令和代理用 .md 文件，内容是自然语言描述
• 而不是：像 VS Code 插件用 TypeScript API 硬编码行为
• 原因：Claude Code 的核心是 LLM，指令本身就是"输入给模型的提示词"。Markdown 降低了创作门槛，任何能写文档的人都能创建插件；同时天然支持版本控制和 diff。
• 代价：能力边界依赖模型理解力，确定性不如代码高；复杂逻辑表达困难。

决策 2：为什么 Skills 是"模型自动调用"而不是"用户手动触发"？

• 这样设计：Skills（技能）由模型根据上下文自主决定是否使用
• 而不是：像 Commands 那样要求用户输入 /command 才触发
• 原因：技能代表"工作方式知识"（如"使用 TanStack Query 做数据请求"），如果每次都要用户手动指定，摩擦太大。让模型自主判断更符合 Agent 的设计哲学。
• 代价：用户对模型"何时用技能"的控制力弱，调试时较难复现。

决策 3：为什么要有 enable/disable 而不只是 install/uninstall？

• 这样设计：插件可以安装后保持 disabled 状态，需要时再 enable
• 原因：每个 enabled 插件的 Skills 都会增加系统提示长度，而 LLM 的上下文窗口是有限且有成本的资源。按需激活让用户在功能完整性和上下文效率之间自主权衡。
• 代价：用户需要主动管理插件状态，有一定心智负担。

---

6. 高可靠性保障

安全模型：信任链

官方 Anthropic 市场（最高信任）
    ↓ 由 Anthropic 内部开发和审核
社区官方列表（ccplugins/awesome-claude-code-plugins）
    ↓ 社区维护，无强制技术审核
第三方任意市场（需用户自行评估）
    ↓ Anthropic 明确声明无法验证安全性
用户本地开发插件（--plugin-dir 标志本地测试）

⚠️ 关键安全警告：

• 插件可配置 MCP 服务器，MCP 服务器可执行任意代码（文件操作、网络请求、终端命令）
• 插件可配置 Hooks，Hooks 可在工作流节点执行任意脚本
• 安装前必须审查插件内容，尤其是 .mcp.json 和 hooks/hooks.json

团队分发的稳定性保障

通过仓库级 .claude/settings.json 强制统一插件配置：

{
  "plugins": {
    "marketplaces": [
      {
        "name": "my-org",
        "source": "https://github.com/my-org/claude-plugins"
      }
    ],
    "installed": [
      {
        "name": "dev-toolkit",
        "marketplace": "my-org",
        "enabled": true
      }
    ]
  }
}

当团队成员信任该仓库后，Claude Code 自动按此配置安装并启用插件，确保所有人的环境一致。

可观测性

检查项	命令/方式
查看已安装插件状态	/plugin → “Manage Plugins”
查看插件提供的命令	/help
验证 MCP 服务器连接	Claude Code 启动日志
调试插件加载问题	使用 --plugin-dir 本地测试模式

⚠️ 存疑：目前没有找到官方文档说明插件级别的详细运行指标（如 Skill 调用频次、Hook 执行耗时）的监控方式，该能力可能尚未开放。

---

7. 使用实践与故障手册

7.1 典型使用方式

最小插件创建（生产验证流程）

环境：Claude Code（2025.11+）, macOS/Linux

# Step 1: 创建插件目录结构
mkdir -p my-team-plugin/.claude-plugin
mkdir -p my-team-plugin/commands
mkdir -p my-team-plugin/agents

# Step 2: 创建插件元数据
cat > my-team-plugin/.claude-plugin/plugin.json << 'EOF'
{
  "name": "my-team-plugin",
  "description": "团队统一开发规范插件",
  "version": "1.0.0",
  "author": {
    "name": "Engineering Platform Team"
  }
}
EOF

# Step 3: 创建一个自定义命令
cat > my-team-plugin/commands/code-review.md << 'EOF'
---
description: 执行代码审查，检查安全漏洞和代码规范
---

请对当前工作区的代码变更进行代码审查：
1. 检查潜在的安全漏洞（SQL 注入、XSS、密钥硬编码等）
2. 检查是否符合团队编码规范
3. 检查是否有遗漏的错误处理
4. 给出改进建议，按优先级排序

以结构化 Markdown 格式输出审查报告。
EOF

# Step 4: 创建本地市场
mkdir -p test-marketplace/.claude-plugin
cat > test-marketplace/.claude-plugin/marketplace.json << 'EOF'
{
  "name": "test-marketplace",
  "owner": {"name": "Local Dev"},
  "plugins": [
    {
      "name": "my-team-plugin",
      "source": "../my-team-plugin",
      "description": "Team dev standards"
    }
  ]
}
EOF

# Step 5: 在 Claude Code 中测试
# 启动 Claude Code 后依次执行：
# /plugin marketplace add ./test-marketplace
# /plugin install my-team-plugin@test-marketplace
# 重启 Claude Code 后测试：/code-review

带 MCP Server 的插件配置示例

// my-plugin/.mcp.json
// 环境：Node.js 18+，需提前设置 GITHUB_TOKEN 环境变量
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

关键配置项说明：

• command：MCP 服务器启动命令，通常是 npx 或 python
• args：启动参数，-y 表示 npm 自动确认安装
• env：环境变量注入，${VAR_NAME} 引用系统环境变量（切勿硬编码密钥）
• 默认风险：环境变量未设置时 MCP 服务器会静默失败，不会报错提醒用户

7.2 故障模式手册

【故障 1：插件安装后命令不可用】
- 现象：安装插件后输入 /my-command 提示未知命令，/help 中也不显示
- 根本原因：插件安装后需要重启 Claude Code 才能加载，未重启导致命令未注册
- 预防措施：安装后养成重启习惯；官方文档在安装流程中已明确提示
- 应急处理：退出 Claude Code 后重新启动

【故障 2：目录结构放置错误导致插件功能缺失】
- 现象：插件安装成功，但命令/代理/技能等功能不生效
- 根本原因：将 commands/、agents/ 等目录错误地放在 .claude-plugin/ 子目录内
- 预防措施：严格遵守结构规范：.claude-plugin/ 只放 plugin.json；其余目录放在插件根目录
- 应急处理：检查目录结构，将错误放置的目录移到插件根目录，重新安装

【故障 3：MCP 服务器启动失败】
- 现象：插件安装后 Claude 无法调用外部工具，提示工具不可用
- 根本原因：MCP 服务器依赖的 npm 包未安装、环境变量未配置、网络不通
- 预防措施：检查 .mcp.json 中引用的 npm 包是否可访问；提前设置好所需环境变量
- 应急处理：手动在终端运行 MCP server 命令排查；检查系统 PATH 和环境变量

【故障 4：Skills 未被模型自动调用】
- 现象：安装了包含 Skills 的插件，但 Claude 在合适场景下没有使用对应技能
- 根本原因：Skill 的 SKILL.md 触发描述不够明确，模型无法准确识别适用场景
- 预防措施：在 SKILL.md 中提供清晰的"适用场景"和"触发条件"描述；使用具体例子
- 应急处理：在对话中明确告知 Claude 使用对应技能；优化 SKILL.md 的描述

【故障 5：团队成员插件版本不一致】
- 现象：同一插件，不同成员表现行为不一致
- 根本原因：settings.json 未锁定插件版本，各人安装时间不同导致版本差异
- 预防措施：将插件市场 Git 仓库打 Tag 管理版本；settings.json 中引用具体版本
- 应急处理：统一执行 /plugin uninstall 后重新安装，确保版本一致

7.3 边界条件与局限性

• 上下文窗口限制：每个 enabled 插件的 Skills 都会增加系统提示体积。安装超过 10 个包含大量 Skills 的插件后，可用的对话上下文会显著减少（具体数值 ⚠️ 存疑，取决于各 SKILL.md 的长度）。
• Public Beta 稳定性：Plugin 系统（2025.11）仍处于公测阶段，API/格式可能在正式版中变更。
• settings.json 的局限：目前只支持 agent 这一个键（用于设置默认代理），其他配置项会被静默忽略。
• 离线环境限制：依赖 npx 安装的 MCP 服务器在没有网络的环境中无法启动。
• Windows 兼容性 ⚠️ 存疑：Hooks 脚本在 Windows 环境的执行行为未在官方文档中明确说明。

---

8. 性能调优指南

上下文效率优化（最关键的性能问题）

问题本质：每个 enabled 插件的 Skills 内容被注入系统提示，系统提示越长，每次 API 调用的 token 消耗越高，延迟也越高。

优化步骤（按优先级）：

1. 只 enable 当前任务需要的插件（最高收益，零代码改动）

   • 目标：将活跃 Skills 数量控制在任务所需最小集合
   • 验证方法：对比 enable/disable 前后的 Claude 响应延迟和 token 用量

2. 精简 SKILL.md 内容（适用于自建插件）

   • 目标：每个 SKILL.md 控制在 500 tokens 以内（约 400 个中文字）
   • 原则：触发条件 > 核心步骤 > 注意事项；删去冗余的示例代码样板
   • 验证方法：通过 Claude Tokenizer 估算 token 数

3. 使用 MCP Tool Search（懒加载）特性

   • 背景：Claude Code 新增的 MCP Tool Search 功能支持 MCP 服务器工具的懒加载
   • 效果：可减少最多约 95% 的 MCP 工具相关上下文占用（⚠️ 来源：社区实测报告，非官方数据）

调优参数速查表

参数/配置	默认值	推荐值	调整风险
同时 enabled 插件数量	无限制	≤5 个（日常任务）	功能减少
单个 SKILL.md 大小	无限制	≤500 tokens	描述过于简略导致调用不准
MCP 服务器数量/插件	无限制	≤3 个	工具数量过少影响能力
Hook 脚本执行超时	⚠️ 存疑	建议 ≤30s	超时可能阻塞工作流

---

9. 演进方向与未来趋势

当前社区动向（截至 2026 年 3 月）

官方插件市场生态扩张：Anthropic 已在 anthropics/claude-plugins-official 建立官方市场，包含 Agent SDK 工具包、PR 审查工具包等官方维护插件，预计覆盖面将快速扩大。

多 Agent 并行编排：社区已出现基于 Plugins + Subagents 实现的多代理并行工作流（如 5 个并行 Sonnet 代理分工做 PR 审查）。随着 Claude Agent SDK 成熟，Plugin 将成为打包复杂多代理流水线的标准单元。

Plugin Marketplace 多元化：允许任何人用一个 Git 仓库托管市场，意味着企业可以建立内部私有市场管控合规性，第三方框架厂商可以发布官方插件作为分发渠道。

对使用者的实际影响

• 近期（2026）：插件质量参差不齐，优先使用官方插件或 awesome-claude-code-plugins 社区列表中口碑好的插件比自建更高效。
• 中期（2026-2027）：随着 Plugin 格式稳定，预计会出现插件模板生成器和可视化编辑器，进一步降低创建门槛。
• 长期：Plugin 系统有望成为 AI 编程助手领域的事实标准扩展格式。

---

10. 面试高频题

【基础理解层】（考察概念掌握）

Q：Claude Code Plugin 和直接修改 .claude/ 目录下的文件有什么区别？
A：
  直接修改 .claude/ 是项目本地配置，仅对当前项目生效，无法方便地分享给他人。
  Plugin 是一种标准化封装格式，可以发布到市场供他人安装，也可以通过仓库配置
  实现团队统一部署，同时支持 enable/disable 按需加载，不需要时不占用上下文。
考察意图：区分"本地配置"和"可分发扩展包"的概念，考察对 Plugin 定位的理解。

Q：Plugin 中 Commands 和 Skills 的本质区别是什么？
A：
  Commands 是用户主动触发的（输入 /command-name），明确指定要执行什么。
  Skills 是模型自动调用的，Claude 根据任务上下文判断是否需要某个技能，无需用户干预。
  前者是"显式调用"，后者是"隐式激活"。
考察意图：考察对 Plugin 组件类型的理解，以及对 Agentic AI 自主决策机制的认知。

【原理深挖层】（考察内部机制理解）

Q：为什么 Plugin 安装后需要重启 Claude Code 才能生效？
A：
  Claude Code 在启动时将所有 enabled 插件的配置（命令列表、Skill 内容、代理定义）
  加载并注入到运行时环境和系统提示中。安装操作只是将文件复制到本地存储，
  不会热重载正在运行的实例。重启才触发完整的配置扫描和注入流程。
考察意图：考察对 Plugin 加载生命周期的理解。

Q：如果同时安装了 20 个包含大量 Skills 的插件并全部 enable，会有什么问题？
A：
  每个 enabled 插件的所有 SKILL.md 内容都会被注入系统提示，
  导致系统提示 token 数量大幅增加。这会：
  1. 减少用户实际可用的对话上下文窗口
  2. 增加每次 API 调用的 token 消耗（成本上升）
  3. 可能导致模型在过长的系统提示下对具体技能的注意力分散
  解决方案：按需 enable，保持活跃 Skills 最小化。
考察意图：考察对 LLM 上下文窗口约束的理解，以及 Plugin 设计中性能与功能的权衡意识。

【生产实战层】（考察工程经验）

Q：在团队中如何确保所有成员使用相同版本的 Plugin？
A：
  通过以下组合实现：
  1. 在仓库的 .claude/settings.json 中声明插件来源和配置
  2. 将插件市场的 Git 仓库打 Tag 管理版本
  3. settings.json 中引用具体 Tag 而非 main 分支
  4. 让团队成员信任仓库后，Claude Code 自动安装匹配版本
  如果某成员的插件版本不对，执行 /plugin uninstall 后重新安装强制同步。
考察意图：考察对 Plugin 团队部署实践的掌握，以及版本管理意识。

Q：你会如何审查一个第三方 Plugin 的安全性？
A：
  重点检查以下几个攻击面：
  1. .mcp.json：检查配置的 MCP 服务器来源，避免安装来历不明的 MCP 二进制；
     检查环境变量是否要求输入敏感信息（API Key、密码等）
  2. hooks/hooks.json：检查 Hooks 触发的脚本内容，确认不执行危险操作
     （如数据外传、修改系统文件）
  3. commands/ 和 agents/：检查是否有隐藏的提示注入内容
  4. 优先选择 Anthropic 官方市场或 GitHub Stars 多、Commit 历史清晰的社区插件
考察意图：考察对 Plugin 安全边界的认知，以及供应链安全意识。

---

11. 文档元信息

验证声明

本文档内容经过以下验证：
✅ 与官方文档一致性核查：https://code.claude.com/docs/en/plugins
✅ 与官方 GitHub 仓库核查：https://github.com/anthropics/claude-code/tree/main/plugins
✅ 与 Anthropic 发布博客核查：https://www.anthropic.com/news/claude-code-plugins

⚠️ 以下内容未经本地环境验证，仅基于文档推断：
  - 第 8 节：MCP Tool Search 懒加载的上下文节省比例（95% 来自社区报告，非官方数据）
  - 第 7.3 节：Hooks 脚本在 Windows 环境的兼容性
  - 第 8 节：Hook 脚本默认执行超时时间
  - 第 3 节：Skills 对系统提示长度的具体 token 影响数值

知识边界声明

本文档适用范围：
  - Claude Code CLI（2025 年 11 月公测版本及以后）
  - Plugin 系统 Public Beta 阶段
  - macOS / Linux 为主要验证平台

不适用场景：
  - Claude.ai 网页版（不支持 Plugin 系统）
  - Claude API 直接调用
  - 本文撰写于 2026 年 3 月，Plugin 系统仍在快速迭代，具体 API 和格式可能已变更

参考资料

官方文档：
  - Claude Code Plugins 文档：https://code.claude.com/docs/en/plugins
  - Claude Code Plugins 参考规范：https://code.claude.com/docs/en/plugins-reference
  - Claude Code Agent Skills：https://code.claude.com/docs/en/skills
  - Claude Code Hooks 指南：https://code.claude.com/docs/en/hooks-guide
  - Claude Code MCP 文档：https://code.claude.com/docs/en/mcp

官方源码与市场：
  - 官方 Plugin 示例仓库：https://github.com/anthropics/claude-code/tree/main/plugins
  - Anthropic 官方维护 Plugin 目录：https://github.com/anthropics/claude-plugins-official

社区资源：
  - Awesome Claude Code Plugins：https://github.com/ccplugins/awesome-claude-code-plugins
  - Claude Code 生态概览：https://claudelog.com/claude-code-mcps/
  - Anthropic 官方发布博客：https://www.anthropic.com/news/claude-code-plugins

实战参考：
  - 全栈 Claude Code 设置实战（Skills + MCPs + Plugins）：
    https://composio.dev/blog/full-stack-claude-code-setup-(skills-mcp-plugins)

---