Karpathy 启发的 Claude Code 编码指南

项目简介

本项目提供一个单一的 CLAUDE.md 文件，整合了 Andrej Karpathy 关于大语言模型编码常见陷阱的观察，提炼为四条核心原则，用于指导 Claude Code 和 Cursor 等 AI 编码工具的行为，减少错误假设、过度设计、无关修改等问题。

主要特性

• 先思考后编码：强制显式表达假设、提出多种解释、必要时提出反对意见，避免模型默默猜测。
• 简单优先：只写解决问题的必要代码，避免不必要的抽象、过度配置和死代码。
• 外科手术式修改：只修改与任务直接相关的代码，不随意“改进”无关部分；清理自己产生的孤立代码。
• 目标驱动执行：将命令式指令转化为可验证的成功标准，让 AI 自主循环直至满足条件，例如先写测试再通过。

适用场景

适合使用 Claude Code 或 Cursor 的开发者，希望规范 AI 编码行为，减少返工、清理不必要变更、提升代码质量。

安装与使用

• Claude Code 插件：在 Claude Code 中添加市场 forrestchang/andrej-karpathy-skills，然后安装插件 andrej-karpathy-skills@karpathy-skills。
• 直接使用 CLAUDE.md：通过 curl 下载或追加到项目根目录的 CLAUDE.md 中。
• Cursor 支持：仓库包含 .cursor/rules/karpathy-guidelines.mdc 规则文件，可在 Cursor 中直接使用。

许可证

MIT 许可证，可自由使用和修改。