阅读项目README，理解核心问题

仔细阅读GitHub仓库的README文件，重点理解Andrej Karpathy指出的三大问题（错误假设、过度复杂化、无关修改）以及对应的四大解决原则（先思考后编码、简单性优先、精准修改、目标驱动执行）。

不必深究每个技术细节，重点是把握“用明确的规则引导AI，而非任由其自由发挥”的核心思想。

选择安装方式

根据你的使用场景，决定采用哪种方式应用这些指南： 1. **Claude Code插件（推荐）**：如果你主要使用Claude Code，这将使指南在所有项目中生效。 2. **项目级CLAUDE.md文件**：如果你希望规则仅应用于特定项目，或者使用的AI工具支持读取此类配置文件。

对于新手，建议从“项目级CLAUDE.md文件”开始，更简单直观，便于观察效果。

方式A：安装Claude Code插件（如选择）

1. 在Claude Code界面中，首先添加市场：`claude code:marketplace add https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/marketplace.json` 2. 然后安装技能：`claude code:skill install forrestchang/andrej-karpathy-skills`

此方式需要你已安装并运行Claude Code。安装后，指南将作为一项“技能”全局可用。

方式B：创建项目级CLAUDE.md文件（如选择）

1. 打开你的项目根目录。 2. 创建一个名为`CLAUDE.md`的新文件。 3. 将项目README中“The Four Principles in Detail”部分之后、直到“Customization”之前的所有内容（即四大原则的详细描述）复制粘贴到该文件中。

你可以直接访问项目GitHub页面，复制`CLAUDE.md`文件的原内容，这是最准确的方式。文件应放在与`README.md`同级的位置。

发起一个简单的编程任务

在你的项目中，向AI助手（已配置CLAUDE.md）提出一个清晰但非琐碎的编程请求。例如：“为这个用户模型添加一个‘年龄’字段的验证，确保年龄在0到150之间。”

避免过于开放或模糊的指令，如“优化这段代码”。从有明确边界的功能添加或Bug修复开始。

观察AI的响应行为

仔细阅读AI生成的代码和解释，对照四大原则检查： 1. **先思考后编码**：AI是否在开始编码前陈述了它的假设或提出了澄清性问题？ 2. **简单性优先**：生成的代码是否直接解决了问题，没有添加额外的抽象或“未来可能有用”的功能？ 3. **精准修改**：AI是否只修改了与“年龄验证”相关的代码，没有改动其他无关的格式、注释或函数？ 4. **目标驱动执行**：AI是否建议或直接编写了测试来验证其修改的正确性？

初次可能不会完美体现所有原则，重点是观察与未使用指南时的行为差异。

检查“如何知道它起作用了”

回顾项目README中“How to Know It's Working”部分。评估你的体验： - 生成的代码差异（diff）是否干净，只包含必要的更改？ - 代码是否第一次就相对简洁，不需要你要求重写？ - AI是否在犯错前就先寻求了澄清？

即使只有部分改善，也说明指南正在发挥作用。这是一个优化过程。

理解权衡与适用场景

阅读“Tradeoff Note”。明白这些指南偏向“谨慎而非速度”。对于修复一个明显的拼写错误，可能不需要完整的流程。学会判断何时需要严格遵循指南（非琐碎工作），何时可以放松。

核心思想是：用指南来防止在复杂任务上犯下代价高昂的错误，而不是拖慢所有简单任务。

尝试定制CLAUDE.md

如果你有项目特定的编码规范或要求，可以将其添加到`CLAUDE.md`文件中。例如，在文件末尾添加：“## 项目特定规则\n- 本项目使用4个空格缩进。\n- 所有函数必须包含JSDoc注释。”

确保自定义规则与原有的四大原则在精神上保持一致，都是为了让AI的输出更可控、更符合预期。不要添加矛盾的指令。