别把 CLAUDE.md 当备忘录垃圾桶,真正该写进去的是反复发生的项目事实
我们今天聊的这个主题很小,只有一个问题,什么时候才应该把内容加进CLAUDE.md。但这个问题背后,其实牵着 Claude Code 使用体验里最容易被低估的一件事,项目记忆不是越多越好,规则也不是越细越安全。真正稳定的做法,是把那些每一轮会话都应该知道、每一次协作都会反复解释、每一个新同事接手项目时也必须理解的信息,沉淀成一层干净、克制、长期有效的上下文。Claude Code 官方文档对CLAUDE.md的定位很清楚,它是由我们自己编写的 Markdown 文件,用来给 Claude 提供项目、个人工作流或组织层面的持久指令,并且会在每个会话开始时被读取。官方也强调,Claude Code 的每个会话都有新的上下文窗口,跨会话保留知识主要依赖两类机制,一类是我们写的CLAUDE.md,另一类是 Claude 自己根据纠正和偏好积累的 auto memory。这个设计很像团队里的项目交接文档,但又不完全一样。项目交接文档可以写得很长,可以解释历史、取舍、争议和背景;CLAUDE.md更像贴在开发工位旁边的那张小纸条,上面写的是每天都会用到的规矩。比如构建命令是什么,测试命令是什么,代码目录怎么分层,哪些文件不能手工改,提交前必须跑哪套检查,API 错误响应必须遵循哪种结构。这些内容没有必要每次在聊天里重复,也不应该依赖 Claude 通过猜测来恢复。CLAUDE.md 的核心判断,不是重要不重要,而是是否每次都该知道很多团队在刚开始使用 Claude Code 时,容易把CLAUDE.md当成一个万能入