Harry Yu

Claude Code Memory 与 CLAUDE.md 配置指南

Claude Code
目录

一、Memory 系统

1.1 存放位置

C:\Users\y\.claude\projects\C--Users-y\memory\

1.2 文件结构

文件加载方式行数限制用途
MEMORY.md自动加载200行后截断核心记忆，每次会话自动读取
主题文件（*.md）手动加载无限制详细知识库，按需读取

image-20260316211326454

1.3 加载机制

新会话启动
    ↓
自动加载 MEMORY.md
    ↓
超过200行内容被截断
    ↓
主题文件需手动用 Read 工具读取

1.4 更新原则

会保存的内容：

  • 稳定的模式和约定（经过多次交互确认）
  • 关键架构决策、重要文件路径
  • 用户偏好（工作流、工具、沟通风格）
  • 问题解决方案和调试心得

不会保存的内容：

  • 会话特定的上下文（当前任务、临时状态）
  • 未经验证的推测
  • 与 CLAUDE.md 重复的内容

二、CLAUDE.md 配置层级

2.1 优先级结构（从高到低）

┌─────────────────────────────────────────────────────────┐
│  1. 项目根目录 CLAUDE.md                                 │
│     位置: <项目根目录>\CLAUDE.md                          │
│     作用: 覆盖全局配置，项目特定规则                        │
├─────────────────────────────────────────────────────────┤
│  2. 子目录 .claude/CLAUDE.md                             │
│     位置: <项目>\.claude\CLAUDE.md                        │
│     作用: 子目录或模块特定配置                             │
├─────────────────────────────────────────────────────────┤
│  3. 全局 CLAUDE.md                               │
│     位置: C:\Users\y\.claude\CLAUDE.md                    │
│     作用: 所有项目的默认配置                                │
└─────────────────────────────────────────────────────────┘

2.2 优先级规则表

优先级位置覆盖关系
1（最高）项目根目录 CLAUDE.md覆盖全局配置
2.claude\CLAUDE.md补充项目配置
3（最低）~\.claude\CLAUDE.md默认配置

三、完整加载顺序与优先级

3.1 会话启动加载顺序

1. 系统默认指令
    ↓
2. 全局 CLAUDE.md（~\.claude\CLAUDE.md）
    ↓
3. 项目 CLAUDE.md（项目根目录）
    ↓
4. MEMORY.md（~\.claude\projects\...\memory\MEMORY.md）
    ↓
5. 用户当前消息

3.2 冲突处理规则

场景处理方式
用户指令 vs 配置文件用户指令优先
项目 CLAUDE.md vs 全局 CLAUDE.md项目配置覆盖全局
CLAUDE.md vs MEMORY.mdCLAUDE.md 优先（项目当前上下文）
MEMORY.md 超过200行自动截断后续内容

四、目录结构总览

C:\Users\y\
├── .claude\
│   ├── CLAUDE.md              # 全局配置（所有项目默认）
│   └── projects\
│       └── C--Users-y\        # 当前项目记忆目录
│           └── memory\
│               ├── MEMORY.md  # 主记忆（自动加载，200行截断）
│               ├── debugging.md    # 主题文件（手动加载）
│               ├── patterns.md     # 主题文件（手动加载）
│               ├── conventions.md  # 主题文件（手动加载）
│               └── ...             # 其他主题文件
│
└── <当前工作目录>\
    ├── CLAUDE.md              # 项目配置（优先级最高）
    └── .claude\
        └── CLAUDE.md          # 子目录配置

五、主题文件管理

5.1 常见主题文件示例

文件名用途
debugging.md调试经验和解决方案
patterns.md代码模式和架构模式
conventions.md编码规范和约定
api.mdAPI 使用记录
database.md数据库相关知识

5.2 主题文件特点

特性说明
存放位置~\.claude\projects\<项目标识>\memory\
加载方式手动 - 需要时用 Read 工具读取
大小限制无限制
命名建议按主题命名，英文小写

5.3 MEMORY.md 与主题文件的协作

MEMORY.md（简洁）
    ├── 详见 debugging.md → 详细调试经验
    ├── 详见 patterns.md → 详细模式记录
    └── 详见 api.md → 详细API文档

六、实用建议

6.1 配置文件分工

用途推荐位置
项目特定规则项目根目录 CLAUDE.md
通用偏好~\.claude\CLAUDE.md
详细知识库memory\主题文件.md
快速参考memory\MEMORY.md（保持简洁）

6.2 MEMORY.md 维护建议

  1. 保持简洁：超过200行会被截断，核心信息放前面
  2. 定期清理：删除过时或错误的记忆
  3. 链接主题：详细内容放入主题文件，MEMORY.md 中链接引用
  4. 验证后写入：只保存经过多次确认的稳定模式

6.3 主题文件维护建议

  1. 按主题分类：不同知识领域分文件存放
  2. 无大小限制：可以详细记录
  3. 主动读取：需要时告诉 Claude 读取对应文件
  4. 交叉引用：文件间可以相互引用

七、快速参考

更新记忆的操作流程

收集信息 → 写入/编辑文件 → 保持 MEMORY.md 简洁

更新时使用的工具

操作工具说明
创建新记忆Write写新文件或覆盖现有文件
修改已有记忆Edit先 Read 再 Edit
删除过时记忆Edit 或 Write移除错误或过时内容

附录：文件路径速查

类型路径
全局 CLAUDE.mdC:\Users\y\.claude\CLAUDE.md
项目 CLAUDE.md<项目根目录>\CLAUDE.md
Memory 目录C:\Users\y\.claude\projects\C--Users-y\memory\
MEMORY.mdC:\Users\y\.claude\projects\C--Users-y\memory\MEMORY.md
主题文件C:\Users\y\.claude\projects\C--Users-y\memory\<主题>.md