深度

Claude Code 扩展能力全景图:CLAUDE.md、Skills、MCP、Subagent、Agent Teams、Hooks 选型指南

Claude Code 六大扩展能力选型完整指南:CLAUDE.md/Skills/Subagent/Agent Teams/MCP/Hooks 功能对比表、相似能力深度辨析(Skill vs Subagent/CLAUDE.md vs Skill/CLAUDE.md vs Rules vs Skills/Subagent vs Agent Teams/MCP vs Skill)、分层优先级规则(managed>user>project)、各扩展 Context 成本对比,以及数据库开发/代码审查/CI/CD 三大实战组合方案。

2026/3/66分钟 阅读ClaudeEagle

Claude Code 内置工具已经覆盖大多数编码任务。但当你需要自定义知识、连接外部服务或自动化工作流时,扩展层能大幅提升效率。本文是所有扩展能力的选型指南。

六大扩展能力一览

扩展能力作用何时使用示例
CLAUDE.md每次对话都加载的持久上下文项目约定、「始终做 X」规则「用 pnpm 不用 npm,提交前先跑测试」
Skill可复用的知识、工作流、参考文档参考资料、可重复任务/review 执行你的代码审查清单;API 文档 Skill
Subagent隔离执行上下文,返回摘要结果Context 隔离、并行任务、专项工作者读取大量文件的调研任务,只返回关键发现
Agent Teams协调多个独立的 Claude Code 会话需要讨论和协作的复杂工作同时派出 Security/Performance/Test 三个审查员
MCP连接外部服务外部数据或操作查询数据库、发 Slack 消息、控制浏览器
Hooks确定性脚本,响应特定事件可预测的自动化,不需要 LLM每次文件编辑后运行 ESLint

Plugins 是打包层:将 Skills、Hooks、Subagents、MCP 服务器打包为单个可安装单元,通过 Marketplace 分发。

相似能力如何选择

Skill vs Subagent

维度SkillSubagent
本质可复用的指令/知识/工作流独立的工作者,有自己的 Context
核心优势跨上下文共享内容Context 隔离,工作独立进行,只返回摘要
最适合参考资料、可调用工作流读取大量文件的任务、并行工作、专项工作者
  • 用 Skill:当你需要 Claude 在会话中随时可查阅的知识(API 风格指南),或触发 /<name> 命令的工作流(/deploy
  • 用 Subagent:当任务需要 Context 隔离,或 Context 窗口快满了——Subagent 读几十个文件或大量搜索,主对话只收到摘要

CLAUDE.md vs Skill

维度CLAUDE.mdSkill
加载时机每次会话自动加载按需加载(被调用时)
可触发工作流✅(/<name> 命令)
最适合「始终做 X」规则有时需要的参考资料,或可触发的工作流

经验法则:CLAUDE.md 保持在 200 行以内。增长过快时,把参考内容移到 Skills 或 .claude/rules/ 文件。

CLAUDE.md vs Rules vs Skills 三选一

CLAUDE.md.claude/rules/Skill
加载时机每次会话每次会话,或匹配文件时按需
作用范围整个项目可限定到特定文件路径特定任务
最适合核心约定和构建命令语言/目录特定规范参考资料、可重复工作流

Subagent vs Agent Teams

维度SubagentAgent Teams
Context独立 Context,结果返回给调用者独立 Context,完全独立
通信方式只向主 Agent 汇报队友之间可以直接互发消息
协调方式主 Agent 管理所有工作共享任务列表 + 自我协调
最适合只需要结果的专项任务需要讨论和协作的复杂工作
Token 成本较低:结果摘要返回主 Context较高:每个队友是独立的 Claude 实例

转折点:并行运行 Subagents 但遇到 Context 限制,或 Subagents 需要互相通信时,升级到 Agent Teams。

MCP vs Skill

维度MCPSkill
提供工具和数据访问知识、工作流、参考资料
示例Slack 集成、数据库查询、浏览器控制代码审查清单、部署工作流、API 风格指南

组合使用:MCP 给 Claude 连接外部系统的能力;Skill 教 Claude 如何有效使用这些工具,包含你的数据模型、常用查询模式等。

能力分层与优先级

当同一功能在多个层面定义时:

  • CLAUDE.md 文件:累加式,所有层级同时贡献内容。指令冲突时 Claude 用判断调和,更具体的指令通常优先。
  • Skills 和 Subagents:同名时高优先级覆盖低优先级(managed > user > project for skills)
  • MCP 服务器:同名时 local > project > user
  • Hooks:合并,所有注册的 Hook 都会触发

理解各扩展的 Context 成本

扩展能力Context 消耗说明
CLAUDE.md每次会话全量每条消息都要消耗
Skills(全局)会话开始时加载描述调用时加载完整内容
Skills(手动触发)调用时才加载disable-model-invocation: true 可完全延迟
MCP 服务器每次请求都加载工具定义即使空闲也消耗 Context
Subagents独立 Context,只返回摘要不占用主对话 Context
Agent Teams每个队友独立 Context约是单会话的 7 倍 Token
Hooks0(在循环外运行)确定性脚本,不涉及 LLM

实战组合案例

数据库开发工作流

  • MCP 服务器连接 PostgreSQL
  • Skill 包含数据库 Schema 和常用查询模式
  • Hook 在每次 SQL 文件编辑后自动运行 linter
  • Subagent 读取大量日志文件并返回性能分析摘要

代码审查流程

  • CLAUDE.md 包含团队编码规范(构建命令、分支命名)
  • Skill(/review)包含完整的代码审查清单
  • Agent Teams:Security 审查员 + Performance 审查员 + Test 覆盖审查员并行工作

CI/CD 自动化

  • Hooks 在文件保存后自动运行测试
  • Subagent 在后台读取测试日志并返回失败摘要
  • MCP 连接 GitHub,自动创建 PR

原文:Extend Claude Code | 来源:Anthropic 官方文档

相关文章推荐

深度Claude Code 团队多代理协作完全指南:并行任务、跨会话通信与 Git WorktreesClaude Code Agent Teams 多代理协作完全指南:子代理 vs Agent Teams 的选择标准、Git Worktrees 隔离并行修改、三种协作模式(协调者-工人/流水线/专家池)、并行 PR 审查和大型迁移任务的实战案例,以及上下文管理和冲突避免注意事项。2026/3/2深度Claude Code Plugins 开发指南:从零创建插件、打包 Skills 与发布到官方市场Claude Code 插件开发完整指南:独立配置 vs 插件的选择标准、创建 plugin.json 清单、添加 Skills/子代理/Hooks/MCP 服务器、本地 --plugin-dir 测试、LSP 服务器集成、发布到官方市场,以及从现有 .claude/ 配置迁移的步骤。2026/3/2深度Claude Code Agent Teams:多实例并行协作开发完全指南Claude Code Agent Teams 实验性功能详解:多实例并行协作开发,一个负责人会话协调多个独立 Claude 实例。涵盖与 Subagents 的对比选择、开启配置、计划审批工作流、并行代码审查和竞争假设调试等实战场景,以及 Token 成本考量。2026/2/28深度Claude Code Agent Teams 实战:多 Agent 协作并行开发新范式Claude Code Agent Teams 是多 Claude 实例协作的实验性功能,允许成员间直接通信(不同于 Subagents 只能向主 Agent 报告)。本文对比 Subagents 和 Agent Teams 的架构差异,介绍四大最佳应用场景(并行研究、模块开发、竞争假设调试、跨层协调),以及启用方法、共享任务列表工作原理和成本管理策略。2026/2/27深度OpenClaw Skills 系统完全指南:安装、配置与开发自定义技能OpenClaw Skills(技能)系统完整指南(2026 最新版):Skills 是什么(AgentSkills 兼容的 SKILL.md 目录)、三级加载优先级(bundled/managed/workspace)、多 Agent 环境下的 Skills 共享机制、ClawHub 技能市场(安装/更新/同步命令)、SKILL.md 格式规范(YAML frontmatter/gating 条件/installer 配置)、openclaw.json 中启用/禁用/注入 API Key 的方法、Plugin 携带 Skills 的工作方式,以及从零开发一个自定义 Skill 的完整步骤。2026/3/21深度Claude Code 最佳实践 2026:资深用户总结的 20 个效率提升技巧Claude Code 资深用户总结的 20 个实用最佳实践:上下文管理技巧(精准投喂 vs 全量读取)、CLAUDE.md 高价值写法、自定义命令的场景化设计、权限配置的最小化原则、子代理并行的触发时机、会话压缩与续接的使用策略、与 Git 工作流的结合方式、代码审查的标准提示词、让 Claude 解释而不只是修改代码的技巧、以及避免 Claude「过度自信」的提示词防护模式。2026/3/21