霸榜 GitHub，Claude Code 用户必读的 CLAUDE.md 指南

一次小改变，如何让 Claude Code 从 65% 提升到 94%

在 AI 编程助手风靡全球的今天，Claude Code 作为其中的佼佼者，已经成为许多开发者的首选。然而，一个令人头疼的问题是：每次与 Claude Code 对话，都像是在重新认识彼此。项目背景、技术栈、代码规范、之前的决策——所有这些都需要反复解释。结果，效率低下，AI 的建议也常常不尽如人意。

然而，一个名为 CLAUDE.md 的文件正在改变这一切。它不仅登上了 GitHub Trending 榜首，还收获了 8.2 万个 stars 和 7800 次 forks。更重要的是，它将 Claude Code 的编码准确率从 65% 提升到了 94%。这个小小的文本文件，究竟有何魔力？

CLAUDE.md：AI 的“工作说明书”

CLAUDE.md 是一个简单的纯文本文件，但它扮演着 AI“工作说明书”的角色。它被放置在项目的根目录下，Claude 每次启动时都会自动读取其中的内容。这个文件的作用是：

1. 减少重复解释：不再需要每次都告诉 Claude 你的技术栈和代码规范。
2. 限制模型越界：明确哪些操作是 Claude 不被允许的，例如未经确认删除文件或重构代码。
3. 提高稳定性：让 AI 的建议更加符合项目需求，减少错误和误导。

Karpathy 的 4 条黄金规则

CLAUDE.md 的流行始于 Andrej Karpathy，这位曾任特斯拉 AI 负责人、OpenAI 创始成员之一的传奇人物。他总结了 4 种会让 Claude Code 失效的行为，并将其写入了 CLAUDE.md：

1. 不清楚就先问：如果对用户的指令有疑问，Claude 必须先澄清，而不是猜测。
2. 先做最简单方案：在尝试复杂方案之前，先提供一个简单直接的解决方案。
3. 不碰无关代码：除非明确指示，否则不要修改与当前任务无关的代码。
4. 明确说明不确定性：如果对某个问题不确定，Claude 必须明确说明，而不是提供模糊的建议。

这 4 条规则构成了 CLAUDE.md 的基础框架，确保 AI 在工作时不会偏离用户的预期。

如何创建你的 CLAUDE.md

如果你正在使用 Claude Code，以下是如何创建并使用 CLAUDE.md 的步骤：

1. 创建文件：在项目根目录下创建一个名为 CLAUDE.md 的文件。
2. 基础设置：首先，添加 Karpathy 的 4 条黄金规则。这将为你提供一个稳固的起点。
3. 项目特定信息：根据你的项目需求，添加以下内容：
   • 技术栈：列出项目使用的主要技术、框架和库。
   • 代码规范：描述项目的代码风格和格式要求。
   • 重要决策：记录之前做出的重要决策，例如为什么选择某个技术方案。
   • 限制和约束：明确哪些操作是 Claude 不被允许的，例如删除特定文件或修改关键模块。
4. 持续更新：随着项目的进展，定期更新 CLAUDE.md，确保 AI 始终了解最新的项目状态和需求。

CLAUDE.md 的实际效果

一位开发者分享了他的使用体验：

“在使用 CLAUDE.md 之前，Claude Code 经常误解我的指令，甚至会删除重要的代码文件。自从添加了 CLAUDE.md 后，AI 的建议变得更加精准，编码效率提高了至少 30%。更重要的是，我不再需要反复解释项目背景和需求，这为我节省了大量时间。”

结语

CLAUDE.md 的出现，标志着 AI 编程助手进入了一个新的阶段。它不仅是一个简单的文本文件，更是一个让 AI 与人类开发者更高效协作的工具。通过减少重复解释、限制模型越界，CLAUDE.md 让 AI 编程更加稳定、可控。

对于每一位使用 Claude Code 的开发者来说，创建一个 CLAUDE.md 文件都是一项值得尝试的改变。它不仅能提升编码效率，还能让 AI 更好地理解你的需求，成为你真正的编程助手。

#GitHub #ClaudeCode #编程助手 #CLAVDE #AI效率提升