很多团队刚开始用 Claude Code 时，最容易踩的坑不是模型不够强，而是把 Claude Code 当成一个每次都重新认识项目的新同事。今天在终端里让它修一个 bug，明天让它补一组测试，后天让它改一个接口校验规则，每一次都要重复解释项目怎么启动、测试怎么跑、代码风格有什么怪癖、哪些目录不能乱动。时间久了，大家会误以为 Claude Code 记性差，其实问题常常出在项目没有给它一份稳定、清晰、不过度膨胀的项目说明。这个说明文件就是 CLAUDE.md。Claude Code 官方文档把 Claude Code 定义为一种 agentic coding tool，它可以读取代码库、编辑文件、运行命令，并和开发工具集成。也正因为它会进入真实代码库工作，单纯依靠一次性 prompt 并不够。CLAUDE.md 的价值就在这里，它会在会话启动时进入上下文，让 Claude Code 在开始读代码之前，先知道我们这个项目有哪些长期有效的规矩。官方文档也明确提到，项目级 CLAUDE.md 可以放在 ./CLAUDE.md 或 ./.claude/CLAUDE.md，用来记录 build 命令、测试说明、项目约定、架构决策、命名规则和常用工作流，并通过版本控制分享给团队。(Claude Platform Docs)CLAUDE.md 不是项目百科，而是驾驶舱仪表盘写