打开一个长期维护的前端仓库，最容易让 Claude Code 跑偏的地方，往往不是模型能力不够，而是项目默认假设没有被说清楚。我们平时写代码时脑子里有很多隐含规则，构建用npm run build，测试用npm test，组件只写函数组件，API 返回结构统一走{ data, error }，导出一律用 named exports。这些东西对团队成员来说可能已经形成肌肉记忆，可对 Claude Code 来说，如果每次会话都不重新给上下文，它并不会天然知道这些约定。CLAUDE.md就是为了解决这类问题准备的。它不是普通的 README，也不是写给人类新人看的长篇项目介绍，而是 Claude Code 每次进入仓库工作时都会读取的一份项目行为说明。Anthropic 官方文档把CLAUDE.md描述为给 Claude 提供项目、个人工作流或组织级持久指令的 Markdown 文件，并明确说这些文件会在每个 session 开始时被读取。(Claude)CLAUDE.md不是知识库，而是工作前提很多团队刚开始用 Claude Code 时，会把CLAUDE.md写成一份全量知识库，里面塞进业务背景、数据库表结构、接口