别把 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当成一个万能入