Karpathy 的 CLAUDE.md 在 GitHub 上斩获 8.2 万颗星,位列榜首。但大多数开发者仍未阅读过它。

@0xDepressionn
英语2个月前 · 2026年5月17日
2.0M
1.3K
146
29
7.3K

TL;DR

学习如何部署 Andrej Karpathy 的 CLAUDE.md 配置,为 Claude Code 提供持久的项目上下文、严格的行为准则以及决策记忆日志。

一个名为 CLAUDE.md 的文件登顶了 GitHub Trending。

82,000 颗星。7,800 个 Fork。

它始于 Andrej Karpathy。前特斯拉 AI 总监。OpenAI 创始成员。他识别出导致 Claude Code 失败的 4 种行为,并将它们写在一个文件中。

一位开发者拿这 4 条规则,扩展后发布了这个文件。它迅速走红。

原因:代码准确率从 65% 提升到了 94%。

大多数日常使用 Claude Code 的开发者从未设置过这个。他们每个会话都从零开始。重复解释同样的上下文。清理不想要的变更范围。回滚没人要求的重构。

以下是完整的文件内容。

Dep - inline image

大多数开发者忽视的设置

每次你打开 Claude Code,它都是一片空白。

它不知道你的技术栈。你的标准。你的项目上下文。你已经尝试过什么。你三个会话前明确决定不做什么。

于是它开始猜测。而一猜,它就会重构你没让它碰的代码。它会推荐破坏你现有架构的框架。它会在不询问的情况下删除文件。它会与你已经做出的决定相矛盾。

CLAUDE.md 是一个纯文本文件,放在项目根目录。Claude Code 会在每个会话开始时自动读取它。

一次设置。零重复解释。修复三类昂贵的错误。

1 / 3 | 默认项:你每周花 375 美元在重复自己

普通开发者每天花 30 分钟向 Claude 重复解释上下文。

技术栈。编码标准。项目背景。已经试过什么。这些都不会在会话之间保持,除非你写下来一次,让 Claude 每次都读取。

每天 30 分钟,按开发者 150 美元/小时计算:每周 375 美元。每个开发者。

对于一个 5 人团队:每周 1,875 美元就这样没了。

Dep - inline image

这 7 条规则放在 CLAUDE.md 文件的顶部。

→ 去掉废话:

→ 根据任务匹配长度:

→ 先展示选项再行动:

→ 在让我付出代价之前承认不确定性:

→ 我是谁,我知道什么:

→ 当前项目上下文:

→ 锁定你的语气:

每天重新解释上下文的时间:30 分钟。按 150 美元/小时的开发者费率计算:75 美元/天。每周:375 美元/每位开发者。5 人团队:1,875 美元/周。此部分的 CLAUDE.md 设置时间:总计 45 分钟。

要避免的错误:不要从头开始写 CLAUDE.md。先用这个提示词,然后编辑输出:

2 / 3 | 行为:你未授权的 150 美元/小时的变更

你让 Claude 修复一个函数。

它重构了三个文件,重命名了你的变量,重新组织了导入,并重写了你精心编写的注释。

全部未经询问。

用一个小时来审查并回滚不必要的变更:150 美元。每周三次:450 美元/周。每个开发者。

对于一个 5 人团队:每周 2,250 美元浪费在清理未经授权的变更上。

Dep - inline image

这 7 条规则放在 CLAUDE.md 的行为部分。

→ 保持在范围内:

→ 重大变更前先询问:

→ 任何破坏性操作前先确认:

→ 生产环境硬性停止:

→ 始终显示更改了什么:

→ 没有明确确认绝不动手:

→ 先思考再写代码:

每周花 1 小时回滚不必要的范围变更:150 美元/周。每次任务后花 30 分钟手动比对差异:75 美元/周。每个开发者与行为相关的浪费总计:225 美元/周。5 人团队:1,125 美元/周。CLAUDE.md 行为部分设置时间:30 分钟。

3 / 3 | 记忆 + 技术栈:让 Claude Code 真正可靠的设置

Claude 会忘记会话之间的一切。

你做出的每一个决定。每一个失败的方法。六个月前你选择 Prisma 而不是 Drizzle 的原因。因为某个特定客户需求而存在的约束。

它全忘了。然后它会建议你已经排除的选项。

这部分给了 Claude 目前最接近真正记忆的东西。并锁定你的技术栈,让它停止提出会破坏现有架构的工具。

Dep - inline image

→ MEMORY.md 决策日志:

→ 会话结束摘要:

→ ERRORS.md 失败日志:

→ 永久事实列表:

→ 锁定你的技术栈:

→ 重大决策的扩展思考:

→ 那 4 条走红的规则:

Karpathy 识别出导致 Claude Code 失败的 4 种行为。一位开发者将它们凝练成这 4 行。代码准确率从 65% 提升到了 94%。

每周花 2 小时从遗忘的决策和错误建议中恢复:每个开发 300 美元/周。错误的技术栈推荐和不兼容工具:75 美元/周。每个开发者与记忆相关的浪费总计:375 美元/周。5 人团队:1,875 美元/周。MEMORY.md + ERRORS.md + 技术栈设置:20 分钟。

结论

以下是完整的计算。

每个会话重新解释上下文:375 美元/周<br>回滚未授权变更:225 美元/周<br>从遗忘的决策中恢复:375 美元/周<br>每个开发者浪费总额:975 美元/周

5 人开发团队:4,875 美元/周<br>每年:253,500 美元

CLAUDE.md 设置时间:总计 2 小时<br>仅 Karpathy 的 4 条规则:代码准确率从 65% 提升到 94%

一个纯文本文件。21 条规则。两小时的工作。

设置了这些的开发者,正在使用的 Claude 能记住决策、保持在范围内、在破坏任何东西之前确认、从不推荐破坏你架构的框架。

那些还没设置的,每周花 975 美元在重复自己。

附言:从 Karpathy 的 4 条规则开始。就那 4 条。现在就把它们粘贴到项目根目录一个名为 CLAUDE.md 的新文件中。只需 2 分钟。然后每周根据你发现缺失的部分,逐步添加其余的规则。

在它被淹没之前收藏这篇。如果对你有用,分享给一个需要它的人。

一键保存

使用 YouMind AI 深度阅读爆款文章

保存原文、追问细节、总结观点,并在一个 AI 工作空间里把爆款文章沉淀成可复用笔记。

了解 YouMind
写给创作者

把你的 Markdown 变成干净的 𝕏 文章

图片上传、表格、代码块,往 𝕏 上手动重排太痛苦。YouMind 把整篇 Markdown 一键转成干净、可直接发布的 𝕏 文章草稿。

试试 Markdown 转 𝕏

更多可拆解样本

近期爆款文章

探索更多爆款文章