我在工程目录里看到CLAUDE.md这个文件时，第一反应通常不是把它当成普通说明文档，而是把它看成一份写给 Claude Code 的项目交接卡。普通的README.md多半面向人，告诉团队成员这个项目是什么、怎么安装、怎么运行、怎么参与开发。CLAUDE.md的读者则更特殊，它面向的是 Claude Code 这样的编码代理，用来告诉它进入这个仓库之后应该记住哪些项目规则、工程背景、命令习惯和协作边界。Anthropic 的 Claude Code 文档把CLAUDE.md描述为一种持久指令文件，每次会话开始时，Claude Code 会读取这些文件，把其中的内容放进上下文里，作为后续编码、解释、修改和执行命令时的参考。(Claude API Docs)
它不是神秘文件，而是项目里的长期提示词
很多人第一次看到CLAUDE.md，会误以为它是 Claude Code 自动生成的缓存，或者某种运行时配置。这个理解只对了一小半。它确实和 Claude Code 的运行有关，但它不是临时缓存，也不是像settings.local.json那样偏向权限、环境变量、工具开关的配置文件。更准确地讲，CLAUDE.md是一份长期提示
