源自 Karpathy 编程经验的 CLAUDE.md 配置文件登上 GitHub 趋势榜第一，6 万开发者抄作业。四条核心原则帮你大幅提升 AI 编程质量。
源自 Karpathy 编程经验的 CLAUDE.md 配置文件登上 GitHub 趋势榜第一，6 万开发者抄作业。四条核心原则帮你大幅提升 AI 编程质量。
华中科大×小红书开源的 MOCR，不只识别文字，还能把文档里的图表、公式、流程图全部解析为结构化代码
一个纯文本的 Markdown 文件，没有一行代码，却在 GitHub 上连续三天霸占趋势榜日榜第一，本周新增 44,465 颗星。它叫 CLAUDE.md，一个放在项目根目录的配置文件，里面写了四条规矩，用来管住 AI 编程时最常犯的毛病。
CLAUDE.md 是一个 Markdown 格式的配置文件，放在项目根目录下，AI 编程 Agent（如 Claude Code、Cursor）会自动读取并遵守其中的规则。它的核心思路是：把资深工程师的隐性知识，打包成 Agent 可以直接理解和执行的指令。
项目地址：https://github.com/forrestchang/andrej-karpathy-skills
这个文件的源头是 Karpathy 今年 1 月在 X 上发的长帖，详细吐槽了 AI 编程 Agent 的各种问题。华人开发者 Jiayuan Zhang 将其提炼为四条可执行的规则。
问题：你让 AI "加个验证功能"，它不会问你验证什么、严格程度如何，而是直接猜一个最复杂的方案写一大堆不需要的代码。
规则：
问题：你想要一个简单功能，AI 给你写一整套企业级架构，附带登录认证、安全校验、流量控制。你说"简单点"，它立刻砍掉大半并说"当然可以"。
规则：
检验标准：一个资深工程师看了会不会说"太复杂了"。会的话，直接砍。
问题：你让 AI 修一个 bug，它改完 bug 顺手把旁边的代码也重构了，变量名换了，注释删了。改了 30 处，其中 25 处跟你的需求无关。
规则：
问题：AI 擅长"循环到达标为止"，但你告诉它具体步骤反而限制了它的发挥。
规则：
这是用 AI 编程时杠杆最大的一条原则。验收标准定得越清晰，AI 能独立执行的时间越长，你需要介入的频率就越低。
# 示例：在 CLAUDE.md 中加入项目特定规则
## 项目约定
- 使用 TypeScript strict 模式
- 组件文件名用 PascalCase
- API 接口统一放在 src/api/ 目录下
- 写新功能前先写测试正如开发者 Kraggich 说的："一个 Markdown 文件冲上趋势榜第一，说明现在的瓶颈不在模型，而在模型周围的脚手架。这些'胶水'才是产品本身。"
另一位开发者算了一笔账：模型选错了分支，运行了 40 分钟最后碰壁失败。而提前澄清只需要 30 秒。
Karpathy 自己说，短短几周内他的编程工作流从"80% 手写 + 20% AI 辅助"彻底翻转成了"80% 交给 Agent + 20% 自己修补"。这个 CLAUDE.md 就是让这个翻转真正可靠的关键工具。
