我最近看 Claude Code 的扩展体系，最容易踩进去的坑，不是某个功能不会用，而是把所有功能都当成同一种东西。CLAUDE.md、Skill、Subagent、Agent teams、Code intelligence、MCP、Hook、Artifact、Plugin，看起来都在扩展 Claude Code，实际它们插入的是完全不同的位置。Anthropic 的官方文档也把这一层讲得很清楚，Claude Code 自带文件操作、搜索、执行和 Web 访问这些基础工具，扩展层主要负责三件事，定制 Claude 知道什么，连接外部系统，自动化开发流程。这件事放到真实开发现场里，会非常直观。我们做一个 SAP Fiori Elements 项目，团队约定使用 pnpm，不使用 npm，提交前必须跑单元测试和 lint，RAP unmanaged 保存逻辑要放在 behavior pool 的 helper class 里，CDS UI annotation 优先放在 consumption view 或 metadata extension 里。这些规则每天都要被 Claude Code 看见，不能靠每次聊天时临时补一句。这个位置就属于 CLAUDE.md。官方文档里也说明，CLAUDE.md 和 rules 文件会给 agent 提供项目持久上下文，例如编码约定、构建命令、架构决策和指令，加载后 agent 可以在会话开始时理解我们的项目规则。CLAUDE.md 的价值不是让 Claude Code 变得更聪明，而是减少反复解释。我们可以把它想成项目里的老员工手册。新人进项目之前，不需要每次都问这个仓库用什么包管理器，测试命令是什么，目录分层怎么走，哪些文件不能改。Claude Code 进入会话时读取这些常驻背景，后续判断才不会
