Claude Code 插件完全指南：安装配置、MCP 集成与自定义开发

💡 核心洞察：还记得第一次发现 VS Code 扩展市场时的感受吗？安装几个插件，编辑器就从一个简陋的文本工具变成了无所不能的开发环境。Claude Code 的插件系统正在做同样的事情——目前已有 超过 9000 个插件 可供选择，覆盖从代码审查到数据库查询，从自动化部署到浏览器测试的每一个环节。

01 插件到底是什么

简单来说，Claude Code 插件是一个 可分享的功能包。它把多种扩展组件打包在一起，让你一键安装、跨项目复用、和团队共享。一个插件可以包含以下组件：

组件	说明
📖 技能（Skills）	Markdown 格式的指令文件，告诉 Claude 如何完成特定任务。Claude 会根据上下文自动加载相关技能，每个技能仅消耗 30-50 个 token。
🤖 子代理（Agents）	专门化的 AI 代理，在隔离的上下文中执行复杂任务。可以同时启动多个子代理并行工作，互不干扰。
⚡ 钩子（Hooks）	事件驱动的自动化脚本。在 Claude 执行特定操作时自动触发——每次编辑文件后自动格式化，提交前运行 linter。
🔗 MCP 服务器	通过 Model Context Protocol 连接外部工具和服务。这是插件最强大的部分，让 Claude 直接操作数据库、API、浏览器等外部系统。

🎯 类比理解：
安装一个插件，等于同时配置了多个技能、代理、钩子和工具连接。就像买了一个“全能工具包”，所有组件都经过精心搭配，开箱即用。

02 如何发现和安装插件

▎打开插件管理器

在 Claude Code 会话中，输入 /plugin，就会打开图形化的插件管理器界面，包含四个标签页：

标签	说明
发现	浏览所有可用插件
已安装	查看和管理已安装的插件
市场	管理插件市场源
错误	查看加载错误信息

你也可以直接在浏览器中访问 claude.com/plugins 浏览插件目录。

▎官方市场已预配置

Anthropic 的官方插件市场（claude-plugins-official）在你安装 Claude Code 时就已经配置好了，无需任何额外设置。直接从官方市场安装插件：

/plugin install github@claude-plugins-official

▎添加更多插件市场

除了官方市场，你还支持添加社区和团队自建的市场，支持多种来源：

# GitHub 仓库（最常用）
/plugin marketplace add anthropics/claude-code

# Git 平台
/plugin marketplace add https://gitlab.com/company/plugins.git

# 本地目录（开发测试）
/plugin marketplace add ./my-marketplace

▎安装插件

两种安装方式：

• 交互界面：输入 /plugin，在 Discover 标签页浏览，选中后按 Enter，选择安装范围
• 直接命令：/plugin install plugin-name@marketplace-name

▎三种安装范围

范围	说明
用户 scope	所有项目可用（默认）
项目 scope	仅当前项目，团队共享
本地 scope	仅当前项目，不提交版本控制

03 管理你的插件

安装之后，日常管理同样方便：

命令	说明
/plugin list	查看所有已安装的插件
/plugin disable plugin-name	禁用插件（不卸载）
/plugin uninstall plugin-name	彻底卸载插件

💡 重要技巧：安装、禁用或启用插件后，运行 /reload-plugins 即可生效，无需重启会话。Claude Code 会报告加载了哪些技能、代理、钩子、MCP 和 LSP 服务器。

04 必装插件推荐

▎开发者必装三件套

1. Feature Dev（官方出品）
结构化开发工作流——从需求发现、代码库探索到架构设计、实现和审查，全程引导。安装量最高的插件之一。
/plugin install feature-dev@claude-plugins-official

2. Code Review（官方出品）
多代理代码审查。同时从安全性、性能、可维护性和正确性四个维度审查代码，按置信度排序结果。
/plugin install code-review@claude-plugins-official

3. Context7（Upstash 出品）
实时文档查询。Claude 的训练数据有截止日期，Context7 直接从源码仓库拉取最新文档，告别过时的 API 示例。
/plugin install context7@claude-plugins-official

▎MCP 服务器插件

MCP 服务器是插件中最强大的组件，它们连接 Claude 到外部工具：

• 🔹 GitHub MCP — 搜索代码库、管理 Issue 和 PR
• 🔹 PostgreSQL MCP — 自然语言查询数据库
• 🔹 Playwright MCP — 浏览器自动化测试
• 🔹 File System MCP — 安全的本地文件操作

05 注意事项和最佳实践

⚠️ 不要贪多
每个插件都会增加上下文开销。安装 20 个插件互相竞争，不如精选 5-7 个 真正有用的。从最核心的需求开始，逐步添加。

推荐起步配置：

• 3 个核心插件：Feature Dev + Code Review + Context7
• 2-3 个 MCP 服务器：GitHub + 你的技术栈相关
• 1-2 个自定义技能：团队编码规范、部署流程

📌 选择合适的安装范围
个人常用插件 → 用户范围 | 团队工作流插件 → 项目范围 | 临时测试 → 本地范围

06 自己动手创建一个插件

创建 Claude Code 插件的门槛非常低。最基本的步骤：

my-plugin/
├── .claude-plugin/
│    └── plugin.json       # 插件清单
├── skills/
│    └── hello/
│         └── SKILL.md    # 技能文件
└── README.md

plugin.json 示例：

{
  "name": "my-first-plugin",
  "version": "1.0.0",
  "description": "我的第一个 Claude Code 插件"
}

⚠️ 重要提醒：只有 plugin.json 放在 .claude-plugin/ 目录中。所有其他组件目录（skills/、agents/、hooks/ 等）都必须放在插件根目录。

✓ 总结

Claude Code 的插件系统正在将 AI 编程从一个对话工具进化为一个完整的开发平台。通过插件，你可以：

• 扩展能力：连接数据库、API、浏览器等外部工具
• 固化流程：将团队最佳实践封装为可复用的技能
• 自动执行：用钩子在关键时刻自动触发操作
• 团队共享：通过插件市场一键分发配置

9000+ 个插件、官方市场预配置、安装只需一条命令——现在是探索 Claude Code 插件生态的最好时机。

🔗 相关资源：
官方文档：https://code.claude.com/docs/en/overview
插件市场：https://claude.com/plugins
GitHub 仓库：https://github.com/anthropics/claude-code