结论先说
- 它不是 Karpathy 本人写的文件。 仓库 README 写的是:一份 CLAUDE.md,用来改善 Claude Code 的行为,「derived from」Andrej Karpathy 对大模型写代码毛病的观察(出自他在 X 上的一条帖子)。作者是 GitHub 用户 forrestchang。
- 内容很短,只有四条原则:先想后写、简单优先、外科手术式修改、目标驱动。
- 用法有三种:存成项目根目录的
CLAUDE.md;追加到已有的 CLAUDE.md;或者按 README 的/plugin命令装成插件。 - 它偏向谨慎而不是速度。文件开头自己写明:这些准则倾向于「谨慎优先于速度」,琐碎任务请自行判断。
- 用之前先读一遍:它会成为你每个会话的指令。官方也提醒,CLAUDE.md 是上下文而不是强制配置,是否被遵守没有保证。

图:本站根据 forrestchang/andrej-karpathy-skills 仓库 整理的示意图
本文根据 GitHub 仓库 forrestchang/andrej-karpathy-skills 的 README 和 CLAUDE.md、Claude Code 官方文档《How Claude remembers your project》整理,资料核对于 2026-11-13。配图为本站整理的示意图,不是界面截图。该仓库是社区项目,不是 Anthropic 或 Karpathy 的官方发布;本站(bigolab.com)也不是 Anthropic 官方网站。
适用于谁
- 搜「karpathy claude.md 如何使用」,想知道这是什么、怎么用的人;
- 用 Claude Code 写代码,觉得它爱过度设计、爱顺手乱改的人;
- 想找一份简短的通用指令来补充自己 CLAUDE.md 的人。
一、它从哪来
README 开头说明:这是一份单独的 CLAUDE.md,灵感来自 Andrej Karpathy 对 LLM 写代码时常见问题的观察,并引用了他的原帖作为出处。README 摘录的原话大意是三类毛病:
- 模型替你做了错误的假设,也不检查就一路执行,不管理自己的困惑、不求证、不指出不一致、不摆出权衡、该反驳时不反驳;
- 爱把代码和接口搞复杂,抽象膨胀,不清理死代码,100 行能解决的写成 1000 行;
- 有时会把自己没完全理解的注释和代码当作副作用改掉或删掉,哪怕和任务无关。
仓库的做法,是把这些观察翻成四条写给 Claude 的指令。注意:这是社区作者的二次整理,不是 Karpathy 的项目,也不是 Anthropic 的官方内容。
二、四条原则讲什么
下面是对原文的中文概括,具体措辞请看仓库里的英文原文。
1. 先想后写(Think Before Coding)。 不要假设,不要藏起困惑,把权衡摆出来。动手前要说明自己的假设,不确定就问;如果有多种理解,列出来,不要悄悄选一种;有更简单的做法就说出来,该反驳时反驳;不清楚就停下,指出哪里不清楚并询问。
2. 简单优先(Simplicity First)。 用最少的代码解决问题,不做没被要求的推测:不加没要求的功能,不为只用一次的代码做抽象,不加没被要求的「灵活性」和「可配置性」,不为不可能的场景写错误处理;写了 200 行本可以 50 行,就重写。自问:资深工程师会不会觉得这太复杂?
3. 外科手术式修改(Surgical Changes)。 只动必须动的,只清理自己造成的混乱。不「顺手改进」相邻的代码、注释、格式,不重构没坏的东西,沿用现有风格,哪怕你会用别的写法;发现无关的死代码,指出来而不是删;自己的改动造成的孤儿(没用了的导入、变量、函数)要清理。检验标准是:每一行改动都能直接追溯到用户的要求。
4. 目标驱动执行(Goal-Driven Execution)。 先定义成功标准,再循环到验证通过。把任务变成可验证的目标:「加校验」变成「为非法输入写测试,再让它们通过」;「修 bug」变成「先写一个能复现的测试,再让它通过」;「重构」变成「确保前后测试都通过」。多步任务先说一个简短计划,每步带验证方法。强的成功标准能让 Claude 自己循环,弱的(「让它能跑」)则需要不停澄清。
文件末尾还写了「怎么算起作用」:diff 里不必要的改动变少,因过度复杂而重写的次数变少,澄清问题出现在动手之前而不是犯错之后。
三、三种用法

图:本站根据该仓库 README 和 Claude Code 官方文档 整理的示意图
用法一:放进单个项目。 README 的做法是把文件下载为项目根目录的 CLAUDE.md;已有 CLAUDE.md 的项目,则把它追加到末尾。你也可以直接打开仓库页面,复制内容到自己的文件里。项目级 CLAUDE.md 的位置和写法,官方说明见 /guides/claude-md-agents-md。
用法二:做成全局偏好。 这四条原则不是某个项目特有的,放进 ~/.claude/CLAUDE.md 就对你所有项目生效,具体见 /guides/claude-code-global-claude-md-user-level。这是本文的推断用法,README 没有这样写,但官方对用户级文件的定位正好适合通用的个人偏好。
用法三:装成插件。 README 推荐的方式是先在 Claude Code 里添加插件市场,再安装插件,命令以仓库 README 为准。这样技能会在你所有项目里可用。插件的装法和风险,可以参考 /guides/claude-code-install-superpowers-plugin。
不管哪种方式,装完后用 /memory 确认文件被载入,并新开一个会话再试。
四、使用前后的注意事项
先读,再用。 它会作为指令进入你每个会话的上下文。照搬别人的文件之前,要确认每一条你都认同。比如「发现无关的死代码只指出、不删除」适合保守的团队,不一定适合你正在做的大重构。
别和自己的文件冲突。 官方说,两条互相矛盾的指令,Claude 可能随便选一个。如果你的项目 CLAUDE.md 里写了「顺手把周边代码也规范化」,就和第三条冲突,要改掉一边。
控制篇幅。 官方建议每个 CLAUDE.md 尽量不超过 200 行。这份文件本身很短,但你把它和自己的规则合并时要注意总长度。
第三方内容要自己把关。 仓库和插件都是第三方的,作者以后可能改动内容。装插件前看一眼代码和权限,通用的安全习惯见 /guides/ai-coding-security-secrets-permissions。
它有代价。 文件开头自己写明偏向谨慎而不是速度:更多的澄清提问,更多的验证步骤。对于改个错别字这样的小任务,这些步骤可能显得多余。
五、怎么判断有没有用
仓库给的标准可以直接拿来用:
- 同一类任务,用前后各跑一次;
- 看 diff 里有没有不属于你要求的改动;
- 看 Claude 是先问再做,还是做错了再改;
- 看有没有因为过度设计而重写。
没有官方数据说明这类文件一定更有效,所以以你自己的项目为准。觉得没用就删,不会有任何副作用。
六、需要多跑几轮时的额度
这份准则会让 Claude 更多地先提问、先写测试再改代码,一个任务的轮数可能增加。如果你用订阅登录 Claude Code,担心额度不够,可以看 /chongzhi/claude-code,规则以官方页面为准。
常见问题
Q:这是 Karpathy 官方发布的吗?
不是。仓库作者是 forrestchang,README 说明内容是根据 Karpathy 的观察整理的。
Q:要不要每个项目都放一份?
可以放全局,也可以只放需要的项目。官方的用户级文件对所有项目生效。
Q:它适用于 Codex 或 Cursor 吗?
README 提到仓库里有给 Cursor 的规则文件。Codex 有自己的 AGENTS.md,思路相近,本文不展开。
相关教程
- /guides/claude-md-chinese-or-english:CLAUDE.md 用中文还是英文
- /guides/claude-code-takeover-old-project-claude-md:接手老项目
参考资料
- GitHub:forrestchang/andrej-karpathy-skills — https://github.com/forrestchang/andrej-karpathy-skills
- Andrej Karpathy 的原帖(仓库引用)— https://x.com/karpathy/status/2015883857489522876
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 条评论
还没有评论,来抢沙发~