andrej-karpathy-skills 部署教程

这是一个基于 Andrej Karpathy 观察的 Claude Code 行为改进指南。它本身不是一个需要“部署”的应用程序，而是一个可安装的配置文件和规则集，用于指导 Claude Code 等 AI 编程助手遵循更严谨、更简洁的编码原则。本教程将指导你如何将这套规则应用到你的开发环境中。

1. 理解项目价值

在安装前，先了解它能解决什么问题。根据 Andrej Karpathy 的观察，AI 编程助手常见的问题包括：

做出错误假设：在不确认的情况下，基于自己的理解直接编写代码。
过度复杂化：将简单的功能实现得过于复杂，引入不必要的抽象。
产生副作用：修改或删除与当前任务无关的代码或注释。
缺乏验证：写完代码后，不通过测试来验证其正确性。

这个项目提供了一套四原则指导文件 (CLAUDE.md)，旨在通过明确的指令来缓解这些问题。

2. 安装方式

你可以通过以下两种方式将这套规则应用到你的 Claude Code 或 Cursor 环境中。

方式一：作为 Claude Code 插件安装（推荐）

这是最便捷的方式，安装后规则可在所有项目中生效。

启动 Claude Code：在终端中进入你的项目目录，并启动 Claude Code。
添加插件市场：在 Claude Code 的交互界面中，输入以下命令：
1
/plugin marketplace add forrestchang/andrej-karpathy-skills
安装插件：接着，输入以下命令进行安装：
1
/plugin install andrej-karpathy-skills@karpathy-skills

安装成功后，指导原则就会作为 Claude Code 的技能 (Skill) 在后台生效。

方式二：作为项目文件安装（`CLAUDE.md`）

如果你希望在单个项目中生效，或者不使用 Claude Code 插件系统，可以将指导文件添加到项目根目录。

对于新项目：在项目根目录执行以下命令，下载 CLAUDE.md 文件。

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

对于已有项目：如果你已经有 CLAUDE.md 文件，可以将这份指南追加到其末尾，而不是覆盖。

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

3. 在 Cursor 中使用

这个仓库也包含了一个 Cursor 的项目规则文件。要使用它：

访问仓库中的 .cursor/rules/karpathy-guidelines.mdc 文件。
你可以将此文件的内容复制到你当前 Cursor 项目的规则文件中，或参考 CURSOR.md 文档进行配置。
这样，当你在 Cursor 中打开该项目时，同样的指导原则也会被应用。

4. 核心原则与效果验证

安装后，AI 助手的行动应该遵循这四大原则。

四大核心原则

Think Before Coding (编码前思考)：强制 AI 先陈述假设、列出可能的方案，并在不确定时提问，而不是盲目开始。
Simplicity First (简单至上)：限制 AI 编写最少的必要代码，杜绝任何“预见性”的功能或过度设计。
Surgical Changes (精准修改)：要求 AI 只修改与任务直接相关的代码行，不顺手“优化”其他部分。
Goal-Driven Execution (目标驱动执行)：将模糊的指令（如“修复这个bug”）转化为可验证的目标（如“先写一个能复现bug的测试，然后让它通过”）。

如何判断规则在生效

你可以通过以下迹象来观察规则是否在起作用：

更简洁的代码差异 (Diff)：提交的变更只包含解决当前任务所需的代码。
更少的重写：代码第一次生成时就比较简洁，很少出现因过度复杂而需要重写的情况。
及时的澄清：AI 在开始编写代码之前，会提出澄清问题，而不是在生成错误代码之后。
干净的 PR：拉取请求中不包含无关的代码格式调整或“顺手”的重构。

5. 自定义与注意事项

自定义规则

这些通用指南可以方便地与项目特定的规则合并。例如，在 CLAUDE.md 文件末尾添加：

1
2
3

## Project-Specific Guidelines
- 必须使用 TypeScript 严格模式。
- 所有 API 端点都必须有对应的测试。

注意权衡

这套规则的设计是偏向于谨慎而非速度。对于非常简单的任务（如修正一个明显的拼写错误），你可以根据情况判断，不一定需要完全遵循所有步骤。它的核心目标是减少复杂任务中的代价高昂的错误。

总结

通过以上步骤，你已经成功地将 Andrej Karpathy 的经验法则融入到了你的 AI 编程助手中。这相当于为 AI 设置了一套“编码规范”，引导其行为更接近一位经验丰富的工程师。它不是一个传统意义上的软件服务，而是一个增强开发流程的配置层。建议从将其安装为 Claude Code 插件开始，亲身体验它对代码生成质量的改善。