为什么你需要 CLAUDE.md
每次打开新的 Claude 会话,它从零开始。
不知道你的名字。不知道你的工作。不知道你的偏好或你喜欢事情怎么做。
所以你花头几分钟重新解释一切。或者你不解释——Claude 给你完全不符合你实际工作方式的东西。
CLAUDE.md 永久修复这个问题。
这不是只给开发者的工具
写作者用它锁定自己的声音,让 Claude 永远不会听起来像别人。营销人员用它定义受众,让 Claude 停止写通用文案。研究者用它设定信息结构方式。企业主用它给 Claude 完整公司上下文,让每个输出符合他们的现实。
没有 CLAUDE.md——你每次会话从零开始。你重复自己。你纠正同样的错误。你第 100 次解释你的偏好。
CLAUDE.md 是你在任何严肃工作前应该设置的第一件事。
创建方法(2 分钟)
- 打开项目文件夹,创建新文件。命名为 "CLAUDE.md"——大写字母,无空格。
- 用任何文本编辑器打开——记事本、TextEdit、VS Code 都行。直接粘贴纯文本指令。
- 先放 3-4 条解决你最大痛点的指令。保存文件。
- Claude 每次在该文件夹打开会话时自动读取。无需设置。无需额外步骤。从第一条消息起就生效。
21 条完整规则
Part 1:Claude 如何与你沟通
1. 永远消除废话
Claude 的默认是每条响应都以"Great question!""Of course!""Certainly!""Absolutely!"开头——这些短语绝对什么都不加,每天浪费你的时间。
一条指令永久消除。每条响应直接以答案开头。没有热身。没有 helpfulness 的表演。只给你要求的——立刻。
2. 行动前总是展示选项
Claude 默认挑一个方案就跑。你让它重写一段,它改变了整篇的语气。你让它重组文档,它按完全不符合你思维方式的方式重组。
现在你要纠正一些你从没要求改变的东西。这条指令完全修复:任何重要任务前,Claude 展示 2-3 种可能的方法。你选择方向。后续正是你想要的。
3. 不知道时诚实说
Claude 会在承认不确定之前,给你一个自信、详细、完全错误的答案。它用听起来合理的信息填补空白——日期、统计、引用、事实——感觉真实但根本不是。
你用了这些信息,问题在最重要的时候后面才出现。这条指令永久改变行为。
4. 长度匹配实际需求
问 Claude 简单问题,它写四段。问复杂问题,它给你一个看起来完整但实际是骨架的东西。
两者都没用。响应长度应该匹配任务实际需求。
Part 2:Claude 的行为方式
5. 大改动前询问
你让 Claude 修复一段,它重写整个文档。你让它缩短某物,它移除了你实际需要的部分。
每次——你失去了不想失去的东西。
6. 专注于被问的事
让 Claude 修复一件事,它会"改进"另外五件——调整你的措辞、重组你的结构、重写你完全满意的句子。
现在你得翻遍所有东西才能找到实际改变了什么。
7. 总是告诉你改了什么
Claude 完成任务,你留下扫描输出试图搞清楚与之前有什么不同。
哪些部分变了?它删了什么?它加了什么你从没要求的东西?
8. 永远不要代你行动
随着 AI 工具越来越连接——你的邮件、日历、社交账号、文档——Claude 采取你并非完全意图的行动的风险随每个新集成增长。
发送消息。发布内容。安排某事。这些行动有真实后果,而且发生得很快。
Part 3:你的上下文
9. 告诉 Claude 你是谁、你知道什么
Claude 不知道你是专家还是初学者,创始人还是自由职业者,想要技术深度还是平实语言的人。
没有这些上下文——它猜。而且对错各半。
10. 给 Claude 你正在做什么的上下文
每次会话 Claude 开始都不知道你在做什么、为谁做、什么真正重要。
它给你通用输出,因为它别无选择。
11. 锁定你的声音和风格
Claude 有默认写作风格。还行。但也不是你的。
每次你用 Claude 写东西——你反正得编辑回你的声音。一次性定义你的声音,Claude 从初稿起就用它写。
Part 4:记忆和连续性
12. 让 Claude 维护记忆文件
Claude 会话之间忘记一切。每次对话完全重新开始。
但 Claude 能写文件——文件持久存在。
这条指令告诉 Claude 维护一个 MEMORY.md 文件,记录你们一起做的每个重要决定——决定了什么、为什么、拒绝了什么替代方案。
13. 会话结束总结——不再丢失进度
你关闭会话。两天后回来。你花 15 分钟读旧消息试图记住你在哪、完成了什么。
这完全可以避免的浪费,发生在几乎每个定期用 Claude 的人身上。
14. 记录什么没起作用——停止两次解决同一个问题
你试一个 prompt 方法。花四次尝试才得到可用的东西。三周后你带着类似任务回来,Claude 从完全相同的坏建议重新开始。
同样的试错。同样的浪费时间。从头再来。每次。
15. 给 Claude 一份永不改变的事实列表
每个项目都有永久事实——过去决定的约束、存在重要原因规则、关于你工作始终为真的东西,无论具体任务是什么。
没有这些——Claude 随意建议完全矛盾于你现实的东西。
Part 5:给开发者
16. 留在范围内——不碰没被问到的
让 Claude 修复一个 bug,它会重构三个文件、重命名你的变量、重组你的导入、"改进"你用了几个月的代码——全都不问。
有些改动破坏东西。有些引入微妙的差异,花几天才能追踪到。
17. 任何破坏性操作前确认
Claude Code 会删除文件、覆盖函数、删除数据库表——毫不犹豫——因为你告诉它这么做,即使你没完全意识到你在告诉它什么。
一条误读的指令,几小时的工作就完全消失,没有撤销。
18. 硬停止——没有许可永不发生的行动
部署到生产环境。在实时数据库上运行迁移。向外部服务发送 API 调用。
这些不是"小心"的情况。这些是全面停止。
19. 锁定你的技术栈
没有定义的技术栈——Claude 会建议它认为最流行的框架、它见过最多次的库、它默认的包管理器。
通常不是你用的,不是你们团队懂的,不兼容你已经构建的东西。
20. 总是精确显示改了什么
Claude 完成编码任务,你留下扫描输出试图搞清楚有什么不同。
哪些文件变了?它碰了别的什么吗?它留下了什么未完成?
21. Karpathy 的 4 条让 CLAUDE.md 爆火的规则
Andrej Karpathy——前 Tesla AI 总监、OpenAI 创始成员——识别了让 Claude Code 在编码任务上失败的 4 种具体行为。
一位开发者把它们提炼成 4 条指令。那个文件登上 GitHub Trending #1,编码准确率从 65% 提升到 94%。
- Ask, don't assume——如果不清楚,写一行代码前先问。永不静默假设。
- Simplest solution first——总是实现能工作的最简单的东西。不要添加没被要求的抽象。
- Don't touch unrelated code——如果文件不是当前任务的直接部分,不要修改它。永远。
- Flag uncertainty explicitly——如果对方法不自信,在继续前说出来。自信没有确定性造成的损害比承认缺口更大。
核心原则
CLAUDE.md 不只是开发者工具。
它是任何认真使用 Claude 的人都应该在第一次真正会话前设置的永久指令文件。
- 指令 1-4 修复 Claude 的沟通方式
- 指令 5-8 阻止它更改你没授权的东西
- 指令 9-11 给它上下文来产出符合你实际工作的输出
- 指令 12-15 给它目前最接近真实记忆的东西
- 指令 16-21 让 Claude Code 行为像精确工具而非不可预测的东西
创建文件。粘贴 3 条指令。随着使用添加更多。
输出质量的差异从第一次会话起就会立即且明显。