一、什么是 CLAUDE.md
CLAUDE.md 是 Claude 每次启动会话时自动读取的说明文件。你把项目背景、工作规范、个人偏好写在里面，Claude 就不再需要你每次重复交代。
它分两个层级，解决不同的问题：
Project 级
文件路径：./CLAUDE.md（项目根目录）。记录这个项目是什么、怎么运转、有什么规矩。团队成员通过 Git 共享同一份，保证所有人的 Claude 遵循同样的规范。
# 项目名称
简要描述这个项目做什么、给谁用。
## 背景信息
- 核心工具和工作方式
- 文件组织结构
## 工作规范
- 文件命名：小写加连字符
- 文档语言：中文
- 每次修改前备份原文件User 级
文件路径：~/.claude/CLAUDE.md（个人目录）。记录你的通用偏好——回复语言、提交格式、工作习惯。所有项目都会加载，换项目也带着走。User 级的详细用法会在正式课程中展开。
两层同时加载、内容叠加。冲突时 Project 级优先。
二、为什么需要它
没有 CLAUDE.md： 让 Claude 帮写论文的讨论部分，它不知道你的研究领域、引用格式、术语习惯。写出来像一篇科普文章——用词太泛、没有学科特征、引用格式和你已有的段落不统一。每次都要先花时间解释"我是做 XX 方向的，用 APA 格式，这几个术语要用英文原文"。
有了 CLAUDE.md： 写明研究方向、引用格式、术语规范、写作风格偏好。之后不管是写讨论、改摘要还是润色段落，Claude 的输出直接对得上你论文的调性。
三、怎么创建
Project 级
大多数人用 /init 自动生成就够了，之后再根据实际情况手动调整。
在项目目录下启动 Claude Code，运行 /init。Claude 会扫描项目结构自动生成一份 CLAUDE.md。生成后根据实际情况调整——补上 Claude 猜不到的内部规范，删掉不相关的条目。
在项目根目录手动创建 CLAUDE.md 文件，可以从这个模板开始：
# 项目名称
简要说明这个项目是什么、目标是什么。
## 工作规范
- 规范 1（如：所有文档使用中文）
- 规范 2（如：文件命名用小写加连字符）
- 规范 3（如：每次修改前先备份原文件）
## 项目结构
- `data/` — 原始数据
- `output/` — 产出文件
- `references/` — 参考资料指令越具体越好——写"所有表格使用中文列名"就比写"注意格式"有用得多。
User 级
手动创建 ~/.claude/CLAUDE.md，写入你对 Claude 的核心准则——比如回复语言、协作范式、通用工作习惯。这不是模板能解决的，需要结合实际使用经验逐步完善。
课程提供了一套经过实战验证的 User 级深度配置，核心思路是让主 Agent 作为领导者负责规划和判断，SubAgent 作为执行者并行完成具体任务——这套范式在复杂项目中效果显著。你可以直接参考或在此基础上调整：User 级深度配置 →
CLAUDE.md 支持用 @path/to/file 语法导入外部文件。内容膨胀后可以按主题拆分成多个文件，在主文件中用 @ 导入，保持结构清晰。