Claude Code 记不住项目规则?用好 CLAUDE.md
Claude Code 记不住项目规则,很多时候不是它“忘性大”,而是规则只存在聊天记录里,没有沉淀到项目记忆。真正稳定的做法,是把重复出现的约束写进 CLAUDE.md,再把临时要求留在本次任务里。
哪些内容值得写进 CLAUDE.md
适合放进去的是长期有效的项目事实:安装命令、测试命令、目录边界、代码风格、提交前检查、不要改哪些文件、业务里的固定术语。Anthropic 的 Claude Code memory 文档提到用记忆文件保存项目上下文,这类信息越具体,越能减少每次重复解释。
不要把临时任务也塞进去
CLAUDE.md 不是任务清单。如果你把“这次要修登录页”“今天先别动支付模块”都写进去,过两天它反而会变成噪音。临时限制写在当前对话里,长期规则才进文件。一个好判断是:三个月后新同事看这条规则是否仍然有用?有用就保留,没用就别进项目记忆。
规则写得越可验证越好
“保持代码简洁”不如“新增 API 调用必须走 src/lib/request.ts”;“注意测试”不如“改动业务逻辑后运行 npm test -- workspace”。Claude Code 不是不能理解抽象要求,但工程项目更需要可检查的规则。每条规则都尽量对应路径、命令或例外情况。
发现它忽略规则时怎么处理
先不要扩大提示词。让它复述当前会遵守的项目规则,再要求它解释本次改动是否触碰这些规则。如果它读不到 CLAUDE.md,检查文件位置和项目根目录;如果规则过多,删掉重复和空话。项目记忆应该像开发手册的精简版,而不是把所有聊天记录打包进去。