
2026年的AI编程圈,最疯狂的不是新模型,而是一个只有70行的纯文本文件。 没有代码,没有算法,一根Markdown文件,不到48小时暴增上万Star,连续霸榜GitHub Trending,总Star破10万。它叫CLAUDE.md,来自开源作者Forrest Chang对Karpathy编程观察的提炼,像一纸“行为规范”,专治那些思路偏航、过度封装、随手乱改、闷头瞎写的高血压操作。更直观的甜头是,代码越来越靠谱,Token账单也不那么肉疼了。下面是一份速通指南,从安装到落地,一条条拆开看。

事情要从2026年1月底说起。
当时前特斯拉AI总监、OpenAI创始成员Andrej Karpathy在X(原Twitter)上发了一条长帖,把AI编程Agent的各种毛病逐一列了出来——脑子还没捋清楚就直接开写、用企业级的方案包装一个简单需求、修一个Bug顺手把周围三块代码也重构了。帖子一出,评论区一片“+1”,共鸣来得过于真实。

一位叫Jiayuan Zhang的华人开发者当天就动了手。他把那串吐槽交给Claude,生成了约800行的详细描述,再让Claude自己审核自己,反复迭代后压缩成了一个70行的精炼指令。第二天,这份文件就挂上了GitHub。整个仓库干干净净,就那一个Markdown文件。

上线当天斩获近万Star,4月中旬突破3万,到5月初,总Star已经破了10万。没有框架,没有复杂Agent体系,核心内容15KB。社区直接炸了锅,有人发出感慨:现在的瓶颈不在模型本身,而是模型周围的“脚手架”,这些胶水才是产品真正的灵魂。
打开CLAUDE.md,核心就四条行为准则。每一条都精准切中痛点,像给AI戴上的一道“紧箍”。

很多时候,下达需求“加一个数据导出功能”,AI的反应是闷头开干——默认导出全部字段、默认JSON格式、默认全部用户。这些假设没有一条被确认过。
这条原则提了三个硬性约束:
目的很直白:让AI在动手之前先把问题对齐,而不是在错误的方向上狂奔40分钟之后才发现全白干了。提前澄清,也许只需要30秒。
这是所有人都遇到过的尴尬场景。只是一个简单的小需求,AI却自动生成了登录认证、安全校验、流量控制,附赠了一套“以后也许用得上”的抽象架构。
规则直接锁死了那些过度封装的花招:
检验标准也非常简单:一个资深工程师看了会不会说“太复杂了”?如果会,直接砍。
修一个Bug,回来一看Diff——改了30行,其中25行跟需求毫无关系,变量名换了、注释删了、格式改了。这种“顺手优化”的冲动,直接导致代码审查痛苦翻倍。
第三条原则做了四件事:
每一条改动能追溯到原始需求,AI生成的Diff才不会变成一场清扫行动。
这四条里最具差异化的一条。核心很反直觉:别告诉AI“怎么做”,给它一个可以验证的“终点”。
Karpathy有一个重要判断:大模型特别擅长围绕明确目标反复迭代,直到达成验收标准。它不擅长的是猜人类脑子里那个模糊的画面。

具体做法的差异非常直观:
场景 | 模糊指令 | 目标驱动指令 |
|---|---|---|
修Bug | “修一下这个登录报错” | “先写一个能复现这个报错的测试,然后改代码让所有测试通过” |
加功能 | “加一个数据校验” | “给这几类非法输入分别补测试用例,然后让测试全数通过” |
做需求 | “把用户模块改一下” | “用户模块做这三件事,输出可运行的代码和验证脚本” |
模糊指令需要不停检查和纠偏;目标驱动指令里,AI会自己闭环,直到达标。把成功标准交给它,剩下的交给迭代。
参考:插件安装(Claude Code)
直接在Claude Code会话中输入两条命令:
/plugin marketplace add forrestchang/andrej-karpathy-skills/plugin
install andrej-karpathy-skills@karpathy-skills
插件安装完成后即可使用。

聊这套规则,绕不开一个现实问题:AI烧Token的速度。
调查数据显示,Claude Code使用中相当一部分成本浪费在冗余输出和无效方向上。一个模糊的需求被错误假设后,AI可能已经在上百条报错信息中绕了一大圈,所有中间过程都在消耗Token。
CLAUDE.md的介入方式很直接:通过四条规则,把Token用在刀刃上。思考先行让AI先对齐再动工,干脆扼制了“跑错了方向还产出大量无意义代码”的浪费。简洁优先拒绝大材小用,减少那些不必要的抽象和扩展。精准改动保证Diff中的每一行都有价值,目标驱动让AI有可验证的终点自行闭环,极大降低了人工介入纠偏的频率。每一个环节都在优化终端的每笔账单。
有团队日常Token消耗极大,曾在项目公开说明中披露每天消耗超过1亿Token(该数据未经第三方核实,仅供参考)。接入CLAUDE.md后,通过优化方向精准度,大量冗余调用可以显著压缩。

社区对这个项目的热情远超预期。有人基于原版做了深度定制,把自己踩过的坑全部加了进去;byteiota做了测试,声称接入后Claude Code的准确率飙至94%(注:该数据未经独立核实,具体提升幅度因项目而定)。更关键的信号不是这个数据本身,而是大量工程师愿意在日常工作中引入它——这说明它确实解决了真实且高频的痛点。
项目创始人所在的公司在介绍中有一句话:“Your next 10 hires won't be human.”他们公司的代码几乎完全由AI完成。这份70行的规则,正在成为AI辅助开发中的一块基石。

从Karpathy的一条吐槽帖,到GitHub上10万Star的爆款,CLAUDE.md的核心魅力或许就是它足够简单。不需要学习新工具,不需要安装复杂的依赖,一个文本文件往项目根目录一放,AI的行为方式就发生了变化。把这份文件拖进根目录,跑一下日常任务,看看AI的响应有没有安静很多。如果顺手清掉了一些扣错方向的账单,也算是对那次开源贡献者的隔空致敬。
#CLAUDEmd #编程效率飞升 #Token省到底 #AI协作规范