夜雨聆风
CLAUDE和Openclaw的最强配置文件!
GitHub 上周排名第一的项目，不是框架，不是 SDK，不是新模型。
是一个 Markdown 文件——里面写了四条规矩，用来管住 AI 写代码时最常犯的毛病。
这周 GitHub Trending 日榜的第一名，很多人点开之后都有点懵。
不是新的大模型。不是一个工具框架。不是一套完整的 SDK。
就是一个 CLAUDE.md 文件。里面 65 行 Markdown，写了四条规矩。本周单周新增 44,465 颗星，总数破 6 万，连续三天占据日榜第一。
一个毫无代码的文本文件，为什么能让 6 万程序员连夜抄作业？
这个文件是谁写的
华人开发者 Jiayuan Zhang，Multica 公司创始人，这是他创建的项目。
但更重要的不是他——是这个文件的内容来自哪里。
你接下来招的 10 名员工，都不会是人类了。
这个文件的内容，蒸馏自 Andrej Karpathy 对 LLM 编程行为的观察。
Karpathy 是谁？前特斯拉 AI 总监、OpenAI 创始成员、nanoGPT 作者——在工程师圈子里，他是那种说话算数的人。
2026 年 3 月，Karpathy 公开表示，自 2025 年 12 月起，他几乎没再自己写过一行代码。工作流从「80% 手写 + 20% AI 辅助」彻底翻转成「80% 交给 Agent + 20% 自己修补」。他把自己现在的状态称为 “AI 精神病”——
他也说了更扎心的话：已经能感觉到手写代码的能力在萎缩，「可以看懂代码，但写不出来了。」
这个背景很重要。因为 CLAUDE.md 的四条原则，正是 Karpathy 在这个过程里踩坑总结出来的——不是理论，是他每天用 AI 写代码碰到最多的那些毛病。
四条规矩，解决四个老毛病
AI 写代码有四个典型的系统性缺陷，和模型能力无关，换哪个模型都有：
CLAUDE.md 就是四把刀，一把对一个。
-
不确定时必须停下来问，不能猜测执行
-
存在多种理解时，列出所有选项让用户选，不替用户做决定
-
发现有更简单的方案时，主动说出来，该推回就推回
-
困惑时停下来，指出不清楚的地方要求澄清
「加个邮箱验证」→ AI 直接写了：正则校验 + 黑名单过滤 + 实时 DNS 查询 + 限频保护 + 错误日志，你只需要 1 行，它给了 80 行
「加个邮箱验证」→ AI 先问：「只验证格式，还是要发验证码确认真实邮箱？」→ 你说格式即可 → 1 行正则搞定
一位开发者算过账：「模型选错了分支，运行了 40 分钟，最后碰壁失败。而提前澄清只需要 30 秒。」
-
没被要求的功能不写
-
只用一次的代码不建抽象层
-
没人要求的「灵活性」和「可配置性」不加
-
不可能发生的异常场景不做错误处理
-
200 行能写成 50 行的，就重写
检验标准只有一条：资深工程师看了会不会说「太复杂了」——会就直接砍。
-
只动被要求动的部分，不重构「路过」的代码
-
匹配项目已有的代码风格，即使你自己更喜欢别的写法
-
看到不相关的问题，提一嘴就行，别动手
-
如果改动导致某些代码不再被调用，清理掉——但之前就存在的问题不碰
-
每一行改动都应该能直接追溯到用户的请求
-
不要说「修复这个 bug」，而是「写一个能复现这个 bug 的测试，然后让测试通过」
-
不要说「实现这个功能」，而是「完成后 X、Y、Z 应该成立」
-
复杂任务先让 AI 列分步计划，每步带验证方式
「修这个 bug，改第42行的判断逻辑，然后加一个 null 检查」
「bugX 的复现测试要通过，其他已有测试不能跑挂」
验收标准越清晰，AI 可以独立执行的时间越长，你需要介入的频率越低。这条是四个原则里技术含量最高的——本质上是把「命令式」改成「声明式」。
为什么一个 Markdown 文件能登顶 GitHub
社区里有一条高赞评论，直接说到了点上：
说白了，这个文件做的事情是：把顶级工程师的隐性经验，打包成 AI 可以直接读取的行为规范。
你不需要每次提示 AI 「先思考再动手」「别过度设计」——这些规矩写在 CLAUDE.md 里，AI 自动遵守。Claude Code、Cursor、OpenClaw，只要工具会读取这个文件，就能继承这套规范。
一个社区成员说得很准：「Karpathy 不再只是你读的人，而是一个你的 Agent 可以直接继承行为的人。」
怎么用：Claude Code 和 OpenClaw 都支持
装法有三种，按需选：
# Claude Code 一键安装/plugin marketplace add forrestchang/andrej-karpathy-skills/plugin install andrej-karpathy-skills@karpathy-skills
# 把 CLAUDE.md 内容复制到项目根目录cp /tmp/karpathy-skills/CLAUDE.md ./CLAUDE.md# OpenClaw 同样支持项目级 CLAUDE.md# 放在项目根目录后，会话启动自动读取
# 追加到全局配置文件cat /tmp/karpathy-skills/CLAUDE.md >> ~/.claude/CLAUDE.md# OpenClaw 全局配置路径cat /tmp/karpathy-skills/CLAUDE.md >> ~/.agents/CLAUDE.md
OpenClaw 完全兼容 CLAUDE.md 项目规范。在 OpenClaw 的 Council 多智能体模式下，CLAUDE.md 的规则会同步应用给所有并行的 Agent（Architect、Developer、QA），让整个团队统一行为标准——而不只是约束某一个 Agent。此外，ClawHub 市场也有收录 andrej-karpathy-skills，可直接搜索安装。
还有个额外彩蛋：这个仓库内置了 Cursor 适配文件，Cursor 用户也能用：
cp /tmp/karpathy-skills/.cursor/rules/karpathy-guidelines.mdc .cursor/rules/
Karpathy 还说了两件让人不安的事
Karpathy 坦言，自从工作流转向 Agent 主导，他已经感觉到手写代码的能力在萎缩——「可以看懂代码，但写不出来了。」
他的工作流翻转发生在 2025 年 12 月，Claude 和 Codex 在那个时间点跨过了某种「连贯性门槛」，让 Agent 主导的工作方式突然变得可行。他说：「很难再回到完全手写的状态。」
他预言 2026 年 GitHub、arXiv、社交媒体会涌出大量 AI 生成的低质量内容——他称之为「Slopacolypse」（低质内容大爆炸）。
当所有人都在用 AI 生成内容，区分「有真正洞察」和「AI 填充了几千字」的能力，会变成一种稀缺技能。
CLAUDE.md 存在的意义，某种程度上也是对抗 Slopacolypse 的工具——它不是让 AI 写更多，而是让 AI 写得更克制、更精准。
这个文件凭什么
能登顶的项目背后通常有一个共同的东西：它说出了所有人都遇到过、但没有人系统整理过的东西。
CLAUDE.md 就是这个。
四条规矩，每一条你都经历过。AI 不问直接猜、写出过度复杂的代码、顺手动了你不想动的地方、不知道算不算完成——这是每一个用 AI 写代码的人的日常。
这个文件把这四个痛点明确写出来，翻译成 AI 可以直接执行的规范，放进项目配置文件里。65 行，不需要任何代码，不需要任何依赖，工具读到就能遵守。
然后 6 万人转发了它。