Karpathy 风格 Claude Code 编码准则

项目简介

本项目提供了一个 CLAUDE.md 文件，基于 Andrej Karpathy 对大型语言模型（LLM）编码陷阱的观察，旨在改善 Claude Code 的行为。通过四条核心原则，帮助开发者减少 AI 编码中的错误假设、过度复杂化和无关修改。

核心原则

1. 编码前思考

• 明确陈述假设，不确定时提问而非猜测
• 呈现多种解释，避免 silently 选择
• 在必要时提出反对意见，指出更简单的方案
• 遇到困惑时停下来，明确问题并寻求澄清

2. 简单优先

• 只编写解决问题的最小代码，不添加推测性功能
• 避免为一次性代码创建抽象
• 不添加未要求的“灵活性”或“可配置性”
• 如果 200 行可以缩减到 50 行，就重写它

3. 精准修改

• 只修改必须修改的部分，不“改进”相邻代码
• 不重构未损坏的代码
• 匹配现有代码风格
• 如果发现无关的死代码，提及但不删除

4. 目标驱动执行

• 将指令性任务转化为可验证的目标
• 例如：将“添加验证”转化为“为无效输入编写测试，然后使其通过”
• 对于多步骤任务，制定简要计划并验证每一步

安装与使用

方式一：Claude Code 插件（推荐）

在 Claude Code 中添加市场：

/plugin marketplace add forrestchang/andrej-karpathy-skills

然后安装插件：

/plugin install andrej-karpathy-skills@karpathy-skills

方式二：项目级 CLAUDE.md

新项目：

curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

现有项目（追加）：

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

与 Cursor 配合使用

仓库包含 Cursor 项目规则文件 .cursor/rules/karpathy-guidelines.mdc，在 Cursor 中打开项目即可应用相同准则。详见 CURSOR.md。

自定义

这些准则设计为与项目特定指令合并。在现有 CLAUDE.md 中添加或创建新文件，并加入项目特定规则，例如：

## 项目特定准则

- 使用 TypeScript 严格模式
- 所有 API 端点必须有测试
- 遵循 `src/utils/errors.ts` 中的错误处理模式

注意事项

这些准则偏向谨慎而非速度。对于简单任务（如拼写修复、明显的一行代码），请自行判断，并非每个更改都需要完整流程。目标是减少非平凡工作中的 costly 错误，而不是拖慢简单任务。

许可证

MIT