一个 100k+ Star 的 CLAUDE.md 规则文件 ，改掉 AI 编码常见坏习惯
公众号名称：菜鸟教程
作者名称：RUNOOB
发布时间：2026-04-29 11:27
现在写代码，每天基本都跟 Claude、Cursor、或者其他 AI coding agent 打交道，有时候用这些工具，到不是怕 AI 不会写，而是太会写，聪明过头或乱改一通的折腾～
所以我们在用这些工具的时候必须给这些 AI 工具加一点规范，免的它天天总是_擅作主张，问也不问直接替我们做了决定～_
如果不加上一些规范，这些工具就不会问你要什么，而是假设了你要什么，然后一路冲下去。
Andrej Karpathy（那个教 AI 写代码，快把自己也搞失业的） 在社媒上也曾经吐槽过：
模型会替你做假设然后一路跑下去，不核实、不暴露歧义、不呈现权衡、不在该反驳时反驳。
它们超级喜欢把代码搞复杂——堆抽象、撑 API、不清理死代码——明明一百行能解决的问题，非得写一千行。
它们还会把自己没看懂的注释和代码顺手改掉，哪怕那根本不是你让它动的地方。
然后，有人把他的观察，浓缩成了一个 CLAUDE.md 文件，
用于显著改善 AI 编码助手（尤其是 Claude Code，也支持 Cursor）的代码生成行为。
截至目前，都要超过超过 100k+ Star 了（今天发完估计就到）：
一份 CLAUDE.md 文件的仓库，能火成这样，也是牛 X。
项目地址：https://github.com/forrestchang/andrej-karpathy-skills
这份 CLAUDE.md 不教你怎么让 AI 写更多代码，而是教 AI 怎么像一个靠谱的高级工程师一样思考和动手。
核心只有四个原则，简单、直接、好执行：
1、Think Before Coding（先思考，再下手）
核心原则**：不要擅自假设，不要藏着困惑，要把权衡摆到台面上。**
-
有歧义？主动列出几种解读，问清楚再动手。
-
发现更简单的方案？大胆 push back，别怕得罪“老板”。
-
不确定？直接说“我这里不太清楚，能再确认一下吗？”
这招直接杜绝了AI 脑补剧情然后跑偏的经典灾难。
2、Simplicity First（简洁优先，绝不画蛇添足）
核心原则**：只写解决当前问题的最小代码，绝不多余。**
-
没要的功能，一行都不加。
-
没要的抽象，一层都不造。
-
200 行能搞定的，绝不写 1000 行。
用过的人反馈：代码第一次就干净很多，返工次数大幅下降。
3、Surgical Changes（手术式精准修改）
核心原则：只碰该碰的地方，绝不顺手优化别人。
这是很多开发者最感激的一条。
-
改登录验证？就只改验证相关的代码，别去动相邻的路由、配置、注释。
-
匹配原有代码风格，哪怕你个人觉得丑。
-
只清理自己这次修改产生的废弃 import，别碰项目里原有的 dead code（可以提，但别删）。
4、Goal-Driven Execution（目标驱动，验证至上）
核心原则**：把任务变成可验证的目标，然后自己循环直到通过。**
不再是模糊地说帮我加个验证，而是：
-
先写出无效输入的测试用例，再让所有测试通过。
-
先写一个能复现 bug 的测试，再修复它。
AI 有了清晰的成功标准，就能自主循环、自我验证，而不需要你每步都盯着。
安装方法
1、最推荐的方式（Claude Code 用户）：
# 添加插件市场
/plugin marketplace add forrestchang/andrej-karpathy-skills
# 安装插件
/plugin install andrej-karpathy-skills@karpathy-skills
以后所有项目都自动生效。
2、CLAUDE.md（按项目）
项目根目录下一条 curl 命令：
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md让 gpt-image2 总结下，如下图：
用户使用后评价：
-
一个 Markdown 文件，就重塑了 Claude Code 的行为模式。
-
为什么一个 CLAUDE.md 文件能有这么多星？ 答案很现实——它击中了真实痛点，虽然有人吐槽有点 cargo cult（盲从），但更多人表示 diff 干净了，代码简洁了，体验提升明显。
-
用了之后，AI 老实了很多，不再自作主张，开发效率肉眼可见地提高了。
内容效果不满意？点此反馈