andrej-karpathy-skills:一份CLAUDE.md,让Claude Code像Karpathy一样思考

你是否曾经被 AI 编程助手的行为气得直跺脚?它会不假思索地按错误的假设写代码,把简单功能过度抽象成上千行的“宏伟架构”,还会顺手删除你精心书写的注释——这些都是 Andrej Karpathy 反复指出的 LLM 编码陷阱。andrej-karpathy-skills 正是为解决这些问题而生的一个轻量级项目:它将 Karpathy 的深刻观察提炼成一份精炼的 CLAUDE.md 文件,通过四条清晰可执行的原则,从源头约束和引导 Claude Code 的编码行为。无论你是 AI 编程的早期探索者,还是希望让团队 AI 写代码更可控的负责人,这个项目都能成为你的绝佳起点。

截至收录:
andrej-karpathy-skills stars数:203184
andrej-karpathy-skills forks数:20841

andrej-karpathy-skills项目目录截图

andrej-karpathy-skills核心亮点

🧠 直击 LLM 编程痛点:Karpathy 曾指出,模型会擅自做出错误假设、不澄清困惑、不展示权衡,还会把简单代码复杂化,甚至破坏与任务无关的代码。这份文件正是为这些问题量身定制的“药方”,帮助你无需与 AI 反复拉扯,就能获得更高质量的代码。

📜 四大原则,清晰可执行:Think Before Coding(先思考再编码)要求显式陈述假设、呈现多种解释、在困惑时主动提问;Simplicity First(简洁优先)强制删减投机性抽象,如果 200 行能写成 50 行,就绝不保留冗余;Surgical Changes(外科手术式修改)确保每一行改动都能追溯到原始需求,不碰无关代码;Goal-Driven Execution(目标驱动执行)把“做某事”的命令转化为“用测试验证成功”的目标,让 AI 可自主循环。

🔧 安装灵活,随手可用:推荐在 Claude Code 中通过插件市场一条命令完成全局安装;你还可以直接将 CLAUDE.md 下载到项目根目录,甚至通过 echo >> 追加到现有配置,完全尊重你已有的项目规则,不强迫改变工作流。

🤝 开放可定制,生态融合:项目基于 MIT 协议开源,允许自由修改和商用。除了 Claude Code,它还内置了 Cursor 规则文件,让同样的行为准则在 Cursor 中无缝生效;你也可以在 CLAUDE.md 之后追加项目专属规则,实现个性化定制。

andrej-karpathy-skills快速开始

在开始之前,请确认你已经在本地安装并配置好了 Claude Code 或 Cursor。

  1. 安装(方式一:Claude Code 插件,推荐)
    在 Claude Code 中执行以下两条命令,即可将全部准则作为插件全局安装,所有项目都能直接受益:
    bash
    /plugin marketplace add multica-ai/andrej-karpathy-skills
    /plugin install andrej-karpathy-skills@karpathy-skills
  2. 安装(方式二:手动添加 CLAUDE.md)
    对于新项目,直接下载文件到项目根目录:
    bash
    curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md

    如果项目已有 CLAUDE.md,可以追加到文件末尾:
    bash
    echo "" >> CLAUDE.md
    curl https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
  3. 在 Cursor 中使用
    克隆该仓库,或复制 .cursor/rules/karpathy-guidelines.mdc 到你的项目 .cursor/rules/ 目录下。这样在 Cursor 中打开项目时,AI 会自动应用同样的规则。
  4. 验证是否生效
    尝试让 Claude Code 执行一个重构任务,观察它是否先提出澄清问题、控制改动范围、并在提交前给出验证计划。如果 diff 非常干净、没有任何无关改动,说明准则已经在起作用了。

andrej-karpathy-skills应用场景

场景一:Claude Code 日常开发
开发者可以在写代码前先让 Claude 阅读这份 CLAUDE.md,它会在生成代码时主动检查自己的假设,避免过度设计。比如当你只要求“加一个表单校验”时,它会写出最精简的校验逻辑,而不是动用装饰器和复杂的验证库——这正是 Karpathy 反复强调的 Simplicity First。

场景二:团队统一 AI 编程规范
CLAUDE.md 纳入项目仓库,所有使用 Claude Code 的团队成员都会受到相同的行为约束。这能显著减少代码评审中关于“为什么 AI 改了这里”的争论,提升代码审查效率与交付质量。

场景三:多工具集成(Cursor 等)
通过内置的 Cursor 规则文件,项目能在 Cursor 中同样生效。对于混合使用 Claude Code 和 Cursor 的团队,一套规则即可覆盖两种工具。此外,你还可以将四条原则改编后嵌入自己的 agent 提示词,服务于任何 LLM 编程工具。

用户案例
该项目在发布后迅速受到开源社区关注,GitHub 上已获得超过 20 万 star。大量开发者反馈,使用后 PR 变得更加简洁,AI 的“自作主张”现象明显减少。同时,它也被许多企业团队作为内部 AI 编码规范的蓝本,用来提升 AI 辅助开发的稳定性与可控性。

andrej-karpathy-skills链接

项目链接:https://github.com/multica-ai/andrej-karpathy-skills
multica-ai / andrej-karpathy-skills项目地址:https://github.com/multica-ai/andrej-karpathy-skills

本文地址:https://www.tgoos.com/45543

声明:本站资源均整理自互联网,版权归原作者所有,仅供学习交流使用,请勿直接商用,若需商用请购买正版授权。因违规使用产生的版权及法律责任由使用者自负。部分资源可能包含水印或引流信息,请自行甄别。若链接失效可联系站长尝试补链。若侵犯您的权益,请邮件(将 # 替换为 @)至 feedback#tgoos.com,我们将及时处理删除。转载请保留原文链接,感谢支持原创。