andrej-karpathy-skills

一个文件，撼动了AI编程助手行业

2026年1月26日，AI传奇研究者Andrej Karpathy在X上发了一条推文，指出了大语言模型（LLM）在编程任务中最常见的行为缺陷：它们会替你做出错误假设，不懂得寻求澄清，喜欢把代码搞复杂，不清理死代码，甚至不理解自己改了什么就贸然行动。这条推文在24小时内获得了超过500万次浏览。 开发者Forrest Chang看到了这条推文，并做了一件看似微不足道的事：他把Karpathy的四个核心观察，浓缩成了一份65行的行为指南文件，起名为CLAUDE.md。 然后，他把这个文件开源了。 一个月内，这个只有单个文件的仓库冲上了GitHub Trending榜首，狂揽14.6万颗星——这是GitHub历史上增长速度最快的纯文档类项目之一。

这个文件到底在管什么？

CLAUDE.md不是代码，而是一份给AI编程助手（如Claude Code）阅读的指令集。它的核心理念只有四条：

第一条：编码前先思考

在动手之前，AI需要先明确自己的假设是什么。如果有多种理解方式，必须先呈现给用户，而不是选一个自己猜的。如果发现需求中存在矛盾，要主动提出来，而不是假装没看见。Karpathy的原话是：不要隐藏困惑，要主动暴露困惑。

第二条：极简主义优先

只写解决问题的最少代码，不要写以后可能用得上的代码。不要为单次使用的代码创建抽象层。不要添加没被要求的功能。如果200行能解决，为什么要写500行？AI有一个坏习惯：用灵活性和可配置性的幌子来掩盖过度设计。

第三条：精准改动

修改代码时，只动必须改的部分。不要顺便改进旁边的代码或注释，不要重构没有坏的东西。如果你的改动产生了未使用的导入或变量，清理掉——但只清理你自己引入的垃圾。

第四条：验证后再提交

改变逻辑或删除代码时，必须先运行测试。如果没测试，主动说明潜在风险。不要在不理解代码的情况下修改它，即使任务是添加一个功能。

这个项目包含哪些内容？

该仓库并非只有一个CLAUDE.md文件。它实际上是一个多平台AI编程指南集合，包括：

为什么这个项目如此特别？

它的本质是一个元工具——不是帮AI完成某个具体任务，而是改变AI完成任务的方式。 传统的AI编程工具（如Copilot、Codeium）提供的是代码补全。而CLAUDE.md做的是另一件事：约束AI的行为模式，让它更像一个谨慎的资深工程师，而不是一个过于自信的初级程序员。 这揭示了一个重要趋势：当AI编程工具变得越来越强大时，对AI行为进行软约束的需求正在快速增长。GitHub Copilot有Copilot Labs，Cursor有Rules，Claude Code有CLAUDE.md——这是一个正在形成的新赛道。

如何使用？

方式一（手动）： 将CLAUDE.md的内容追加到你的项目根目录CLAUDE.md文件末尾，Claude Code会自动读取。 方式二（通过Multica平台）：

npx skills add https://github.com/forrestchang/andrej-karpathy-skills

方式三（Claude Code Marketplace）： 直接从Claude Code的官方插件市场安装。

局限与争议

这个项目并非完美。 首先，它不是Karpathy本人写的——Forrest Chang只是基于Karpathy的推文进行了二次创作。Karpathy本人并未为这个项目背书。 其次，这份指南偏保守。作者自己也承认，它倾向于谨慎而非速度。对于需要快速迭代的原型开发场景，这套规则可能过于严格，甚至降低开发效率。 第三，它的效果难以量化。你无法直接测量因为用了CLAUDE.md，我的代码bug率降低了多少。它更像是一种工程文化的体现，而非技术解决方案。

行业意义

无论你是否认同这套指南的每一个细节，有一点是确定的：它代表了AI编程工具发展到了一个新阶段——从如何让AI帮我写代码，进化到了如何让AI用正确的方式帮我写代码。 14.6万颗星背后，是数十万开发者对AI编程助手应该有行为规范这一理念的认同。这个数字本身，就是最好的证明。