claude Memory

● 下面这份可以当作你写 CLAUDE.md / .claude/rules / CLAUDE.local.md 时的速查表，重点是：

- 7 层 memory 层级（谁优先）
- 每层典型内容
- 你在文件系统里大概会改到哪些位置

---
一、整体层级结构（从高到低）

[1] Managed Policy ← 最高，管理员/企业策略
[2] Project Memory
[3] Project Rules ← 项目内的 CLAUDE.md / .claude/rules
[4] User Memory
[5] User Rules ← 用户全局配置（~/.claude/CLAUDE.md 等）
[6] Local Project Memory ← 当前项目的个人偏好（CLAUDE.local.md）
[7] Auto Memory ← 自动记忆（MEMORY.md 等）

规则：上层永远压下层，低优先级不能覆盖高优先级。

---
二、分层速查表

▎ 只在“你通常会接触到”的层级上写路径；Managed Policy/Auto Memory 的内部实现路径就不细抠了，用概念就够。

1. 管理员 / 企业层

---
2–3. 项目层（项目一起遵守的）

 

Project Rules：你常做的事

1. 项目根的 CLAUDE.md
- 描述 tech stack、测试要求、部署流程等。
- 可以用 @docs/... 拆分 import（注意最多嵌套 5 层）。
2. .claude/rules/*.md（路径作用域规则）
- 用 frontmatter 限制生效范围，例如只对 src/api/** 有效：

---
paths:
- src/api/**
---

# API 区域专用规则
- 所有 handler 必须返回标准化错误结构 …
- 用来细分“按目录生效的规则”，比在每个子目录塞一个 CLAUDE.md 更可维护。

---
4–5. 用户全局层（跨项目对你个人生效）

 

User 相关你要记住一件事：

- ~/.claude/CLAUDE.md 是全局的，对你所有项目都生效，优先级高于项目本地的
CLAUDE.local.md，但仍然不能覆盖项目层（Project Memory / Project Rules）。

---
6. 当前项目的“个人私有层”

 

典型用法：

- CLAUDE.local.md（项目根）：

---
# 个人对这个仓库的偏好，不提交
---

- 回答时默认用中文
- 解释代码时优先展示测试文件路径
- 这层只影响你本机的这个项目，团队其他人不会看到，也不会进仓库。

---
7. Auto Memory（自动记忆）

 

关键点：

- Auto Memory 会为每个项目维护一个 MEMORY.md：
- 记录“这个项目常见的操作习惯、历史上下文”等。
- 会话开始时，只加载 MEMORY.md 的前 200 行作为索引/摘要。
- 不能用 Auto Memory 推翻上面的任何一层规则。

---
三、你实际写配置时的“文件视角”备忘

1. 项目公共配置（团队一起用）

project-root/
CLAUDE.md # Project Rules / 部分 Project Memory
.claude/
rules/
api-rules.md # 加 paths: src/api/** 之类的路径作用域
frontend-rules.md
... # 其他 project 级资源

- 用来写：技术栈、API 标准、测试要求、部署策略、不同目录的专用规则等。
- 生效顺序：先看 Managed Policy / Project Memory，然后是这里的规则。

2. 项目个人配置（只影响你，在本项目）

project-root/
CLAUDE.local.md # Local Project Memory（通常被 git 忽略）

- 写你个人在这个仓库的习惯：
- 语言偏好、回答风格、
- 是否默认要求给出某种类型的输出等。
- 不想污染团队配置，就写这里。

3. 用户全局配置（所有项目通用）

~/.claude/
CLAUDE.md # User Rules / User Memory（全局）
... # 其他全局 memory/rules 文件

- 用来写：
- 你作为“某种角色”（后端/前端/架构师）的一些固定偏好；
- 比如“默认用中文回答”、“尽量给出命令行示例”等对所有项目都适用的东西。

---
四、优先级口诀（方便记）

- 谁能压谁：

Managed Policy
> Project Memory
> Project Rules
> User Memory
> User Rules
> Local Project Memory
> Auto Memory

- 可以这样记：

▎ “管理策略 > 项目内容 > 用户（全局）> 项目本地 > 自动记忆”

当你写配置时，只要记住：

1. 项目公共规则 → CLAUDE.md + .claude/rules/*.md（Project Rules）
2. 当前项目的个人偏好 → CLAUDE.local.md（Local Project Memory）
3. 所有项目通用的个人习惯 → ~/.claude/CLAUDE.md（User Rules/User Memory）
4. 任何时候都不要期望“更低层”的文件能推翻更高层（比如用 Auto Memory 去反驳 Managed Policy）——它做不到。