CLAUDE.md 是怎么工作的

CLAUDE.md 是你写给 Claude 的项目说明书。每次启动 Claude Code 在这个项目里都会自动加载这份文件，把里面的内容作为系统提示词的一部分，Claude 全程都看得到。论文项目里所有跨会话不能丢的约定都该写在这里。

CLAUDE.md 加载流程

硬盘上的 CLAUDE.md 文件

用户全局级

未触发

~/.claude/CLAUDE.md

# 我的全局偏好

- 图字体：中文用 Heiti TC

- commit 风格：用 Conventional Commits

项目根级

未触发

~/papers/pc-esg/CLAUDE.md

# 耐心资本 → ESG 项目

- 保护清单：耐心资本 / 稳定型机构投资者 / 关系型债权 ...

- 主测度：A2（代飞 2025），稳健性走 A1 / B2 / C

- 不要替我写正文 / 不要润色 / 不要降 AIGC

子目录级

未触发

~/papers/pc-esg/05_分析代码/CLAUDE.md

# 05_分析代码子目录

- do 文件按 do0–do10 编号

- stata-mcp 跑前必须切到本目录

系统提示词

（空，等待 CLAUDE.md 拼接）

对话历史

（还没开始对话）

启动前：文件躺在硬盘上

硬盘上已经有三份 CLAUDE.md，按目录层级分布。Claude Code 还没启动，对话历史和系统提示词都是空的。

1/6

为什么需要这份文件

Claude 的对话历史在会话结束时就没了。今天你跟它说清楚术语锁定、文件结构、引用风格，明天打开新会话它就什么都不记得，要从头说一遍。

CLAUDE.md 是把这种'每次都要说一遍的话'写一次定下来。每次启动会话，Claude Code 自动读取项目根目录下的 CLAUDE.md，把里面的所有内容塞进系统提示词。Claude 在这个项目的所有会话里都默认知道这些规则。

更重要的：CLAUDE.md 不受对话历史压缩影响。后期对话太长触发自动压缩时，前段对话会被压成摘要，但 CLAUDE.md 永远完整。这意味着会话再长，里面定下来的规则也不会丢。关键的约定写进 CLAUDE.md 比写在对话里靠谱得多。

它的加载机制

Claude Code 启动时按从根目录往上找的顺序，找所有路径上的 CLAUDE.md。比如你在 ~/papers/pc-esg/05_分析代码/ 启动，它会查 05_分析代码/CLAUDE.md、pc-esg/CLAUDE.md，然后到 ~/.claude/CLAUDE.md。找到的所有 CLAUDE.md 内容拼起来作为系统提示词。

拼接顺序：用户全局级（~/.claude/CLAUDE.md）→ 上级目录 → 项目根 → 子目录。后加载的会覆盖前面同名的约定。项目级 CLAUDE.md 优先级高于用户全局级。

层级机制让你能在不同层做不同的事。用户全局级写'我所有项目都用 Heiti TC 中文字体'；项目根级写'保护清单 14 词 + PC_A2 主测度 + 工作纪律 6 条'；子目录级写'05_分析代码下的所有 .do 文件按 do0–do10 编号'。

优先级 + 加载顺序

Layer	Path	Effect
用户全局级	~/.claude/CLAUDE.md	所有项目共享的默认行为偏好。比如图字体规则、提交消息风格、个人偏好
项目根级	~/papers/pc-esg/CLAUDE.md	这个实证项目专属的规则。保护清单 14 词、PC_A2 主测度、华证 ESG 0-1 标准化、工作纪律 6 条
子目录级	~/papers/pc-esg/05_分析代码/CLAUDE.md	只对这个子目录生效的规则。比如所有 .do 文件按 do0–do10 编号，stata-mcp 跑前必须 cd 进本目录

耐心资本 → ESG 项目的 CLAUDE.md 范本

下面是这个实证项目实际在用的 CLAUDE.md（节选）。每条规则都是'你跟 Claude 协作时不想再重复说的话'，你可以直接套用为自己项目的模板。

# CLAUDE.md

本文件为本项目的常驻上下文，每次会话由 Claude Code 自动加载。

## 一、研究方向

研究主题：耐心资本对企业 ESG 表现的影响及作用机制。
样本范围：中国沪深 A 股 2009–2023 年。
被解释变量主口径：华证 ESG 评级连续得分（0–1 标准化）。
核心解释变量主口径：A2（代飞 2025）= 稳定型股权 + 关系型债权。
机制变量主口径：MDA 版管理者短视主义（胡楠等 2021 词频法）。
融资约束变量：KZ 指数（项目无 WW 数据，用 KZ 替代，论文脚注披露）。

## 二、保护清单（禁止同义替换）

下列术语在所有文本输出中必须按原写法保留：
耐心资本 / 稳定型机构投资者 / 战略型机构投资者 / 交易型机构投资者 /
关系型债权 / 机构投资者异质性 / ESG 表现 / 漂绿 /
管理者短视主义 / 双元创新 / 新质生产力 / 全要素生产率 /
融资约束 / 两权分离率

## 三、写作纪律

- 学术中文，避免口语化（咱们 / 说白了 / 不难发现 等）
- 反 AI 腔：不用排比、空泛评价、列举式比喻、概括性升华
- 段落 4–8 句，不写空泛"小结段"
- 引用按 GB/T 7714，确定投稿后可改 APA / Chicago

## 四、工作纪律（强约束，AI 不得跳过）

1. 改文件前先确认方案——"改一下""整理一下"这类模糊指令，先说"改哪里、不改哪里"，待用户确认再动手
2. 改 .docx 前先 cp 创建带时间戳的备份
3. 跨文件改写或术语统一前先复读保护清单
4. 批量任务（≥ 30 条目）先在 3-5 个样本上试跑
5. 改动核心声明须先扫描全文联动位置，待用户确认
6. 交付前运行硬检查清单：术语 / 引用 / 数据 / 图表 / 交叉引用 / AIGC 自查

## 五、不要做的事

- 不要替我写正文段落或摘要
- 不要润色已写好的文字
- 不要批量修改 07_论文写作/ 下的文件，先生成审计报告，我决定后再动手
- 不要 commit 到 git——commit 我自己来

怎么写 CLAUDE.md

用直白的中文或英文写，像跟一个新来的研究助理交代规矩。避免抽象的指令（'按学术规范来'），具体写出来要求（'引用风格用 APA'）。

写完后启动 Claude Code 测一下：随便给它一句涉及项目约定的指令，看它的回应是否反映出 CLAUDE.md 里的规则。如果它忘了某条规则，往往是规则写得太抽象——补一个具体例子。

CLAUDE.md 随论文一起放进 git，让它跟项目其它内容一样有版本历史。换电脑、协作者克隆下来，CLAUDE.md 都跟着过去，新会话直接生效。

新手常见的几个坑

写得太长导致 Claude 抓不住重点

CLAUDE.md 控制在 200 行以内最好。超过这个量模型在系统提示词里要消化的内容就太多。把不那么关键的规则放进各章节自己的小 CLAUDE.md，主项目级保持精简。

规则之间互相冲突没察觉

如果你在某段写"全文统一被解释变量"，又在另一段写"按导师习惯用因变量"，Claude 会随机选一个执行。每条规则定好后逐条检查跟前面有没有冲突。

把临时记录写进 CLAUDE.md

CLAUDE.md 是长期生效的规则，不是会话级笔记。临时记录（"今天讨论了 X、下周做 Y"）应该写进 notes/ 下的某个文件。CLAUDE.md 写满会话流水会让 Claude 误以为这些都是当下要遵循的规则。

不更新过期规则

论文走到不同阶段规则会变。初稿阶段允许大改章节结构，定稿阶段就要锁定章节。规则过期了就改 CLAUDE.md，别留着旧规则让模型按陈旧的约定行事。