Claude Code 编程准则指南：1 个文件纠正 AI 写代码的 4 个坏习惯

Claude Code 编程准则指南1 个文件纠正 AI 写代码的 4 个坏习惯【免费下载链接】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 把 Andrej Karpathy 观察到的大模型编程毛病浓缩成一份 CLAUDE.md 行为准则文件放进项目就能约束 Claude Code命令行的 AI 编程助手的默认行为不乱猜、不过度设计、不顺手改无关代码。AI 写代码最常翻车的三个场景问题比想象中常见模型能力够了但职业习惯不行。Karpathy 总结的三类毛病几乎每个用过 AI 编程工具的人都踩过。闷头假设需求有歧义时模型会自己挑一种解释直接开写全程不澄清。你说让搜索变快它可能直接上缓存、加索引、改异步。过度设计明明几十行能解决的计算它给你配策略模式、抽象基类和配置对象还顺手加上没人要的灵活性。顺手乱改修一个空值 bug它把周边注释、引号风格、类型标注全优化一遍diff 里全是任务之外的改动。这些毛病单看都不致命叠加起来却是代码评审反复返工的根源。约束一动手前先把假设摆到桌面上准则的第一条原则专门治闷头假设实现之前AI 必须显式说明自己的假设不确定就提问存在多种理解时把几种解释都列出来而不是默默选一个。差别很直观。你说导出用户数据被约束后的 AI 会先问导出全部还是筛选后的子集什么格式包含哪些字段数据量多大——而不是直接写一个默认全量导出到固定路径的函数。如果它发现存在更简单的方案也被要求主动说出来、提出异议遇到看不懂的地方则停下来明确指出。约束二最小代码外科手术式修改 ⚙️第二、三条原则合在一起解决写得臃肿、改得越界。写新代码时只写解决问题的最少内容不加没被要求的功能不为一次性逻辑建抽象不做针对不可能场景的错误处理写多了就重写。检验标准很简单——换个资深工程师来看会不会觉得这写复杂了改老代码则要求只碰必须碰的不顺手优化相邻代码和格式不重构没坏的东西风格跟随现有写法发现无关的死代码提一句即可不许删。只清理自己这次改动产生的孤儿无用的导入、变量、函数。判据是每一行改动都能直接对应到需求本身。约束三给成功标准而不是给步骤Karpathy 有个观察模型非常擅长循环直到达成目标。所以准则要求把模糊指令翻译成可验证目标例如加验证变成先给非法输入写测试再让测试通过修 bug变成先写一个能复现问题的测试再修复它。多步任务则要求列出简短计划每一步附带验证方式。标准给得越明确模型越能独立推进让它能跑就行这种弱标准只会换来反复的来回确认。仓库里还有一份 EXAMPLES.md用真实代码片段对比了各原则下常见错误做法与正确做法值得翻一遍。如何接入现有项目插件与 CLAUDE.md 两种安装方法结论先行想全局生效用插件只服务单个项目就直接拷文件。方式一Claude Code 插件推荐所有项目通用/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills方式二项目级 CLAUDE.md按项目生效git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills把仓库里的 CLAUDE.md 拷到你的项目根目录即可已有 CLAUDE.md 的话把内容追加合并进去别覆盖。Cursor 用户如何接入Cursor 默认不读 CLAUDE.md走的是项目规则文件把仓库里的 .cursor/rules/karpathy-guidelines.mdc 拷到目标项目的 .cursor/rules/ 目录没有就新建在设置 → 规则里能看到 karpathy-guidelines 即生效。CURSOR.md 里有更细的说明。使用技巧与常见误区与项目规则合并而不是二选一准则本来就是设计成能和项目专属指令共存的。你可以在 CLAUDE.md 里加一段项目要求比如使用 TypeScript 严格模式所有 API 端点必须有测试。别对小任务上全套流程准则整体偏向谨慎优先于速度。改个错别字、加一行日志不必走先列假设再写测试的完整链路用你自己的判断即可。指令里主动带上验收标准与其说修一下登录问题不如说先写一个能复现该问题的测试再修复并让测试通过——这正是准则第四条鼓励的用法。怎么判断准则已经生效 ✅看四个信号就够了diff 里只剩下你要求的改动因过度复杂导致的重写变少澄清问题出现在动手之前而不是返工之后PR 干净精简没有顺带的重构。如果你开始频繁在前几项上看到变化说明这份文件真的在干活。一句话总结andrej-karpathy-skills 不教你新算法它只做一件事——把 AI 的默认行为从先干了再说调成先对齐再动手代价只是根目录多一个文件。【免费下载链接】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），仅供参考