你有没有这种体验:每次打开一个对话,都得先跟 Claude 交代一遍背景。
我是做民商事诉讼的律师,这是一个合同纠纷案件,我们代理被告,引用法条时请写明全文,不要只写"第X条",每次回答先给结论再给理由……
说了十遍,它还是每次都像第一次见面。
有没有办法,让 Claude 进工作区就知道你是谁、在做什么案子、想怎么干活?有。这就是 CLAUDE.md。
上期内容 法律人学Claude|第三期:让Claude更高效读懂你的文件 ,简要提了一下CLAUDE.md,这一期详细介绍一下,为什么你要重视 CLAUDE.md,怎么使用 CLAUDE.md 。
一、CLAUDE.md 是什么——给 AI 写一份入职手册
如果你们团队新来了一个实习助理。第一天上班,你递给他一份两页纸的《新人工具包》,其中有一个对团队的介绍:吕盈辉,主做刑事辩护、Web3法律服务,专注经济犯罪类案件;你在这里主要帮我整理材料、起草文书;引用法条时必须写全条文,不能只写条号;客户信息不许发给任何人……
读完这份说明,他就不需要你每次开口前都重新介绍背景了。
CLAUDE.md 的原理就是这样。每次你打开工作区,Claude 先找这个文件,从头读一遍,然后才开始和你对话。你把工作规则和案件背景写进去,它就按你的习惯来——不是真的记忆,是每次开工前读一遍备忘录。
文件放在哪里?案件文件夹的最顶层,文件名固定是 CLAUDE.md,大写,不能改。
二、步骤说明:写你的第一份 CLAUDE.md
第一步:创建文件
在 VSCode 里打开案件工作区,左侧文件栏空白区域右键,选「新建文件」,输入 CLAUDE.md,回车。
第二步:手写还是让 Claude 生成?
两条路都行。
路线 A:用 /init 自动生成。 对话框里输入 /init ,Claude 扫描整个工作区,自动生成一份草稿,列出它观察到的文件结构和基本规则。草稿是起点,不是终点——打开之后把案件背景补进去。
路线 B:直接手写。 新案件材料还没整理好的时候,/init 扫不到什么有用的东西。参考下面的模板直接填,反而快。
第三步:填写四个板块
没有固定格式,用自然语言写就行,像写工作备忘录一样。四块内容:
① 你是谁
律师姓名、律所名称、主要执业方向,代理的谁。这决定 Claude 起草文书时知道你的角色,知道你是站哪边。
② 当前案件背景(脱敏后)
案件性质、案件编号(用虚构编号就行)、当事人称谓(用化名)、代理哪方。不要写真实姓名和身份证号,即便是本地文件,脱敏是对当事人也是对自己的保护。
③ 工作规则
直接影响输出质量的部分。比如: - 引用法条必须写条文全称和全文 - 每次先写结论,再写理由 - 不要用"综上所述""不言而喻"这类套话 - 内容只供本地分析,不得联网
④ 输出偏好
正式文书用书面语,日常分析可以口语化一些;结论加粗;能用表格的不用长段落。
如果大家想要这份基本工作手册 CLAUDE.md文件,可以后台找我要一下。
第四步:保存,下次生效
Command+S(Windows 是 Ctrl+S)保存。下次新开对话窗口,Claude 自动读取最新版本。
三、有没有 CLAUDE.md,差距有多大
案件背景 :张某起诉李某要求履行买卖合同,标的 80 万元。你代理被告李某。
没有 CLAUDE.md 时 ,问 Claude:"帮我写一份答辩状框架。"
得到的大概是这样:
答辩状 答辩人:XXX 被答辩人:XXX 答辩意见如下:首先……其次……最后……综上所述,请求法院驳回原告全部诉讼请求。
通用模板,跟你的案件没有半点关联。法条只写了"《民法典》第XXX条",一个字的内容都没有。
配置了 CLAUDE.md 之后 ,同样的问题,输出变成:
本案代理被告李某(化名),针对原告张某买卖合同履行的诉讼请求,答辩框架建议如下: 一、合同效力问题 :…… 二、履行义务的认定 :…… 《中华人民共和国民法典》第五百七十七条:"当事人一方不履行合同义务或者履行合同义务不符合约定的,应当承担继续履行、采取补救措施或者赔偿损失等违约责任。"
知道你代理哪方,知道引全法条,知道先结论后理由,知道不写套话。这就是 CLAUDE.md 干的事—— 不是让它变聪明,是让它一开始就对齐你的工作方式 。
还有一点。Claude 读取 CLAUDE.md 时,越靠近你当前工作区的内容,执行得越认真。全局规则是底色,项目规则是重点。要它严格遵守的指令,写在项目级 CLAUDE.md 里比写进全局文件更管用——距离越近,Claude 越"上心"。
四、进阶技巧
一个案件一个工作区,各有各的 CLAUDE.md。
别把多个案件混在同一个文件夹里。每个案件单独建工作区,Claude 就不会把甲案的当事人认成乙案的被告。
在 CLAUDE.md 里设安全边界。
写进去:" 未经授权,不得自行修改任何文件,只能给我提建议。 "这样 Claude 不会在你没留意的时候替你改了文书原件。给助理设定权限——可以提意见,不可以直接改档案。
全局 CLAUDE.md 和项目 CLAUDE.md 可以同时用。
有些规则每个案件都要用,比如引法条的格式、禁止写套话。把这些写进 ~/.claude/CLAUDE.md,就不用每个案件文件夹都复制一遍。
~/ 是 Mac 和 Windows 里的通用简写,意思是当前用户的主文件夹。
Mac 上通常是 /Users/你的用户名/ ,Windows 上是 C:\Users\你的用户名\ 。
所以 ~/.claude/CLAUDE.md 的意思是:你的主文件夹里有一个叫 .claude 的隐藏文件夹,全局 CLAUDE.md 就放在里面。
Claude Code 启动任何工作区时,都会先来这里读一遍。
项目级的 CLAUDE.md 里只放这个案件特有的内容,两份同时生效,项目级优先级更高。通用规则在全局,特殊规则在项目,不需要重复写。
五、常见问题
Q:CLAUDE.md 写多长合适?
A: 两三千字的量就已经很多了,精炼是最好的,多反而出问题——Claude 能处理的内容有限,塞进去的东西越多,每一条被认真执行的概率越低。把最重要的规则写清楚,其他的删掉。
Q:可以把真实当事人姓名写进去吗?
A: 建议不要。CLAUDE.md 是本地文件没错,但脱敏是基本职业习惯。化名加虚构案号完全够用。 可以做好实名和真名的映射,用工具进行后期还原。
Q:我改了 CLAUDE.md,什么时候生效?
A: 保存之后,下次新开对话窗口或者重启VSCode就可以用新版本。当前已开着的对话不会更新——开个新对话就好。
Q:/init 生成的都是技术内容,跟办案没关系,怎么处理?
A: /init 本来是给程序员用的,扫出来的确实主要是代码信息,和文件框架。法律人用的话,把生成的内容清掉,按四个板块重新手写。也可以让 Claude 帮你写:把案件基本信息告诉它,让它生成一份草稿,你再改一遍。
Q:CLAUDE.md 能保护客户信息安全吗?
A: 不能。它只影响 Claude 的行为方式,不是安全措施。真正的信息安全靠文件加密和访问控制,该加密加密,该设权限设权限,该脱敏脱敏,这跟 CLAUDE.md 写什么没关系。
往期回顾
法律人学Claude|第一期:桌面版已经很好用了,为什么我还是力推 VSCode 插件版?
法律人学Claude|第二期:半小时装好 VSCode + Claude Code
法律人学Claude|第三期:让Claude更高效读懂你的文件
对了,我建了一个交流群,有想 进群 的伙伴可以 加我 。