Andrej Karpathy 的 Claude Code 指南：把 LLM 编程的坏毛病一次改掉

andrej-karpathy-skills 在 GitHub 上已经拿到 173,247 Star 了。

这个项目只做一件事：把 Andrej Karpathy 对 LLM 编程问题的观察，整理成一份可以直接塞进 Claude Code 的 CLAUDE.md 指南。核心就四条原则，专治模型乱猜、过度设计、顺手改无关代码、目标模糊这些毛病。

1、 这玩意儿是干嘛的

用过 AI 编程工具的人大概率遇到过这种情况：模型自顾自地理解需求，闷头写出一堆代码，结果方向偏了；或者明明 100 行能搞定的事，它非要搭一个 1000 行的抽象大厦；又或者顺手把你没让改的注释、代码全改了，你还得以逐行 review 的方式把这些改动挑出来。

Andrej Karpathy 在一条帖子里把这些问题点得很透。这个项目就是把这些观察落地成四条可执行原则，写进一个文件，让 Claude Code 每次动笔前先过一遍。

2、 四条原则分别治什么

第一条，Think Before Coding。让模型在写代码之前先把假设说出来，遇到歧义给出多种理解，该反问的时候反问，而不是 silently 挑一个解释就开始写。

第二条，Simplicity First。只写解决问题所需的最小代码，不为单一场景造抽象，不加没请求的灵活性，不为不可能发生的场景写错误处理。如果一个工程师看了觉得过设计，那就砍掉。

第三条，Surgical Changes。只动该动的代码，不改相邻的格式、注释和未损坏的逻辑。自己改动造成的无用 import、变量、函数要清理，但原先就存在的死代码只提不改。

第四条，Goal-Driven Execution。把「加校验」「修 bug」「重构 X」这种指令，转成可验证的目标，比如先写测试让失败，再改代码让通过。多步骤任务要列出每一步和对应的验证方式。

3、 怎么用

最简单的用法是把 CLAUDE.md 下载到项目根目录。如果是 Claude Code，也可以装成插件：

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

想用纯文件模式的话，直接 curl 下载 CLAUDE.md 就行。项目里还带了 .cursor/rules/karpathy-guidelines.mdc，所以在 Cursor 里也能用同一套规则。

4、 适合哪些人

• 用 Claude Code、Cursor 这类 AI 编程工具，发现模型经常过度设计或乱改代码的人
• 团队里想把 AI 编码规范统一起来，减少 review 时无谓拉扯的开发者
• 做开源项目维护者，希望贡献者提交的 PR 更干净、改动范围更集中

这套指南的倾向是谨慎优先于速度。小改动可以灵活处理，但复杂任务按这四条来，能省掉不少返工。

套指南的倾向是谨慎优先于速度。小改动可以灵活处理，但复杂任务按这四条来，能省掉不少返工。