Karpathy 风格 Claude Code 编码准则
一个 CLAUDE.md 文件，基于 Andrej Karpathy 对 LLM 编码陷阱的观察，通过四条原则改善 Claude Code 行为，减少错误假设、过度复杂化和无关修改。
过去 7 天收获 1 颗 Star
爱鲜报评分
0 人评分
226k
星数
是
中文
—
主语言
是
活跃
7
贡献者
人工分析
EDITORIAL推荐理由
该项目直击 LLM 编码中的常见痛点，如错误假设、过度设计和随意改动，提供了简洁有效的四条原则。对于使用 Claude Code 或 Cursor 的开发者，只需添加一个文件即可显著提升代码质量，减少返工。社区热度极高（Star 数超 22 万），且支持中文文档，值得一试。
适用场景
- 使用 Claude Code 进行日常开发
- 使用 Cursor 编辑器编写代码
- 团队统一 AI 编码规范
- 减少 AI 生成代码的过度复杂化
- 提升 AI 编码的准确性和可维护性
优点
- 原则简洁明了，易于理解和实施
- 直接针对 LLM 编码的常见问题
- 支持多种集成方式（插件或 CLAUDE.md）
- 提供中文文档，对中文用户友好
- 社区活跃，Star 数极高
缺点
- 可能增加简单任务的交互步骤
- 需要开发者适应更谨慎的编码风格
- 效果取决于模型对准则的遵循程度
项目简介
本项目提供了一个 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
评论
- 暂无评论，来写第一条吧。