
82100 颗星。
GitHub Trending 第一名。
零依赖,零代码,就一个文件——CLAUDE.md。
一个纯文本文件比99%的开源项目都火,这合理吗?
太合理了。因为它解决的是当前AI 编程最痛的问题:AI 写代码太自信,错得太安静。
AI编程的“自信 junior”问题
用过 AI 编程工具的人大概都遇到过这种情况:
你让 AI 帮你写一个函数。它写出来了,看起来很对,语法没问题,逻辑似乎也通。你提交了,测试过了。三天后发现——它假设了一个不存在的 API 参数,整个模块的返回值类型都是错的。
AI 不会告诉你“我不确定这个参数是否存在”。它会非常自信地写出来,注释完整,格式漂亮。就像一个刚毕业的 junior developer——代码写得好看,但你不知道哪里藏着一个致命假设。

Andrej Karpathy(OpenAI 联合创始人、前 Tesla AI 总监、“Vibe Coding”概念的提出者)观察到了这个问题,总结了 4 条原则。
开发者 Forrest Chang 把这 4 条原则放进了一个 CLAUDE.md 文件,开源了。
然后就炸了。
最有价值的代码不是写出来的,是“不写”出来的——告诉AI什么不该做,比告诉它做什么更重要。
4条原则到底说了什么?
原则的核心可以概括为四个字:先想后写。

原则一:Think before coding. 不要让AI拿到需求就开始写代码。要求它先分析需求、列出假设、确认不确定的点。就像你不会让一个新员工接到任务就直接开工——你得先让他讲讲理解对不对。
原则二:Never assume. AI 最大的毛病就是“静默假设”——它不会告诉你它做了一个假设,它直接把假设当成事实写进代码里。CLAUDE.md 要求AI在不确定时必须停下来问,而不是自己编一个合理的答案。
原则三:Minimal changes. 你让它修一个bug,它顺便重构了半个文件。你让它加一个功能,它改了三个不相关的模块。CLAUDE.md 约束AI只做被要求的事,不要过度发挥。
原则四:Verify before claiming done. AI 说“搞定了”,不代表真的搞定了。要求它在声称完成之前,实际运行测试、检查输出、验证边界条件。
这4条原则不是技术规范,是行为规范。它们改变的不是AI能写什么代码,而是AI写代码的方式。
为什么一个文件就够了?
你可能会想:这些原则写在系统提示词里不行吗?
行,但效果差很多。原因在于文件位置和加载机制。
CLAUDE.md 是 Claude Code 的特殊文件——放在项目根目录,每次 Claude Code 启动时自动加载。它不是一次性提示词,是持续生效的行为约束。
就像一个公司的员工手册——不是入职培训时听一次就扔了,而是每天上班都会看到、会遵守的东西。
82K 颗星说明一个事实:开发者社区对AI编程的信任危机已经很严重了。 人们不是不需要AI帮忙,而是不敢完全信任AI的输出。CLAUDE.md 提供了一个低成本的解决方案——丢一个文件进去,AI 就靠谱多了。
这就是为什么它火了——因为它真的有用,而且简单到不可思议。
怎么用?
直接抄作业:
# CLAUDE.md
## Core Rules
1. **Think before coding.** Before writing any code:
- Restate the requirement in your own words
- List your assumptions
- Flag any uncertainties and ask
2. **Never assume.** If you're not sure about:
- An API parameter → check the docs, don't guess
- A library version → verify, don't assume latest
- A data format → ask for an example
3. **Minimal changes.** Only modify what's asked:
- Don't refactor unless requested
- Don't "improve" unrelated code
- Don't add features not in the spec
4. **Verify before done.** Before saying "done":
- Run the relevant tests
- Check edge cases
- Confirm the output matches expectations
把这个文件放到你的项目根目录。如果你用的是 Claude Code,它会自动加载。如果你用 Cursor 或其他工具,可以在项目设置里指定加载这个文件。
最好的工具往往是最简单的。一个文件,4条规则,82K开发者用它让AI少犯了80%的错。你还在等什么?
项目地址: https://github.com/forrestchang/andrej-karpathy-skills