Claude 插件官方指南

篇幅

56 篇

开始阅读GitHub 仓库飞书版

前言

配套资源
源码仓库 · github.com/diguike/book-claude-plugins
在线阅读 · inferloop.dev/claude-plugins

本书简介

这本书拆解 anthropics/claude-plugins-official 仓库里的每一个插件——35 个 Anthropic 官方插件和 15 个驻仓库的第三方外部插件，本书重点讲透其中的 52 个。

目的很简单：你装了一个插件，想知道它到底干了什么、怎么干的、有什么坑，翻到对应章节就行。如果你正在写自己的插件，这些现成的实现就是最好的参考。

这本书的源码（含本书所有 Markdown 章节、配套示例）开源在 https://github.com/diguike/book-claude-plugins，欢迎提 issue / PR 纠错或补充。

仓库里有什么

anthropics/claude-plugins-official 是 Claude Code 插件的官方 marketplace 仓库，组织成三层：

• /plugins —— Anthropic 自研的 35 个核心插件
• /external_plugins —— 跟 Anthropic 合作、源码托管在本仓库的 15 个第三方插件
• .claude-plugin/marketplace.json —— 通过 SHA pin 或 URL 接入的 150+ 个远程第三方插件（来自 AWS、Azure、Cloudflare、Vercel、MongoDB、Datadog、Sentry、Stripe、Shopify、Notion、Slack 等厂商）

本书把前两层（共 50 个）逐个拆开讲清楚，加上 3 个最近新增的官方插件（code-modernization、cwc-makers、mcp-tunnels），合计 52 章。150+ 个远程第三方插件不展开（生命周期太短，半年后可能就大改），但在附录·插件速查索引里做了一份按领域分类的目录，需要时直接查。

按功能给前 50 个插件分组大致是这样：

开发流程类：feature-dev（功能开发工作流）、commit-commands（Git 提交流程）、code-review / pr-review-toolkit（代码审查）、code-simplifier（代码精简）、code-modernization（遗留系统现代化）。这类插件把日常开发里反复做的事串成了自动化流程。

语言服务器类：typescript-lsp、pyright-lsp、rust-analyzer-lsp、gopls-lsp、clangd-lsp、ruby-lsp、swift-lsp、kotlin-lsp、jdtls-lsp、csharp-lsp、lua-lsp、php-lsp。一口气 12 个 LSP（Language Server Protocol，语言服务器协议）插件，给 Claude Code 接上了各语言的类型检查和智能补全能力。

插件开发类：plugin-dev（插件开发工具箱）、skill-creator（技能创建器）、example-plugin（示例插件）、mcp-server-dev（MCP 服务器开发）、hookify（Hook 生成器）、mcp-tunnels（私网 MCP 暴露）。想写自己的插件，这几个是入口。

项目管理与协作类：claude-code-setup（项目初始化配置）、claude-md-management（CLAUDE.md 维护）、session-report（会话报告）、ralph-loop（迭代循环开发）。

输出风格类：explanatory-output-style（解释型输出）、learning-output-style（学习型输出）。这两个比较特别，不提供工具能力，而是改变 Claude 的回答风格。

外部服务集成类：GitHub、GitLab、Linear、Asana（项目管理），Supabase、Firebase（后端即服务/BaaS），Playwright（浏览器自动化），Terraform（IaC，基础设施即代码），以及 Discord、Telegram、iMessage、fakechat（消息通道）等。这些插件通过 MCP（Model Context Protocol，模型上下文协议）把外部服务的 API 接进 Claude Code。

专业领域类：math-olympiad（竞赛数学）、security-guidance（安全指导）、frontend-design（前端设计）、agent-sdk-dev（Agent SDK 开发）、playground（交互式 HTML 沙盒）、cwc-makers（M5Stack Cardputer 硬件套件 onboarding）。

本书的组织

全书按功能分 6 章加附录，每章覆盖一个领域的所有插件：

每个插件的讲解遵循同一结构：它解决什么问题、目录结构与组件构成、核心实现拆解、使用示例、已知限制和注意事项。

这本书适合谁

你应该已经用过 Claude Code，知道怎么跟它对话、怎么让它改代码。你可能用 / 斜杠命令执行过一些操作，也许装过一两个插件。但对插件体系的整体架构——skills、agents、hooks、commands、MCP servers 这五种扩展点分别是什么、怎么配合——还没有系统的认识。

如果你完全没用过 Claude Code，建议先跑通官方文档的入门流程再来。这本书不会从零教你 Claude Code 的基础操作。

如果你已经是插件开发老手，这本书对你的价值在于：快速了解官方仓库里每个插件的实现细节，看看别人怎么处理你遇到过的同类问题。

术语约定

全书统一使用以下术语：