一个 CLAUDE.md 搞定 Claude Code 乱改代码:andrej-karpathy-skills 快速上手指南
【免费下载链接】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 行为文件,就能让 AI 停止自作主张、少写过度设计的代码,diff 里不再混进无关改动。规则提炼自 Andrej Karpathy 对大模型写代码坑点的总结,装一次,所有项目受益。
😰 你也被 AI 改代码坑过吗
如果你用 AI 写过代码,下面这些场面应该不陌生:你说"修一下这个 bug",它顺手把旁边的注释全改了,还加了没人要的校验;你说"加个折扣计算",它给你整出一套抽象基类加策略模式,三十多行;你说"导出用户数据",它默认导出全部用户、默认写到固定路径,写完才发现字段都不对。问题不在模型不够聪明,而在它不会主动暴露猜测,也不会说"我不确定"。这个项目要解决的,就是把"先问清楚、只改必要的、能自证才算完"变成 AI 的默认习惯。
🛠 改前改后:三个场景看它怎么管住 AI
直接上对比,挑三个最常翻车的场景,看装上之后各变成什么样。
场景一:需求模糊时,先问再动手。以前 AI 拿到"导出用户数据"这种话,会自己补全所有空白直接开写。现在它会先停下来,把范围、格式、字段、数据量四个问题摆出来问清楚,甚至主动提醒"最简单的做法可能是分页接口",而不是闷头实现。
场景二:简单的事不绕远路。还是"计算折扣"的例子:改前是抽象类、策略接口、配置对象一整套,为一次简单计算铺了三十行脚手架;改后就一个函数,传入金额和百分比,返回折扣额。等真出现多种折扣类型,再扩展不迟。🔧
场景三:只动该动的行。修"空邮箱导致崩溃"这种 bug 时,改前它会连注释一起重写、补上没被要求的用户名校验、顺手统一引号风格;改后 diff 里只有和 bug 直接相关的两行。注意到的无关死代码,它会提一句,但不会擅自删。
它还会要求把"修 bug"翻译成"先写一个能复现的测试,再让它通过"这类可验证目标——标准越具体,AI 越能自己循环推进,不用你盯着。
⚡ 两步完成 Claude Code 插件安装
推荐走插件路线:在 Claude Code 里敲两条命令,先加市场再装插件,之后所有项目全局生效。
/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills只想给单个项目用?把 CLAUDE.md 拉到项目根目录即可,一条命令:
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md已有 CLAUDE.md 的项目在末尾追加同一份内容就行,别覆盖已有指令。用 Cursor 的同学可以把仓库里的.cursor/rules/karpathy-guidelines.mdc拷到目标项目的.cursor/rules/目录,接入细节见 CURSOR.md 说明。
📝 怎么给项目加自定义规则
这套规则设计之初就是来和项目指令合并的,别另起文件打架,在项目 CLAUDE.md 末尾加一节即可:
## Project-Specific Guidelines - Use TypeScript strict mode - All API endpoints must have tests - Follow the existing error handling patterns in src/utils/errors.ts通用底线和你的项目约束(严格模式、测试要求、错误处理位置)分开写,AI 既守得住规范,又知道你这个项目的规矩。完整四条原则在仓库根目录的 CLAUDE.md,可复用的技能版在 skills/karpathy-guidelines/SKILL.md,想调整哪条直接编辑对应文件。
✅ 怎么判断它真的起作用了
装完不用猜,看 diff 和对话记录就够了:
| 你看到 | 背后含义 |
|---|---|
| diff 里只剩请求的改动,没有顺手重构 | 精准修改在生效 |
| AI 动手前先列假设、先提问 | 不再默默脑补需求 |
| 先写测试复现 bug,修完自证 | 目标驱动,结果可验证 |
小提醒:这套规则偏向谨慎,改错别字这类一行就能解决的小事,不用走全套流程。
一句话总结:andrej-karpathy-skills 用一份 CLAUDE.md 把"先问清、写简单、只动必要、可自证"变成 Claude Code 的默认行为,值得每个用 AI 写代码的人装上。🎯 想动手试试:git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills
【免费下载链接】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),仅供参考