CLAUDE.md 热潮背后：AI 编程代理的项目操作系统

Karpathy 的 CLAUDE.md 登上 GitHub 趋势榜第一，拥有 82,000 颗星。多数开发者仍然没有读过它。

一个名为 CLAUDE.md 的文件登上了 GitHub Trending 第一。

82,000 颗星。7,800 次 fork。

这件事始于 Andrej Karpathy。前 Tesla AI 总监，OpenAI 创始成员之一。他识别出 4 种会让 Claude Code 失效的行为，并把它们写进了一个文件。

有一位开发者把这 4 条规则扩展成完整文件并发布出去。它迅速走红。

原因是：编码准确率从 65% 提升到 94%。

大多数每天使用 Claude Code 的开发者从未做过这项设置。他们每次会话都从零开始。重复解释同样的上下文。清理不该发生的范围变更。回滚没人要求的重构。

下面就是完整文件。

大多数开发者错过的设置

每次你打开 Claude Code，它都是从空白开始。

它不知道你的技术栈。你的标准。你的项目上下文。你已经试过什么。你在三个会话之前已经明确决定不做什么。

所以它只能猜。一旦它开始猜，就会重构你没有让它碰的代码。它会建议破坏现有架构的框架。它会在不询问的情况下删除文件。它会违背你已经做过的决策。

CLAUDE.md 是一个纯文本文件，放在项目根目录。Claude Code 会在每次会话开始时自动读取它。

一次设置。零重复解释。修复三类昂贵错误。

1 / 3 | 默认项：你每周花 375 美元在重复解释自己

普通开发者每天会花 30 分钟向 Claude 重新解释上下文。

技术栈。编码标准。项目背景。已经尝试过什么。除非你把这些内容一次性写下来，并让 Claude 每次都读取，否则它们不会在会话之间保留下来。

每天 30 分钟，按开发者 150 美元/小时计算：每周 375 美元。每位开发者。

一个 5 人团队：每周流失 1,875 美元。

下面这 7 条规则放在你的 CLAUDE.md 文件顶部。

→ 去掉寒暄废话：

永远不要用“Great question!”、“Of course!”、“Certainly!” 或类似寒暄开头。每次回复都直接从实际答案开始。不要铺垫，不要先确认问题。

→ 根据任务匹配回复长度：

根据任务复杂度匹配回复长度。简单问题给直接、简短的答案。复杂任务给完整、详细的回答。不要用复述问题或重复刚才内容的收尾句来填充篇幅。

→ 行动前先给选项：

在任何重要任务开始前，先展示 2-3 种可以完成这项工作的方式。等我选择之后再继续。

→ 在它让我付出代价之前承认不确定：

如果你对任何事实、统计数据、日期或技术信息不确定：在引用之前明确说出来。不要用听起来合理的信息填补知识空白。不确定时，就说不确定。

→ 我是谁，我知道什么：

关于我：[姓名] / 角色：[你的角色] / 背景领域：[领域]。擅长：[你很熟悉的内容]。还在学习：[知识缺口]。每次回复都按这个信息调整深度。不要过度解释我已经知道的内容。也不要跳过我需要的上下文。

→ 当前项目上下文：

我正在做什么：[项目名] / 目标：[具体结果] / 受众：[谁会使用它] / 技术栈上下文：[任何相关约束] / 需要避免：[列表]。把这个上下文应用到每一项任务。如果某件事不符合上下文，先指出来再继续。

→ 锁定你的写作声音：

我的写作风格：始终匹配这一点：[描述你的声音] / 句子长度：[偏好] / 我会使用的词：[例子] / 我绝不会使用的词：[例子] / 格式：[散文式或结构化]。当你代表我写任何内容时，必须精确匹配这个风格。不要默认使用你自己的模式。

每天重新解释上下文的时间：30 分钟。按开发者 150 美元/小时计算：75 美元/天。每周：每位开发者 375 美元。5 人团队：每周 1,875 美元。本部分 CLAUDE.md 设置总耗时：45 分钟。

要避免的错误：不要从零开始写你的 CLAUDE.md。先用下面这个提示词，再编辑输出结果：

根据我告诉你的关于我自己、我的项目以及我希望如何工作的内容：为我写一份完整的 CLAUDE.md 文件。包含：我是谁、我的技术上下文、我的沟通偏好，以及每个会话的默认行为。要具体。纯文本。500 词以内。

2 / 3 | 行为：你没有授权的 150 美元/小时变更

你让 Claude 修复一个函数。

它重构了三个文件，重命名了你的变量，重排了 import，并重写了你花时间打磨过的注释。

全都没有先问你。

花 1 小时审查并回滚不想要的变更：150 美元。每周发生三次：450 美元/周。每位开发者。

一个 5 人团队：每周花 2,250 美元清理没人授权的变更。

下面这 7 条规则放在 CLAUDE.md 的行为部分。

→ 保持在任务范围内：

只修改与当前任务直接相关的文件、函数和代码行。不要重构、重命名、重排、重新格式化，或“改进”任何我没有明确要求你修改的内容。如果你注意到其他地方值得修复，把它作为最后的备注提出。不要动它。永远不要。

→ 大改之前先询问：

在做任何会显著改变我已经创建的内容的修改之前（重写章节、删除段落、重组流程、改变语气）：停下来。准确说明你准备改什么，以及为什么要改。等我确认后再继续。

→ 任何破坏性操作前先确认：

在删除任何文件、覆盖现有代码、删除数据库记录或移除依赖之前：停下来。列出会受到影响的具体内容。要求我明确确认。只有在我当前消息中说“是”之后才继续。“你之前提过这件事”不算确认。

→ 生产环境的硬性停止规则：

以下操作无例外地需要当前会话中的明确确认：部署或推送到任何环境，运行迁移或 schema 变更，发送任何外部 API 调用，执行任何有不可逆副作用的命令。必须由我在当前消息中说“是”。

→ 始终展示改了什么：

完成任何编码任务后，结尾必须包含：改动的文件（列出每一个被触碰的文件）/ 修改内容（每个文件一行）/ 有意未触碰的文件 / 需要后续处理的事项。

→ 没有明确确认，绝不代我行动：

没有我在当前消息中的明确确认，不得代表我发送、发布、公开、分享或安排任何内容。这包括邮件、日历邀请、文档共享，或本对话之外的任何行动。我必须在当前消息中说“是”。

→ 写代码前先思考：

对于任何涉及架构决策、复杂问题调试或非平凡功能的任务：在写任何代码之前，先逐步梳理问题。展示你的推理。指出你不确定的地方。然后再实现。

每周花 1 小时回滚不想要的范围变更：150 美元/周。每周花 30 分钟在每个任务后手动做 diff：75 美元/周。每位开发者与行为相关的总浪费：225 美元/周。5 人团队：1,125 美元/周。CLAUDE.md 行为部分设置时间：30 分钟。

3 / 3 | 记忆 + 技术栈：让 Claude Code 真正可靠的设置

Claude 会忘记会话之间的一切。

你做过的每一个决定。每一种失败过的方法。六个月前你选择 Prisma 而不是 Drizzle 的原因。某个约束存在是因为特定客户需求。

它都会忘掉。然后它会再次建议你已经排除的选项。

这部分给了 Claude 目前最接近真正记忆的东西。它还会锁定你的技术栈，让它停止提出会破坏现有架构的工具。

→ MEMORY.md 决策日志：

在这个项目中维护一个名为 MEMORY.md 的文件。任何重要决策之后，添加一条记录：做出了什么决定 / 为什么 / 拒绝了什么以及为什么拒绝。每次会话开始时读取 MEMORY.md。除非先指出冲突，否则不得违背已经记录的决策。

→ 会话结束总结：

当我说“session end”、“wrapping up”或“let's stop here”时：把会话总结写入 MEMORY.md。包含：处理了什么 / 完成了什么 / 仍在进行什么 / 做出了哪些决策 / 下一次会话的优先事项。

→ ERRORS.md 失败日志：

维护一个名为 ERRORS.md 的文件。当某个方法尝试超过 2 次才成功时，记录下来：什么没有奏效 / 什么最终奏效 / 给下次的提示。在为类似任务建议方法前，先检查 ERRORS.md。

→ 永久事实列表：

以下事实对本项目始终成立。每次会话都无例外地应用它们：[你的永久约束、架构决策和规则]。如果任何任务与其中某条冲突，先指出冲突再继续。

→ 锁定技术栈：

本项目技术栈。始终使用这些。除非我要求，否则不要建议替代方案：
语言：[例如 TypeScript]
框架：[例如 Next.js 14]
包管理器：[例如 pnpm]
数据库：[例如 PostgreSQL with Prisma]
测试：[例如 Vitest]
样式：[例如 Tailwind CSS]
如果某个工具看起来不合适，指出来。但除非我明确说另选，否则使用已定义的技术栈。

→ 面向困难决策的 Extended Thinking：

对于涉及系统架构、性能权衡、数据库设计或长期技术决策的问题：使用 extended thinking mode。逐步分析问题。提出我可能没有考虑到的权衡。标出在规模扩大后可能不成立的假设。然后给出你的建议。

→ 走红的 4 条规则：

Karpathy 识别出 4 种会让 Claude Code 失效的行为。一位开发者把它们提炼成下面 4 行。编码准确率从 65% 提升到 94%。

1. 先问，不要假设。如果有任何不清楚的地方，在写一行代码之前先问。不要对意图、架构或需求做静默假设。

2. 先做最简单的方案。始终先实现能够工作的最简单方案。不要添加没有被明确要求的抽象或灵活性。

3. 不要触碰无关代码。如果某个文件或函数不是当前任务的直接组成部分，不要修改它，即便你觉得它可以被改进。

4. 明确标出不确定性。如果你对某个方法或技术细节没有把握，在继续之前说出来。没有确定性却表现得很自信，比承认知识缺口造成的破坏更大。

每周花 2 小时从遗忘决策和错误建议中恢复：每位开发者 300 美元/周。错误的技术栈建议和不兼容工具：75 美元/周。每位开发者与记忆相关的总浪费：375 美元/周。5 人团队：1,875 美元/周。MEMORY.md + ERRORS.md + 技术栈设置：20 分钟。

结论

完整账单如下。

每次会话重新解释上下文：375 美元/周。回滚未授权变更：225 美元/周。从遗忘决策中恢复：375 美元/周。每位开发者总浪费：975 美元/周。

5 人开发团队：4,875 美元/周。每年：253,500 美元。

CLAUDE.md 设置：总计 2 小时。仅 Karpathy 的 4 条规则：编码准确率从 65% 提升到 94%。

一个纯文本文件。21 条规则。两小时工作。

完成这些设置的开发者，使用的是这样一个版本的 Claude：它记得决策，保持在任务范围内，在破坏任何东西之前先确认，绝不会建议会破坏你架构的框架。

没有做这些设置的人，则每周花 975 美元重复解释自己。

P.S. 从 Karpathy 的 4 条规则开始。只用那 4 条。现在就把它们粘贴到项目根目录中一个名为 CLAUDE.md 的新文件里。只需要 2 分钟。之后每周增加其余规则，根据你发现缺少什么逐步补上。

在它被信息流淹没之前先收藏。如果这对你有用，分享给一个需要它的人。