乐于分享
好东西不私藏

Claude Code 插件完全指南:从安装到精通,解锁 AI 编程的无限可能

Claude Code 插件完全指南:从安装到精通,解锁 AI 编程的无限可能

💡 核心洞察

还记得第一次发现 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