夜雨聆风最近， GitHub 上有一个项目悄悄冲上了 Trending 榜首，拿到了 4.4 万 Star 。
它没有复杂的代码，没有庞大的依赖包，甚至只包含一个文件：CLAUDE.md。
这个项目叫 andrej-karpathy-skills，是由 AI 届“神级”人物 Andrej Karpathy（前特斯拉 AI 总监、 OpenAI 联合创始人）的编程习惯总结而来。
很多人用 AI （如 Claude Code 、 Cursor ）写代码时有个通病：
* 写得太快：一上来就生成几百行代码，跑起来再说。
* 不看上下文：经常覆写已有的函数，导致“修了一个 Bug ，引出三个新 Bug"。
* 缺乏工程规范：变量名乱起，没有注释，错误处理全靠 try...except 一把梭。
这个项目的出现，就是为了解决这个问题。
今天这篇，我们不讲虚的，直接拆解 Karpathy 的“调教秘籍”，教你如何用这一个文件，让 AI 从“快手实习生”进化成“资深架构师”。
01 核心原理：什么是 CLAUDE.md ？
在 Claude Code 或 Cursor 中，项目根目录下的 CLAUDE.md 文件就像是“项目宪法”。
AI 在每次写代码前，都会强制阅读这个文件。
Karpathy 的这个文件，不仅仅是规则，更是一套完整的工程工作流。它通过系统提示词工程（ System Prompt Engineering ），强行矫正大模型的“懒惰”和“幻觉”。
02 实操演示：如何让你的 AI“脱胎换骨”？
为了让你直观感受到它的威力，我选取了该文件中三个最核心的“指令模块”，并配合实操前后的对比演示。
演示一：拒绝“一把梭”，强制“先读后写”
大多数 AI 编程的噩梦是：让它改 Bug ，它直接把整个文件重写了，导致你丢失了之前的逻辑。
❌ 改造前（默认 AI 行为）：
用户：“修一下 login.py 的报错。”
AI ：直接生成一个新的login.py覆盖原文件，导致数据库连接逻辑丢失。
✅ 改造后（ Karpathy 模式）：
在 CLAUDE.md 中加入以下规则：
## Rules: Read Before Write
-**ALWAYS** read the existing file before editing.
-**NEVER** output a full file unless explicitly asked. Use `apply_patch` or `edit` to make surgical changes.
-If a file is large, use `grep` or `search` to find the specific lines first.
💡 效果：
现在 AI 会先运行 cat login.py 或 grep "error" login.py，确认上下文后，只修改报错的那几行代码。安全性提升 100%。
演示二：像架构师一样思考（ Chain of Thought ）
新手 AI 一上来就写代码。资深工程师会先设计。
❌ 改造前（默认 AI 行为）：
用户：“写一个爬虫。”
AI ：立刻给出 50 行requests代码，没考虑并发，没考虑反爬。
✅ 改造后（ Karpathy 模式）：
在 CLAUDE.md 中加入"Plan"指令：
## Workflow: Plan First
-Before writing complex code, **explain your plan briefly**.
-List the files you will create or modify.
-Mention any potential edge cases you are handling (e.g., network timeouts).
💡 效果：
AI 现在会回复：
“好的，我计划分三步：
1. 创建scraper.py处理请求，加入retry机制防超时。
2. 创建parser.py解析 HTML ，使用 BeautifulSoup 。
3. 编写主循环，支持断点续传。
确认无误后我将开始生成代码。”
这让你有机会在代码生成前Review 它的逻辑。
演示三：强制工程规范（日志与注释）
❌ 改造前（默认 AI 行为）：
满屏的
print("here 1")，print("here 2")，调试起来极其痛苦。
✅ 改造后（ Karpathy 模式）：
## Coding Style
-**Logging**: Use the standard `logging` library instead of `print` statements.
-**Typing**: Always use Python type hints (e.g., `def func(a: int) -> str:`).
-**Comments**: Explain **WHY** you did something, not **WHAT** the code does.
💡 效果：
AI 会自动生成带有类型注解、规范日志系统的生产级代码，而不是学生作业。
03 手把手教学：如何安装使用？
不需要克隆整个仓库，也不需要复杂的配置，只需 3 步。
第一步：获取配置内容
你可以直接访问 GitHub 仓库 forrestchang/andrej-karpathy-skills 复制内容，或者直接复制下面我为你精简的通用版：
## Core Philosophy
1. **Simplicity**: The simplest code is the best code. Avoid over-engineering.
2. **Readability**: Code is read more often than it is written. Name variables clearly.
3. **Robustness**: Handle errors gracefully. Don't let the script crash silently.
## Workflow
-Always read the file before editing.
-Use `git` commands to check status if unsure.
-Break large tasks into small, testable steps.
第二步：放入项目
在你的项目根目录下创建一个名为 CLAUDE.md 的文件，将内容粘贴进去。
touchCLAUDE.md
第三步：见证奇迹
重新开启你的 AI 编程会话。你会发现， AI 的回复风格变了：它开始先阅读、先思考，写出的代码更加规范、健壮。
04 进阶：如何定制你自己的“宪法”？
Karpathy 的规则适合通用场景，你可以根据团队需求修改。
AI 编程的下半场，拼的不是模型有多聪明，而是谁的 Prompt 更懂工程化。
你平时用 AI 写代码最怕遇到什么坑？欢迎在评论区吐槽 👇
🤖 AI 深度洞察 — 前沿 AI ，深度拆解。每天 3 分钟，看透 AI 底层逻辑。
扫码关注，获取最新 AI 干货 👇
