CLAUDE.md 是给 Claude Code（Anthropic 推出的 AI 编程助手）用的项目级「行为说明书」 ------放在仓库根目录，每次启动会话会自动读取，相当于把团队规范、技术栈、做事风格写成一份持久化、可版本管理的系统提示词。
一、它为什么突然爆火
- 起源：前特斯拉AI总监、OpenAI 联合创始人 Andrej Karpathy 发推总结了 LLM 写代码的常见坑（乱改、臆测、不澄清、重构成瘾）。
- 走红项目：开发者 Forrest Chang 把这些观察浓缩成 4 条核心原则 ，写成一个 65 行的
CLAUDE.md，开源在forrestchang/andrej-karpathy-skills。 - 数据：2026 年 1 月上线，4--5 月病毒式传播，Star 破 12 万、Fork 超 10 万，成 GitHub 史上涨星最快的 AI 项目之一。
二、核心作用（一句话说清）
不用每次跟 AI 重复交代：
- 项目用什么技术栈/框架/版本
- 代码风格、命名规范、目录结构
- 哪些文件绝对不能碰
- 怎么写测试、怎么提交、怎么部署
- 遇到模糊需求要追问，不要瞎猜
它就是 AI 编程时的**「项目宪法」**。
三、Karpathy 版四条黄金法则（精简）
- Think Before Coding（先想再写）
- 先理解需求、边界、依赖；有歧义立刻追问，不要自己脑补。
- Simplicity First（简单优先）
- 能用简单方案就不搞复杂设计；不提前优化、不过度工程化。
- Surgical Changes（精准修改）
- 只改必须改的地方，不"顺手"重构、不扩写无关代码；Git Diff 要干净。
- Goal-Driven Execution（目标驱动）
- 先写测试（TDD），再改代码；每一步都要可验证、可复盘。
四、文件位置与优先级（可多层叠加）
Claude Code 会按顺序加载，后加载的规则优先级更高：
- 全局：
~/.claude/CLAUDE.md（个人所有项目生效） - 项目：
./CLAUDE.md（仓库根目录，提交到 Git，团队共享） - 目录：子目录下的
CLAUDE.md（局部规则）
五、怎么用（30 秒上手）
- 在项目根目录新建
CLAUDE.md。 - 把 Karpathy 四条规则抄进去，再补充项目专属规则（技术栈、禁改文件、命令等）。
- 提交到 Git，团队共享。
- 用 Claude Code 打开项目，它会自动读取并遵守。
六、为什么大家疯狂跟风
- 零成本、零依赖：一个纯文本文件，不用安装、不用配置。
- 效果立竿见影：显著减少 AI 乱改、重构、臆测的问题，代码质量和开发效率大幅提升。
- 可复制、可传播：像"AI 编程疫苗"一样，快速在全行业扩散。
要不要我把 Karpathy 原版的 65 行 CLAUDE.md 全文贴给你，你直接复制就能用？