Skip to Content
Claude 插件官方指南

配套资源
源码仓库 · 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-modernizationcwc-makersmcp-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 的回答风格。

外部服务集成类GitHubGitLabLinearAsana(项目管理),SupabaseFirebase(后端即服务/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 章加附录,每章覆盖一个领域的所有插件:

主题包含的插件
第 1 章开发工具与工作流example-plugin, claude-code-setup, claude-md-management, commit-commands, feature-dev, plugin-dev, skill-creator, mcp-server-dev, agent-sdk-dev, hookify, playground, ralph-loop, session-report, code-modernization, cwc-makers, mcp-tunnels
第 2 章代码质量与审查code-review, pr-review-toolkit, code-simplifier, security-guidance
第 3 章输出风格定制explanatory-output-style, learning-output-style
第 4 章专业领域插件frontend-design, math-olympiad
第 5 章LSP 语言服务器集成12 个 *-lsp 插件(含通用原理概述)
第 6 章外部服务集成GitHub, GitLab, Linear, Asana, Supabase, Firebase, Terraform, Playwright, Discord, Telegram, iMessage, Greptile, Laravel Boost, Context7, Serena, fakechat
附录插件开发进阶 + 常见问题 + 插件速查索引(含 150+ 远程第三方插件分类目录)

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

这本书适合谁

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

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

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

术语约定

全书统一使用以下术语:

术语含义
Claude CodeAnthropic 官方 CLI(命令行)形态的编程助手,详见 https://claude.com/claude-code
slash command斜杠命令,用户在 Claude Code 中输入 /xxx 触发的命令
skill技能,Claude 根据上下文自动激活或用户手动调用的能力模块
agent / subagent代理/子代理,独立运行的子进程,有自己的上下文和工具集
hook钩子,挂载到特定事件上的自动化脚本或 prompt
frontmatterMarkdown 文件顶部的 YAML 元数据块(--- 包裹的部分)
MCPModel Context Protocol,模型上下文协议,Claude 调用外部工具的协议,详见 https://modelcontextprotocol.io
LSPLanguage Server Protocol,语言服务器协议,IDE 与语言后端之间的通信标准,详见 https://microsoft.github.io/language-server-protocol
prompt提示词/指令,给 Claude 的输入文本
marketplace插件市场,对应仓库 anthropics/claude-plugins-official

本章来自《Claude 插件官方指南》开源版 · 作者「递归客」
在线阅读完整书系:inferloop.dev
源码仓库:github.com/diguike/book-claude-plugins

本书资源

继续阅读 · 同作者其他书

Last updated on