02 | Claude Code 工程化实战：过目不忘——记忆系统与 CLAUDE.md

Claude Code 工程化实战：过目不忘——记忆系统与 CLAUDE.md

声明：📝 作者：甜城瑞庄的核桃（ZMJ）
原创学习笔记，欢迎分享，但请保留作者信息及原文链接哦～

第2讲整理，深入探讨 Claude Code 的五层记忆架构、CLAUDE.md 的编写原则与最佳实践，帮助你告别 AI 的"失忆症"，构建稳定可靠的 AI 协作伙伴。

目录

1. AI 协作的"失忆症"问题
2. Claude Code 记忆系统工作原理
3. 五层记忆架构详解
4. 编写高效的 CLAUDE.md
5. CLAUDE.md 实战演练
6. Auto Memory 自动记忆
7. 总结与最佳实践

1. AI 协作的"失忆症"问题

1.1 典型场景一：技术栈重复说明

第一次对话：

你：帮我写一个用户登录接口 Claude：好的，这是一个基础的登录接口... （使用 Express + JavaScript） 你：我们项目用的是 Fastify 和 TypeScript Claude：好的，让我重新写...

第二次对话：

你：帮我写一个订单创建接口 Claude：好的，这是一个基础的订单接口... （又用 Express + JavaScript） 你：（崩溃）我们用 Fastify 和 TypeScript！

1.2 典型场景二：格式规范重复纠正

第一个项目：

你：帮我根据刚才的讨论做一套循环经济相关 PPT，给老板直接看 Claude：好的，这是一份图文并茂，有技术深度的 PPT... 你（看了 PPT）：内容挺好的，调一下格式，16:9，加 Speaker Notes Claude：好的...

第二个项目：

你：帮我根据项目进展，做一套知识图谱的 PPT，直接用于演示的标准 Claude：好的，这是一份根据你的项目制作的详细知识图谱 PPT... 你（看了 PPT）：16:9，加 Speaker Notes！

1.3 问题本质

"失忆症"的代价：

• ❌ 每次新对话都从零开始
• ❌ 技术栈、代码风格、团队规范需要反复说明
• ❌ 小项目还能忍，项目复杂时让人抓狂

根本原因：

• Claude 不记得你的项目用什么技术栈
• Claude 不知道你的代码风格是什么
• Claude 没有了解团队的规范和约定

1.4 解决方案：CLAUDE.md

CLAUDE.md 是一份给 Claude 的"项目入职手册"

Claude 每次开始对话时：

1. 自动阅读这份手册
2. 了解项目背景
3. 明确应该遵循的底层规则

就像给新员工的入职手册，他读完就知道公司的规矩。不同的是，Claude 每次对话都会重新"入职"—— 所以这份手册必须简洁有效。

2. Claude Code 记忆系统工作原理

2.1 记忆系统初始化流程

当你在项目目录启动 Claude Code 时：

用户启动 Claude Code ↓ 扫描记忆文件 ├─ /Library/Application Support/ClaudeCode/CLAUDE.md (企业级) ├─ ~/.claude/CLAUDE.md (用户级) ├─ ./CLAUDE.md (项目级) ├─ ./CLAUDE.local.md (本地级) └─ ./.claude/rules/*.md (条件规则) ↓ 加载到 System Prompt ↓ 开始对话（带着完整的项目上下文）

关键特点：

• 每次对话都会重新加载
• 按照优先级叠加（高层级可覆盖低层级）
• 形成完整的上下文基础

2.2 记忆系统与其他知识来源的对比

关键洞察：

CLAUDE.md 的内容会每次对话都加载，所以要精简。把"每次都需要"的内容放这里，把"偶尔需要"的内容放到 Skills 或文档里。

3. 五层记忆架构详解

Claude Code 支持五个层级的记忆，就像洋葱一样，从外到内，按层级结构组织：

企业策略级（外层） ↓ 用户级（个人偏好） ↓ 项目级（团队共享） ↓ 本地级（个人笔记） ↓ 规则目录（条件规则）（内层）

3.1 企业策略级记忆（Enterprise Level）

作用

组织范围内的指令，由 IT/DevOps 统一管理和部署。

适合内容

• 公司编码标准
• 安全策略
• 合规要求
• 禁止使用的库或模式

位置

示例

# 公司开发策略 ## 安全要求 - 禁止在代码中硬编码任何密钥或敏感信息 - 所有 API 调用必须使用 HTTPS - 用户输入必须经过验证和清理 ## 合规要求 - 所有日志必