A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
💡 Use Cases
最适合需要AI辅助但又要严格控制代码质量、避免过度设计的编程场景。
修复遗留代码bug
Problem: 让AI修复一个复杂函数中的bug时,它经常擅自重构周边代码,引入新的问题。
Solution: 使用CLAUDE.md的"精准修改"原则,强制AI只修改与bug直接相关的代码行,不改变无关的注释、格式或相邻函数。
Example: 修复一个数据库查询函数中的SQL注入漏洞时,AI不会重写整个函数的错误处理逻辑,只专注于添加参数化查询部分。
实现简单功能需求
Problem: AI经常过度设计,把简单的数据验证功能实现成复杂的验证框架。
Solution: 应用"简单性优先"原则,要求AI只实现明确请求的功能,禁止添加未要求的抽象层或配置选项。
Example: 要求实现邮箱格式验证时,AI会提供一个简单的正则表达式函数,而不是创建包含多种验证器的Validator类。
重构大型代码库
Problem: AI在重构时经常做出错误假设,不确认代码意图就进行修改,导致功能损坏。
Solution: 启用"先思考后编码"原则,强制AI先明确陈述对代码的理解和假设,发现歧义时主动询问澄清。
Example: 重构一个复杂的支付处理模块前,AI会先列出它理解的各个组件职责,并询问不确定的业务逻辑细节。
添加测试覆盖
Problem: AI编写的测试经常遗漏边界情况,或者测试本身过于复杂难以维护。
Solution: 采用"目标驱动执行"策略,要求AI先编写测试用例定义成功标准,然后实现代码让测试通过。
Example: 添加用户注册验证时,AI会先编写测试用例覆盖所有无效输入场景,然后实现刚好能让这些测试通过的最小代码。
📊 Project Info
- Stars
- ⭐ 42,773
- Forks
- 3,470
- Today
- +9,646
- Ranking
- #1
- Collection
- Overall
- Trending Date
- April 15, 2026
- Last Push
- 4/15/2026
🏷️ Topics
5分钟快速开始:使用CLAUDE.md优化Claude代码生成
通过一个配置文件,快速提升Claude等AI助手在编程任务中的输出质量,减少错误假设和过度设计。
🖥️ OS
⚙️ Runtime
🔧 Tools
📝 Steps
安装Claude Code插件(推荐)
在Claude Code中添加市场并安装插件,使指南在所有项目中生效。
添加插件市场
$ claude code marketplace add https://github.com/forrestchang/andrej-karpathy-skills安装CLAUDE.md指南插件
$ claude code plugin install claude-md-guidelines或创建项目级CLAUDE.md文件
如果不想全局安装,可在项目中添加CLAUDE.md文件,仅影响当前项目。
下载CLAUDE.md文件到当前目录
$ curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md测试指南效果
在Claude Code中请求一个编程任务,观察输出是否符合指南原则。
模拟一个简单任务
$ 在Claude Code中输入:'请帮我写一个Python函数,计算两个数的和,并添加错误处理。'✅ 验证成功
确认CLAUDE.md指南正在生效,优化AI助手的代码生成行为。
- ✓Claude在编码前主动询问澄清问题
- ✓生成的代码简洁,无未请求的功能
- ✓修改仅针对任务,不波及无关代码
⚡ Quick Tips
🔍 Troubleshooting
❓ Claude Code未识别CLAUDE.md文件
→ 确保文件位于项目根目录,并重启Claude Code。
❓ 插件安装失败
→ 检查网络连接,或手动下载文件并放置到正确位置。
🎯 Next Steps
阅读CLAUDE.md文件内容
深入了解四大原则,以便更好地指导AI助手。
尝试复杂任务
用指南测试重构或调试任务,观察改进效果。