如何快速上手 andrej-karpathy-skills:纠正 Claude Code 编码坏习惯的 5 分钟教程
2026/8/28 13:17:29 网站建设 项目流程

如何快速上手 andrej-karpathy-skills:纠正 Claude Code 编码坏习惯的 5 分钟教程

【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills

andrej-karpathy-skills 是一份面向 Claude Code 用户的 CLAUDE.md 行为规则文件,把 LLM 写代码时最恼人的四个毛病——瞎猜需求、代码注水、乱改无关代码、缺少验证标准——变成一组即装即用的规则。适合所有用 AI 写代码的新手。读完这篇,你能在 5 分钟内把它装进自己的项目,并立刻从代码 diff 里看到变化。

为什么需要它:AI 写代码最常踩的四个坑

如果你用过 Claude Code 或同类 AI 编程工具,大概率碰过下面这些情况:

  • 你说"加个导出用户的功能",它直接把所有用户的敏感字段全导出。AI 替你做了错误假设还一路执行,发现时推倒重来。
  • 要一个算折扣的函数,回来一个上百行的策略类加抽象基类。一行代码就能解决的事,留下一堆没要的抽象结构。
  • 看 diff 发现它顺手改了你没让动的注释和相邻代码的格式。无关改动混在提交里,审代码比自己写还慢。
  • 你说"修掉这个 bug",它说"已修复",却没有任何验证步骤。到底修没修好,还得你自己测。

四个坑有个共同点:AI 不知道自己不知道什么,而且不会主动说。

怎么快速用起来:三种装法

装法一:Claude Code 插件(最省事)

在 Claude Code 会话里执行两条命令:

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

装完对你名下所有项目生效,不用每个项目单独配置。

装法二:单个项目放一个 CLAUDE.md

不想装插件就克隆仓库,把 CLAUDE.md 复制到目标项目根目录;项目里已有 CLAUDE.md 的,把内容追加到文件末尾即可。

git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills

装法三:Cursor 用户

仓库自带规则文件 .cursor/rules/karpathy-guidelines.mdc,把它复制到自己项目的 .cursor/rules/ 目录下就生效。详细步骤和原理看 CURSOR.md 即可。

前置条件一句话带过:有 git 或 Claude Code 客户端就行,没有任何依赖要装。

它是怎么起作用的:四条规则前后对比

整个项目的核心就是一个 CLAUDE.md,把四条原则写进 AI 的行为里,效果对比如下:

你的请求改造前改造后
"加个折扣函数"返回上百行策略模式加抽象基类一个三行函数
"导出用户数据"直接全量导出敏感字段先问清范围、格式、字段、数据量四个问题
"修这个 bug"口头说已修复,没有验证先写重现 bug 的测试,再让测试通过

每条规则在做什么:

  1. 编码前先想:动手前必须把假设说出来,拿不准就问;有多种理解时列出来让你选,而不是默默挑一个跑。带来的好处:方向错了在动手前就被拦住,而不是重写之后。
  2. 简洁优先:只写解决问题的最少代码,不预支抽象、不加没人要的配置项,200 行能写成 50 行就重写。带来的好处:资深工程师看了不会说这代码过度设计。
  3. 外科手术式修改:只改必须改的行,匹配现有代码风格;只清理自己改动产生的无用导入和变量,不动本来就有的死代码。带来的好处:diff 里每一行都能对应回你的请求。
  4. 目标驱动执行:把命令式指令翻译成可验证的成功标准,比如"加校验"变成"为非法输入写测试,然后让测试通过",循环直到验证通过。带来的好处:有明确目标时 AI 能自己闭环,你不用盯着每一步。

另外说一句权衡:这套规则偏向"求稳不求快",改个错别字这种小事它会自己用简单方式处理,不会事事走完整流程。

你会看到哪些变化:五条自检信号

装完规则不用看任何指标,盯 diff 就行:

  • 澄清问题出现在动手写代码之前,而不是搞砸之后
  • diff 里不再出现顺手改的注释和格式
  • 第一版代码就是简单的,不用你说"简化一下"
  • PR 里只有你请求的改动,没有夹带的重构
  • 修 bug 变成先有重现测试再改,而不是"应该是修好了"

上面五条你能观察到三条以上,说明规则真的在工作。

小结与进一步阅读

andrej-karpathy-skills 的本质是用一个文件给 LLM 的编码习惯立规矩:少猜、少写、少动、多验证。它最适合你每天用 Claude Code 或 Cursor 做真实项目开发和维护的场景。建议先用一个小任务试一天,观察 diff 的变化,再决定要不要铺开到整个项目。

  • 规则本体:仓库根目录的 CLAUDE.md,你实际安装的就是这一个文件
  • 正反案例:EXAMPLES.md 里有大量改造前后的代码对照
  • Cursor 配置说明:CURSOR.md
  • 可复用技能版:skills/karpathy-guidelines/SKILL.md

【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询