2分钟搞定CLAUDE.md,每周省你5小时
为什么你每次跟AI聊天都像第一次见面
你打开Claude,想改一段文字。你打字:“帮我润色一下第二段。” Claude回你:“好的!很高兴为您服务!当然可以!这是一个很棒的问题!” 你等了五秒钟,才看到正文。然后它把你整篇文章重写了,语气像新闻联播,还加了你没要的总结。你又花十分钟改回去。
这不是你的错。是你没给Claude发“员工手册”。
今天我说的这个东西,叫CLAUDE.md。就是个纯文本文件,跟便签一样简单。但一个类似的配置文件,前几天在GitHub上冲到了热榜第一,8万2千颗星,七千八百人复制。那些复制了的人,其实也不知道该往里面写啥。
结果就是,你每次打开Claude,它都像一条刚开机的人工鱼,不知道你是谁,不知道你在干啥项目,不知道你喜欢长句子还是短句子,更不知道你讨厌“首先其次再次”那种八股文。所以你每次会话的前五分钟,都在做同一件事:“不是,我不是这个意思,我是说……”
今天我就把那个配置文件里真正有用的21条指令,翻译成人话。你挑三四条先贴上,两分钟设置完,以后Claude就像跟了你三年的老助理。
建这个文件比泡面还简单
先别管那些指令具体是啥,咱先把“员工手册”放对地方。
打开你放项目文件的文件夹,就是你有工作文档那个地方。新建一个文件,名字必须叫“CLAUDE.md”,注意全部大写,别加空格,后缀是点md。你电脑上的记事本就能打开它,不用下载任何专业软件。
然后把下面你喜欢的指令复制进去,贴成纯文本就行。不需要从21条全贴,你最大的三个痛点,比如Claude废话多、乱改东西、记不住你名字,就先贴对应的三句。保存文件,关掉。下次你在这个文件夹里打开Claude Code或者任何支持Claude的项目,它第一件事就是读这个文件。
以后你再问它问题,它就不再是那个啥也不懂的新员工了。
接下来这21条,我按“说话方式、行为规矩、你是谁、记忆系统、程序员专用”五个阶段给你拆开。前一章告诉你为啥要改这个毛病,下一章就给你具体贴啥指令。
第一阶段:先治治Claude爱说废话的毛病
你每次问个简单问题,Claude先给你表演一段礼貌用语马拉松。“当然!没问题!这是一个很好的问题!” 你心里想:大哥,我问现在几点,你直接说八点半就行,不用先感谢我问了一个如此优秀的时间问题。
这条指令就是拔掉它的客套话开关。你贴进去以后,它再开口就是答案本身,没有热身,没有表演,没有“我很乐意帮助你”。
贴这个:
永远不要用“很好的问题!”“当然!”“没问题!”“当然可以!”“绝对可以!”“好的!”这类废话开头。 |
另外还有个毛病,你让它写个东西,长度永远不对。你问个简单的是非题,它给你写四段论文。你让它写个复杂分析,它给你列三条要点,每条就一行,深度跟没写一样。
这就像你去餐馆,说“来个炒饭”,他给你端一桌满汉全席。你说“我想吃顿好的招待贵宾”,他给你上个馒头配榨菜。这谁受得了。
所以再加一条,让它的回复长度跟任务难度挂钩。
贴这个:
回复长度必须匹配任务的复杂程度。 |
这两条贴完,Claude的废话至少砍掉一半。接下来它还有个隐藏技能:不懂装懂。
第二阶段:治它不懂装懂和乱改东西的毛病
Claude有个坏习惯,它宁愿给你一个听起来很自信、但实际上全是编造的答案,也不肯说“我不确定”。它会把缺失的数据、不存在的研究、张冠李戴的名人名言,包装得跟真的似的。你用的时候根本看不出来,等出了问题才发现,引用的那句话是它现编的。
这就像你问路,对方明明不知道,却给你指了一条特别详细但完全不存在的路。你还谢谢人家。
所以必须加这条。让它把“我不确定”当成一种荣誉,而不是失败。
贴这个:
如果你对任何事实、统计数据、日期、引用或者信息不确定,在说出来之前先明确告诉我。 |
说完不懂装懂,再说它另一个更烦人的毛病:你让它改一段话,它把你整篇文章重写了。你让它把第二段的语气从正式改成轻松,它顺便把第一段的结构拆了,第三段的例子换了,第四段的结尾删了。你看着那个新版,完全不知道它到底动了哪些地方。
你这会儿的心情,就像你让室友帮忙热一下剩菜,他把整个厨房重新装修了,还告诉你“我觉得这样更好”。好你个头啊。
所以必须用这条指令给它画个圈。只许动你指名道姓要改的东西,其他地方,看都不许看。
贴这个:
只改我明确要求你改的内容。 |
改完了还有一个坑。它不告诉你它改了啥。你拿回文档,得自己一个字一个字对比。哪个句子不见了?哪个段落换了位置?它是不是偷偷加了一段你没要的内容?每次都得手动做一遍找不同游戏。
这就像你把车送去保养,修理工说“弄好了”,但不告诉你换了哪几个零件。你得自己打开引擎盖,跟之前拍的照片一一比对。
所以再加一条,让它每次改完必须交作业:一份极简版改动清单。
贴这个:
完成任何编辑或写作任务后,末尾一定要加一段简短总结: |
好了,现在Claude说话直接了、长度匹配了、不懂不装了、不乱改东西了、改完还交清单了。但还有一个最大的问题你没解决:它根本不了解你。
第三阶段:告诉Claude你是谁、在干啥、喜欢什么语气
你每次打开Claude,它都不知道你是不是专家。它不知道你是写代码的程序员还是写文案的市场人员,不知道你想要技术深度还是大白话。所以它只能猜。猜你是个平均水平的普通人。结果就是,有时候它解释你已经懂了十年的基础概念,啰嗦得你头疼。有时候它跳过你真正需要的背景知识,给你一个根本用不了的答案。
这就像你去理发店,理发师不问你想剪什么样,直接按他觉得帅的款式给你推。你戴上眼镜一看,哭都来不及。
三行话就能解决。在CLAUDE.md里写一段“关于我”。它以后就按照这个背景来调整回复深度。
贴这个:
关于我: |
光知道你是谁还不够,它还不知道你当下这个项目是干啥的。是为内部会议写备忘录,还是为客户写推广邮件?语气要正式得像法律文件,还是轻松得像朋友聊天?受众是五十岁的传统行业老板,还是二十岁的游戏玩家?
不告诉它这些,它给你的永远是万金油式的通用内容。放在哪儿都能用,放哪儿都不好使。
再加一段“当前项目”的背景。
贴这个:
我当前在做的项目: |
最后一块拼图是你的个人文风。Claude有自己的默认写作风格。不烂,但也不是你的。它喜欢用某些固定词组,句子节奏有它的习惯,那个感觉就像你借了别人的衣服穿。每次你都得自己动手把衣服改回你的尺码。
把你的文风写成配方。它就能从第一稿开始,穿你的衣服,说你的话。
贴这个:
我的写作风格,每次都严格匹配: |
现在Claude知道了你是谁、在干什么项目、用什么语气写。但它还有个致命缺陷:再过五分钟你关掉这个窗口,明天再打开,它把今天聊的一切全忘了。
第四阶段:给Claude装上最笨但管用的记忆
Claude跟人一样,关上会话窗口就等于睡了一觉失忆了。明天你问它同样的问题,它又从头开始。但Claude有个能力:它可以读写你电脑上的文件。文件不会失忆。
所以你让它自己维护一个叫MEMORY.md的文件。每次你们做了一个重要决定,比如“这个报告用表格不用图表”、“这段代码用这个库不用那个库”,它就记下来。每次会话开始,它先读这个文件。这样它就知道三个月前你为啥否掉那个方案,不会傻乎乎再给你推荐一遍。
这就像给一个健忘的同事配了个笔记本。你不在的时候他自己翻笔记。
贴这条:
维护一个叫MEMORY.md的文件。每次做完重要决定(关于方向、格式、内容、方法、策略),就加一条:
##[日期],[决定内容] |
另外,每次你关会话之前,得让它写个今天的进度总结。不然明天你回来,得花十五分钟翻聊天记录,找上次聊到哪儿了。这条指令让它在你说“今天就到这”的时候,自动在MEMORY.md里写一段会议纪要。
贴这个:
当我说“会话结束”、“今天就到这”或者“先这样吧”,在MEMORY.md里写一条会话总结: |
还有一件事。你试过很多方法,有的是坑。比如让Claude用某种方式写周报,试了四次才找到一个能用的模板。三个星期后你又写周报,它又从那个最蠢的方法开始试。你又把同样的坑踩一遍。
这不能忍。建一个ERRORS.md文件,专门记什么方法不行、什么方法最后行了。以后它先查这个文件,直接跳到你验证过的正确方法,不再重新踩一遍狗屎。
贴这条:
维护一个叫ERRORS.md的文件。当某个方法尝试了两次以上才成功,就记下来: |
最后,你还有一些永远不变的事实。比如“我的读者没有技术背景”、“所有内容必须适合工作场合”、“我们是卖儿童玩具的,永远不要用消极词汇”。这些事Claude不知道,会不断给你推荐违反这些铁律的方案。
单独列一块“永远不变的事实”。它就永远在这个框架里干活。
贴这条:
下面这些事实永远成立。每次会话、每个任务都要遵守,没例外: |
好了,以上十五条,不写代码的人完全够用。但如果你是程序员,要用Claude Code改代码,下面六条是救命级别的。一条都不能少。
第五阶段:程序员专用,防止Claude把你的代码库炸了
程序员用Claude Code,那是直接在终端里跑,它能直接动你的文件系统、删文件、改函数、甚至删数据库。你让它“修一下登录页面的按钮bug”,它能顺手重构三个文件、重命名你的变量、调整import顺序、把你好几个月没动的老代码“优化”一遍。有的优化确实好了,但更多时候它改完,你的代码跑不起来了,或者出现一个微妙bug,你找两天都找不到是哪儿改坏了。
第一条规矩:管住它的手,只允许碰当前任务直接相关的代码。
贴这条:
只修改跟当前任务直接、具体相关的文件、函数和代码行。 |
第二条规矩:会删东西的操作,必须二次确认。Claude不会问你“真的吗”,它认为你说了就是真的。有时候你也没完全搞明白自己说了啥,比如你说“删掉测试数据”,它就把整个测试数据库给drop了。
把每个破坏性操作都变成一个确认点。
贴这条:
在删除任何文件、覆盖已有代码、删除数据库记录、移除依赖、或者做任何不能轻松撤销的改动之前,必须完全停下来。 |
第三条规矩:有些事永远不能自己干,比如部署到线上环境、在正式数据库上跑迁移、发API请求到外部服务。这些不是“小心点”就行的,是必须你亲自在场、亲自按按钮。
贴这条:
下面这些操作必须在当前会话里明确确认后才能执行,没例外: |
第四条规矩:锁死技术栈。你不告诉它你用啥框架,它就给你推荐它觉得最火的。有时候你用的是Vue,它给你生成React代码。你用的是npm,它给你yarn的命令。
说清楚你用啥,它就不再乱推荐。
贴这条:
技术栈,永远用这些,除非我问,否则别推荐替代品: |
第五条规矩:改完代码必须告诉改动了哪些文件。不然你又得手动对比几百行代码。
贴这条:
完成任何代码任务后,末尾必须加上: |
第六条规矩:这四个小规则,就是让Andrej Karpathy那个配置文件冲上GitHub热榜第一的核心。他是特斯拉前AI总监、OpenAI创始成员。有人把他的四个行为准则提炼成四行指令,加进CLAUDE.md后,代码准确率从65%涨到了94%。
把这四条也贴上。
贴这条:
1. 问,别猜。如果不清楚或者信息不全,写一行代码之前先问。永远不要默默假设意图、结构或者需求。 |
结尾:花两分钟省几百小时
CLAUDE.md不是程序员的专属工具。它是任何一个认真用Claude的人,在第一次正经干活之前就该设好的员工手册。
前四条治它怎么说话。
第五到第八条治它乱改东西。
第九到十一条给它你的背景和文风。
第十二到十五条给它最接近记忆的东西。
第十六到二十一条给程序员,把Claude Code从一个不可控的疯子变成一个精准的工具。
建一个文件,贴三条你最烦的痛点对应的指令。用起来。下周再加两条。两个月后你会回来谢我。
现在就去建那个叫CLAUDE.md的文件吧,两分钟的事。你浪费在重复解释上的那几百个小时,值得这两分钟。