今天这个问题很典型，CLAUDE.md 写着写着就变成了一份小型团队手册。刚开始只有构建命令、测试命令、代码风格，后来又塞进 Git 流程、RAP 规则、Fiori Elements 约定、Angular 目录规范、OData 命名习惯、排错经验、上线注意事项。文件越写越长，看起来信息越来越全，Claude Code 的表现却可能越来越飘，偶尔忘记规则，偶尔抓错重点，偶尔把一句临时说明当成全局原则。
Claude Code 官方文档给出的建议很直接，单个 CLAUDE.md 文件最好控制在 200 行以内。超过 200 行以后，它会消耗更多 context，并可能降低指令遵循稳定性。更大的问题不只是 token 变多，而是启动时进入模型视野的信息密度变得过高，真正关键的规则被淹没在大量背景材料里。官方还强调，CLAUDE.md 是进入 context 的指令，而不是强制配置，写得越具体、越简洁、越结构化，Claude Code 越容易稳定遵循。(Claude)
大 CLAUDE.md 的问题，不是文件大，而是每次都全量进入现场
我们很容易把 CLAUDE.md 理解成一个项目知识库，什么都往里面放。这个直觉有一半是对的，因为 CLAUDE.md 确实适合存放跨会话需要反复解释的项目知识。官方文档也说，CLAUDE.md 适合记录那些新成员也需要知道的上下文、Claude Code 重复犯错后需要固化的规则、代码审查