用一份 CLAUDE.md 约束 Claude Codeandrej-karpathy-skills 四条行为原则与安装实操指南【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skillsandrej-karpathy-skills 是一个只用一份 CLAUDE.md 来约束 Claude Code 写码行为的开源项目。它针对的问题很具体AI 助手写代码时喜欢擅自假设需求、用 1000 行去做 100 行就能做的事、顺手改掉无关的代码和注释。这个项目把 Andrej Karpathy 对 LLM 编码弊端的观察整理成四条行为原则装进一个文件里就能生效。本文按仓库里有什么 → 原则是什么 → 怎么装 → 怎么用起来 → 什么时候不用的顺序讲清楚。 先看仓库全貌核心只有一个文件整个仓库文件很少核心就是一个 CLAUDE.md其余都是它的变体或配套材料CLAUDE.md规则正文四条原则可直接放进项目使用skills/karpathy-guidelines/SKILL.md同内容的技能Skill格式版本供 Agent 技能机制加载EXAMPLES.md正反例对照展示每条原则下 AI 常见的错误做法和正确做法CURSOR.md在 Cursor 里使用同一套规则的说明结论先行你只需要关心 CLAUDE.md 这一个文件其他文件是它面向不同工具的分发形态。 四条原则的出处三个观察Karpathy 对 LLM 写代码的观察概括起来是三句话这个项目的每条原则都是冲着其中一点去的观察对应原则模型会替你做出错误假设并且不核实就一路执行编码前先思考喜欢把代码和 API 搞复杂100 行能搞定偏要写成 1000 行简洁优先会改动或删除自己没充分理解、且与任务无关的代码和注释外科手术式修改通用缺乏可验证的完成标准需要反复追问目标驱动执行✂️ 四条原则逐条讲它们各自管住什么编码前先思考这一条要求 AI 在动手前把假设摊牌而不是默默选一种解释就往下写把假设明确写出来不确定就问存在多种理解时全部列出来让你选不私自拍板发现更简单的做法主动说卡住了就停下来指出哪里不清楚然后提问简洁优先管住的是过度设计。交付最小可用实现不预留任何以防万一不加没被要求的功能、不给一次性代码抽类、不加没人要的可配置性不为不可能发生的场景写错误处理200 行能压到 50 行就重写自检标准资深工程师会不会说这写复杂了会就简化外科手术式修改管住的是 diff 污染。规则只有一句核心每一行改动都要能追溯到你的请求。不顺手改进相邻的代码、注释、格式不重构没坏的东西风格跟着现有代码走哪怕你个人更习惯别的写法发现无关的死代码提一句不删自己改动产生的孤儿导入、变量、函数要清掉改动前就存在的死代码没被要求就不动目标驱动执行管住的是模糊任务。做法是把祈使句改写成可验证的目标原始说法改写后添加验证为无效输入写测试然后让它们通过修复 bug写一个能复现它的测试然后让它通过重构 X确保重构前后测试都能通过多步骤任务则要求先给出带验证条件的计划格式类似1. [步骤] → 验证[检查项]。逻辑很简单标准定得越清楚模型越能自己循环推进标准含糊让它能跑就行你就得全程陪聊。 安装三种方式任选其一全局生效Claude Code 插件在 Claude Code 里先加市场再装插件/plugin marketplace add forrestchang/andrej-karpathy-skills/plugin install andrej-karpathy-skillskarpathy-skills装完所有项目自动带这套规则不用逐项目维护文件。单项目生效放进 CLAUDE.md新项目直接下载curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md已有 CLAUDE.md 的项目追加到文件末尾echo CLAUDE.md curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md CLAUDE.md也可以克隆整个仓库自行查看后手动复制git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skillsCursor 用户仓库自带一个 Cursor 项目规则 .cursor/rules/karpathy-guidelines.mdcalwaysApply: true在本仓库内打开即生效。用在别的项目时把该 .mdc 文件复制到目标项目的.cursor/rules/目录即可只支持根指令文件的工具则直接复制 CLAUDE.md。详见 CURSOR.md。 和自己的项目规则合并使用这份规则设计上是可叠加的不排斥你自己的约定。常用做法是在 CLAUDE.md 末尾追加一节项目特定指南只列你真正需要强调的条目例如使用 TypeScript 严格模式所有 API 端点必须有测试错误处理遵循src/utils/errors.ts里的现有模式通用行为原则和团队规范放在同一份文件里维护成本最低。 什么时候不用它以及怎么判断它在起效先说边界整套规则偏向谨慎而非速度。修拼写错误、改显而易见的一行代码时不必走完整的列假设 → 给验证标准流程按判断来就行。它的目标是减少非琐碎任务上的昂贵返工不是拖慢简单任务。判断它是否生效看四个信号diff 里只出现你要求的改动没有顺带的重排和改进因为写复杂了而要求重写的次数变少澄清性问题出现在动手之前而不是出错之后提交的 PR 干净、体量可控✅ 两条马上可以做的建议选一个新项目用 curl 把 CLAUDE.md 放进去正常提几个功能需求观察 AI 是否开始先提问再动手——这是四条原则里最快见效的一条。用一两次之后把你们团队的既有规范语言模式、测试要求、错误处理方式追加到同一份 CLAUDE.md 里让行为原则和项目约定同源管理。这个项目的价值不在于让代码写得更快而在于把AI 顺手多做的事压到最少。规则本身只有几十行读一遍 EXAMPLES.md 里的正反例对照基本就能判断它适不适合你的工作流。【免费下载链接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.项目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考