大模型应用开发实战（12）——Claude Code 扩展体系终于讲明白了：Skills、Hooks、MCP、Subagents 分层解析

‍♂️ 个人主页小李同学_LSH的主页✍ 作者简介LLM学习者 希望大家多多支持我们一起进步如果文章对你有帮助的话欢迎评论 点赞 收藏 加关注目录先给结论这四个东西不在同一层一、Skills它不是插件市场而是“把套路固化下来”Skills 最适合什么场景Skills 和 CLAUDE.md 的区别二、Hooks它不是“能力”而是“自动触发器”Hooks 触发在什么时候Hooks 最适合什么场景MCP 在 Claude Code 里到底扮演什么角色MCP 最适合什么场景Subagents 真正解决的是什么问题Subagents 最适合什么场景五、最容易犯的错把四者当成替代关系六、一个最实用的判断法你该先加哪一层第一问你是不是总在重复给 Claude 讲同一套流程第二问你是不是希望某些动作在固定时机自动执行第三问你是不是总在手动把外部系统的信息复制进聊天第四问你的任务是不是已经复杂到一个代理做会把上下文搞得很乱这两个月很多人开始觉得 Claude Code 不像一个“会补代码的工具”而更像一个“能接手一段开发流程的编程代理”。Anthropic 官方对 Claude Code 的定位也很明确它是一个agentic coding tool能理解代码库、编辑文件、运行命令并且可在终端、IDE、桌面端和浏览器中使用。但一旦真正开始用几乎所有人都会在同一个地方犯迷糊Skills、Hooks、MCP、Subagents 到底分别是什么它们到底处在 Claude Code 的哪一层这四个词经常同时出现但它们解决的问题其实完全不同。这篇文章我就只做一件事把 Claude Code 的扩展体系分层讲清楚。你看完之后应该能回答这四个问题什么时候该写 Skill。什么时候该配 Hook。什么时候该接 MCP。什么时候该把任务拆给 Subagent。先给结论这四个东西不在同一层最短的理解方式是Skills把“常用做法”封装成 Claude 会在合适时机调用的能力包。Hooks在 Claude Code 生命周期的特定节点自动触发命令、HTTP 或提示逻辑。MCP把外部工具、数据库、API、文件系统这类外部系统标准化接进来。Subagents把复杂任务分派给专门代理去处理。如果非要用一句更像工程语言的话总结Skills 负责“会什么”Hooks 负责“什么时候自动做”MCP 负责“能连到什么外部世界”Subagents 负责“谁来做”。这四层叠在一起Claude Code 才从一个会话工具变成一个真正可扩展的编程代理系统。一、Skills它不是插件市场而是“把套路固化下来”Anthropic 官方对 Skills 的定义很直接用SKILL.md文件把说明写进去Claude 就会把它加入自己的工具箱当相关时 Claude 会自动用也可以手动通过/skill-name调用。官方还特别强调和CLAUDE.md不同Skill 的正文只会在它被实际使用时才加载所以长参考材料在不用的时候几乎不花上下文成本。这其实已经说明了 Skills 的本质它不是“接一个外部能力”而是把你反复输入给 Claude 的玩法、清单、流程、操作剧本沉淀下来。官方建议在这些情况下把内容从聊天或CLAUDE.md里升级成 Skill你反复粘贴同一套 playbook、checklist 或 multi-step procedure或者某段CLAUDE.md已经从“事实说明”膨胀成“操作流程”。你可以把 Skill 理解成这样一个函数它不直接给 Claude 新的外部系统权限而是给 Claude 一套更稳定、更可复用的做事方式。Skills 最适合什么场景最适合 Skills 的不是“接数据库”这种外部连接问题而是这些内部工作流问题固定的 code review 清单某类 bug 的排查套路某种 PR 生成模板某套重构流程某个测试与验证清单Anthropic 还写到Claude Code 内置了一些 bundled skills比如/simplify、/batch、/debug、/loop、/claude-api。它们和内置命令不一样这些 bundled skills 是 prompt-based 的相当于给 Claude 一套详细的操作剧本再由 Claude 自己去编排执行。Skills 和 CLAUDE.md 的区别这点特别容易混。CLAUDE.md更像“长期规则和背景说明”而 Skill 更像“某种可被调用的专项做法”。官方文档明确说CLAUDE.md是你希望 Claude 每次开局都知道的项目规则而 Skill 的正文则是按需加载。所以最短的判断标准是事实、规则、架构背景放CLAUDE.md步骤、套路、清单、流程做成 Skill。二、Hooks它不是“能力”而是“自动触发器”Hooks 解决的不是“Claude 会什么”而是“Claude 在什么时机自动做什么”。Anthropic 的 Hooks 文档定义得非常清楚Hooks 是用户自定义的 shell 命令、HTTP 端点或 LLM prompts它们会在 Claude Code 生命周期的特定点自动执行。Claude Code 会把事件相关的 JSON 上下文传给 Hook 处理器然后由处理器决定采取什么动作必要时还可以返回决策。这说明 Hook 的本质不是“新功能”而是事件驱动自动化。如果把它抽象一下可以写成其中event是 Claude Code 发生的生命周期事件context是 Claude Code 传来的 JSON 上下文h是你定义的处理逻辑Hooks 触发在什么时候官方把 Hooks 的事件节奏分成三类每次会话一次如SessionStart、SessionEnd每轮一次如UserPromptSubmit、Stop、StopFailureagent loop 内每次工具调用如PreToolUse、PostToolUse文档还给出了完整的生命周期图里面甚至包括SubagentStart/Stop、TaskCreated/Completed、FileChanged、ConfigChange等异步事件。这意味着 Hook 非常适合做这些事修改文件后自动跑测试执行命令前做权限检查会话结束时自动总结调某类工具前插入规则校验结果失败时自动触发告警或后处理Hooks 最适合什么场景一句话只要你希望“某件事在某个时机自动发生”就该优先想 Hook。它非常适合自动测试自动 lint自动安全检查自动通知自动审计自动后处理所以 Skills 和 Hooks 的关键区别是Skill 是“怎么做”Hook 是“什么时候自动做”。MCP 这几年最容易被说偏。它不是 Claude Code 的某个“小插件机制”而是一套独立标准。MCP 官方把它定义为一种把 AI 应用连接到外部系统的开源标准。使用 MCP像 Claude 或 ChatGPT 这样的 AI 应用可以连接到数据源、工具和工作流官方甚至把它类比为 AI 应用的 “USB-C 接口”。Anthropic 在 Claude Code 的 MCP 文档里也写得非常直白Claude Code 可以通过 MCP 连接到数百种外部工具和数据源MCP server 可以给 Claude Code 提供对工具、数据库和 API 的访问能力。官方给的典型使用时机是当你发现自己总在把 issue tracker、监控面板之类的数据复制进聊天框时就该考虑直接接 MCP让 Claude 能读并操作那个系统。所以 MCP 解决的问题是Claude 怎么接入“代码库之外的世界”。比如JIRA / Linear / GitHub IssuesPostgreSQL / MySQL / RedisSentry / Datadog / StatsigFigma / Slack / Notion自己公司的内部 APIMCP 在 Claude Code 里到底扮演什么角色它不是行为逻辑层而是外部能力接入层。也就是说Claude 会不会用这些工具、何时用、怎么组织调用是上层 agent loop 的事但这些工具“能不能以统一方式暴露出来”是 MCP 解决的事。MCP 规范里把服务器暴露的能力分成三大类Resources提供上下文和数据Prompts提供模板化消息和工作流Tools提供可由模型调用的函数能力。所以 MCP 比“工具调用”更高一层它不只是函数而是一个标准化的 AI 外部接口层。MCP 最适合什么场景最适合 MCP 的场景不是“写一个内部固定流程”而是你要接很多外部系统你不想每个系统都手写一套对接方式你希望外部能力能被 Claude 统一发现和调用你希望未来这些外部能力能复用到别的 AI 客户端里Anthropic 还特别提醒第三方 MCP server 需要谨慎使用因为可能带来 prompt injection 等安全风险尤其是会接触不可信内容的服务器。Subagents 这一层经常被误以为只是“多开几个 Claude”。其实不是。Anthropic 文档明确写到Claude Code 有内置 subagents而且 Claude 会根据 subagent 的描述自动决定什么时候把任务委派出去。官方列出的内置 subagents 里至少包括Explore快速、只读适合文件发现、代码搜索、代码库探索Plan在 plan mode 下做研究帮助形成计划General-purpose适合需要探索和修改并存的复杂多步任务。文档还说明Claude 会自动在合适的时候使用 specialized subagents例如“审查最近改动的安全问题”或“运行全部测试并修复失败”。Subagents 真正解决的是什么问题不是“系统接入什么”而是复杂任务应该让谁去做才能更高效、上下文更干净、角色更专一。你可以把它理解成任务分派Subagent 最有价值的地方有两个上下文隔离不是把所有探索细节都塞进主会话角色专门化不同代理用不同工具限制、不同描述、不同任务边界官方文档里就明确写到 Explore 是只读工具集Plan 也限制为只读而 General-purpose 则拥有全部工具。也就是说Subagent 不是“同一份 Claude 多开窗口”而是带限制、带角色、带职责分工的代理单元。Subagents 最适合什么场景当你发现任务已经出现这些特征时就该考虑 Subagent需要先探索再行动需要研究与执行分开需要把某类任务交给只读代理需要让复杂任务不污染主对话上下文这和 Skill、Hook、MCP 都不是一个问题层。能力解决什么问题最像什么典型使用场景Skills把常用做法沉淀下来可复用剧本 / 清单Debug 流程、PR 模板、代码评审清单Hooks在特定时机自动触发逻辑事件驱动自动化改完文件自动测试、失败自动告警MCP把外部世界接进来标准化外部接口层数据库、工单、监控、设计系统Subagents把复杂任务拆给专门代理角色分工 / 任务委派Explore、Plan、复杂多步任务五、最容易犯的错把四者当成替代关系实际上一旦你理解分层就会发现这四者不是互相替代而是经常一起出现。一个很典型的场景是用MCP接进 JIRA、Sentry、数据库用Subagent先做探索和计划用Skill固化“修 Bug 的标准流程”用Hook在修改后自动跑测试和报告结果这时候系统才真正像一个“能接外部世界、能拆任务、会按流程做事、还能自动验证”的编程代理。所以千万不要问“我到底该用 Skills 还是 MCP”更准确的问题应该是“我当前遇到的问题是流程复用问题、自动触发问题、外部连接问题还是任务分工问题”问题层级不同答案自然不同。六、一个最实用的判断法你该先加哪一层如果你想快速判断自己现在最该配什么可以直接按这个顺序问。第一问你是不是总在重复给 Claude 讲同一套流程如果是优先做Skill。因为这说明问题不是“Claude 不会接工具”而是“你没有把最佳做法沉淀下来”。第二问你是不是希望某些动作在固定时机自动执行如果是优先配Hook。因为这说明问题不是“能力不够”而是“触发机制不自动”。第三问你是不是总在手动把外部系统的信息复制进聊天如果是优先接MCP。Anthropic 官方就直接建议当你发现自己总在粘 issue tracker 或 monitoring dashboard 的数据时应该考虑接 MCP server。第四问你的任务是不是已经复杂到一个代理做会把上下文搞得很乱如果是优先考虑Subagent。因为这说明问题已经不是“有没有流程”而是“是否该分工”。Skills 解决“会什么”Hooks 解决“何时自动做”MCP 解决“能连到什么”Subagents 解决“谁来做”。这才是 Claude Code 扩展体系最清晰的分层。