Karpathy 风格的 Claude Code 编程指南
用更少假设和更小改动编写可验证的代码
内容明确源自 Andrej Karpathy 公开发言中总结的 LLM 编码常见问题，四条准则具体、可操作（如「改动的每一行都应能追溯到用户请求」），不是空泛的最佳实践罗列。
纯行为准则文档（先思考再写代码/简洁优先/精确改动/目标驱动验证），不执行任何操作，也不涉及数据处理或网络访问，风险面几乎为零。
star 数（191284）明显不合理地偏高，与内容本身（一个单文件行为准则）的传播规模不匹配，未核实原因，不影响本次基于内容本身的评分。
它能做什么 & 适用场景
这是一个通过单个 CLAUDE.md 文件改善 Claude Code 行为的指南项目，内容源自 Andrej Karpathy 对大语言模型编码陷阱的观察。它围绕先思考、优先简单、手术式修改和目标驱动执行四项原则展开。指南要求模型明确假设、避免过度设计、限制无关改动，并通过测试和验证标准确认结果。README 同时说明项目包含 Cursor 规则，但源资料未提供 SKILL.md 内容，且仓库元数据中的许可证标为未知，README 另称许可证为 MIT。
该项目提供一套面向编码代理的行为准则，而不是代码库、框架或独立运行工具。它指导代理在实现任务前澄清歧义，在修改时只触及必要内容，并把任务转化为带有验证步骤的目标。
- 在 Claude Code 中减少未经确认的假设，并促使模型在存在歧义时提问。
- 限制过度工程化，例如避免为一次性代码创建抽象或加入未请求的可配置性。
- 在维护现有项目时减少无关重构、格式调整和评论改动。
- 为新增验证、修复缺陷或重构任务建立测试优先和结果可验证的执行循环。
- 将通用编码行为准则与项目自身的 TypeScript、API 测试或错误处理规则合并。
优缺点一览
- 明确覆盖假设管理、简化设计、限制改动范围和结果验证四类常见编码代理问题。
- 提供了具体行为规则，例如不为单次使用代码创建抽象、不删除预先存在的无关死代码。
- 鼓励使用测试复现缺陷或验证新增校验，使成功标准更容易检查。
- 支持作为项目级 CLAUDE.md 内容合并，也提供 Cursor 规则文件。
- 源资料未提供 SKILL.md，因此无法核实标准 Agent Skills 前置元数据或完整技能结构。
- 指南明确偏向谨慎而非速度，简单任务也可能引入不必要的流程负担。
- 它是行为指导文件，不提供测试框架、代码分析器或自动化验证工具。
- 仓库标识与 README 安装命令中的 GitHub 用户名不一致，安装来源需要使用者自行核对。
如何安装
README 提供两种安装方式。Claude Code 插件方式是先执行 /plugin marketplace add forrestchang/andrej-karpathy-skills，再执行 /plugin install andrej-karpathy-skills@karpathy-skills。按项目安装方式是新项目执行 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。需要注意，源仓库标识为 multica-ai/andrej-karpathy-skills，而 README 中的安装地址使用 forrestchang/andrej-karpathy-skills，两者存在不一致。
如何使用
安装为 Claude Code 插件后，指南可用于所有项目。按项目方式安装时，将内容放入项目的 CLAUDE.md；项目还提供 .cursor/rules/karpathy-guidelines.mdc，并通过 CURSOR.md 说明 Cursor 使用方式。执行任务时，先说明假设或提出澄清问题，再选择最简单的实现，限制改动范围，并为每个步骤定义检查或测试。
对比同类
与直接向编码代理下达命令相比，它强调先定义可验证的成功标准，并通过循环检查结果。与项目专属规则相比，它提供的是通用行为原则，可与现有 CLAUDE.md 中的语言、API 和测试规范合并；源资料没有提供与其他具体编码代理技能的功能对比。