Andrej Karpathy 编码准则中文版：Claude Code / Codex / Cursor AI 编程规则

面向中文开发者的 Claude Code、Codex、Cursor、AI Agent 编程行为准则。本仓库把 Andrej Karpathy 对 LLM 编码问题的观察整理成可直接使用的 CLAUDE.md、AGENTS.md、Cursor Rules 和 Claude Code Skill，帮助 AI 编程助手减少错误假设、过度工程化、无关改动和不可验证的实现。

如果你正在搜索 Claude Code 中文规则、Codex AGENTS.md、Cursor AI 编程规范、AI Agent coding guidelines、LLM 代码生成最佳实践、Karpathy 编程准则中文版，这个仓库就是一套开箱即用的提示词和项目规则模板。

适合谁使用

• 使用 Claude Code、Codex、Cursor、Cline、Windsurf、Aider 或其他 AI 编程助手的开发者。
• 希望减少“AI 擅自改代码”“越改越复杂”“没问清楚就实现”的团队。
• 想把项目级 AI 编程规范沉淀为 CLAUDE.md、AGENTS.md、Cursor Rule 或 Skill 的工程团队。
• 需要一份中文 AI Coding Prompt / Agent Rules / LLM Coding Guidelines 的个人开发者。

它解决什么问题

来自 Andrej Karpathy 对 LLM 编码陷阱的观察：AI 编程助手常常会替用户做错误假设，不主动澄清，隐藏困惑，过度设计，顺手改无关代码，甚至删除自己没有充分理解的内容。

本仓库把这些问题收束为四条可执行原则：

原则	解决的问题	对 AI 编程的价值
编码前先思考	错误假设、隐藏困惑、缺少取舍说明	让 AI 先澄清，再实现
简洁优先	过度复杂、抽象膨胀、提前设计	让代码更短、更直接、更易维护
精准改动	无关编辑、顺手重构、误删代码	让 diff 更小，PR 更干净
目标驱动执行	目标模糊、缺少验证、实现不可复现	让 AI 用测试和检查闭环完成任务

快速使用

1. Claude Code

在 Claude Code 中添加 marketplace：

/plugin marketplace add MackDing/andrej-karpathy-skills-zh

安装插件：

/plugin install andrej-karpathy-skills@karpathy-skills

也可以直接使用 CLAUDE.md：

新项目：

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

已有项目追加：

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/MackDing/andrej-karpathy-skills-zh/main/CLAUDE.md >> CLAUDE.md

2. Codex

Codex 和通用 AI Coding Agents 推荐使用 AGENTS.md：

curl -o AGENTS.md https://raw.githubusercontent.com/MackDing/andrej-karpathy-skills-zh/main/AGENTS.md

已有项目追加：

echo "" >> AGENTS.md
curl https://raw.githubusercontent.com/MackDing/andrej-karpathy-skills-zh/main/AGENTS.md >> AGENTS.md

AGENTS.md 更偏执行规则，适合让 Codex 在编码、审查、重构和验证时持续遵守。

3. Cursor

本仓库已经包含 Cursor 项目规则：

.cursor/rules/karpathy-guidelines.mdc

把这个文件复制到你的项目 .cursor/rules/ 目录中，即可让 Cursor 在该项目中自动应用同一套 AI 编程准则。

支持的 AI 编程工具

工具	推荐文件	用途
Claude Code	CLAUDE.md / Claude Code Skill	项目级规则和插件安装
Codex	AGENTS.md	Codex 与通用 AI Agent 项目规则
Cursor	.cursor/rules/karpathy-guidelines.mdc	Cursor 自动应用规则
其他 AI Coding Agents	AGENTS.md 或 CLAUDE.md	复制为项目级提示词或规则文件

CLAUDE.md、AGENTS.md 和 Cursor Rules 有什么区别

文件	面向工具	内容定位
CLAUDE.md	Claude Code	Claude Code 项目级说明
AGENTS.md	Codex / 通用 AI Agent	更直接的执行规则和禁止事项
.cursor/rules/karpathy-guidelines.mdc	Cursor	Cursor 项目规则，支持自动应用

四项核心准则

1. 编码前先思考

不要擅自假设。不要掩盖困惑。把取舍讲清楚。

LLM 经常会悄悄选择一种理解，然后直接开始写代码。正确做法是先暴露假设：

• 明确说明当前假设，不确定时先问。
• 如果存在多种理解，列出选项而不是默默选择。
• 如果有更简单、更稳妥的方案，主动指出。
• 如果上下文不足，先停下来说明哪里不清楚。

2. 简洁优先

用能解决问题的最少代码。不要做推测性设计。

AI 编程助手很容易把小需求写成大框架。这个准则要求：

• 不实现需求之外的功能。
• 不为只用一次的代码抽象一套体系。
• 不添加用户没有要求的配置项、扩展点和“灵活性”。
• 如果 200 行可以缩成 50 行，就重写成 50 行。

3. 精准改动

只改必须改的地方。只清理你自己造成的问题。

在真实项目中，AI 最大的风险之一是顺手改坏无关代码。这个准则要求：

• 不顺手改相邻代码、注释或格式。
• 不重构没有坏掉的模块。
• 匹配项目既有风格，而不是强行套自己的偏好。
• 每一行 diff 都能追溯到用户请求。

4. 目标驱动执行

定义成功标准。循环推进直到完成验证。

不要只说“修复 bug”或“添加功能”，而是把任务变成可验证目标：