
打开一个长期维护的前端仓库,最容易让 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写成一份全量知识库,里面塞进业务背景、数据库表结构、接口