CLAUDE.md 到底怎么写：Claude Code 的项目记忆与团队规范
一句话主线：你告诉过 Claude Code 的规则，不该每次都靠嘴说。CLAUDE.md 就是写给 Agent 的"项目交接文档"——短一点、准一点、硬一点，它就能少猜一点。 引言：为什么你总是在重复教育 Claude Code 用 Claude Code 的人基本都经历过这个循环： 第一轮你告诉它：“这个项目用 pnpm，不要用 npm。“过一会儿它开始建议 npm install。你告诉它"不要直接改数据库表结构”，修着修着它又想动 schema。你说"改完要跑单测”，它改完代码就准备收工了。 这时候很多人会怀疑：是不是模型不听话？ 不完全是。 真正的问题是：你把项目长期规则，当成了临时聊天内容。 聊天内容会随着任务变长被文件内容、命令输出、错误日志淹没；一旦上下文压缩、裁剪、切换任务，它就可能忘。你以为 Claude Code “记得"这些规则，其实它只是"当前上下文里还能看到”。 所以项目规则需要一个更稳定的入口——这就是 CLAUDE.md。在《Claude Code 高效使用指南》里我讲过它是六种扩展能力的第一层，这篇专门把它拆开讲透。 1. CLAUDE.md 到底是什么 CLAUDE.md 就是一个普通的 Markdown 文件，Claude Code 进项目时会自动读取，把内容作为项目上下文的一部分。注意三个关键词： 第一，它是普通 Markdown。 不是配置文件，不是 JSON/YAML，不需要复杂语法。就像给新同事写的说明文档一样写就行。 第二，它是给 Claude Code 看的。 README 主要给人看，CLAUDE.md 主要给 AI 编程 Agent 看。所以不用写项目愿景、业务背景长文、团队文化，要写的是能直接影响 Agent 行动的信息。 第三，它会进入上下文。 这一点最容易被忽略：规则参与后续推理，所以它能让 Claude Code 更稳定——但也会占上下文窗口。这直接决定了一条写作原则： CLAUDE.md 要短、准、可执行。不是越长越好。 2. 和 README、Prompt、Memory 有什么区别 很多人的第一个疑问是：我都有 README 了，还要 CLAUDE.md 干嘛？ ...