12
21
CLAUDE.md和MEMORY.md
2026-05-02 17:05:14
0点赞
0收藏
0评论
很多人用 Claude Code 写了上百篇文章，但99%的人从来没搞清楚一个最基本的问题：
CLAUDE.md 和 MEMORY.md 到底有什么区别？
今天用一张表、一个比喻，彻底讲清楚。
一、一张表看懂
项目根目录的 CLAUDE.md
~/.claude/projects/xxx/memory/MEMORY.md放在哪
项目根目录（跟着代码走）
Claude Code 内部目录（跟着工具走）
谁来写你手写
或 /init 生成
Claude Code 自动生成
给谁用
给 Claude 看
给 Claude 记
作用
告诉 Claude 这个项目是什么、怎么构建、有哪些规范
记住 Claude 在做这个项目时学到的东西
类比
项目的说明书
Claude 的笔记本
二、打个比方你就懂了
想象你是一家公司的老板，Claude 是你新招的员工。
CLAUDE.md = 《员工手册》
你交给新员工的第一天，告诉他：
公司做什么的（项目是干嘛的）
办公室在哪（目录结构怎么分）
着装要求（代码规范是什么）
出了事找谁（构建命令、测试命令）
这是你主动写的，每个新员工拿到的都一样。
memory/MEMORY.md = 《员工的笔记本》
员工干了一段时间，自己记下来的：
“上次改支付模块踩了个坑，金额字段是字符串不是数字”
“老板不喜欢用 npm，这个项目统一用 bun”
“数据库迁移要在周三之前完成”
这是 Claude 自己积累的，每做一件事就多记一点。下次遇到类似场景，它直接翻笔记，不用你再提醒。
三、它们怎么配合工作？
实际使用中，Claude Code 启动时的加载顺序是这样的：
1. 加载全局 CLAUDE.md（~/.claude/CLAUDE.md）2. 加载项目 CLAUDE.md（项目根目录/CLAUDE.md）3. 加载项目记忆（~/.claude/projects/xxx/memory/）
三层叠加，Claude 既知道"这个项目是什么"（CLAUDE.md），也知道"之前做过什么"（memory），还能保持通用的行为准则（全局 CLAUDE.md）。
打个连续的比方：
阶段
发生了什么
类比
第一次对话
Claude 读 CLAUDE.md 了解项目
新员工读员工手册
做了几个任务
Claude 在 memory 里积累了经验
员工开始记工作笔记
下次对话
Claude 先读手册，再翻笔记，直接上手
老员工回公司，熟门熟路
四、CLAUDE.md 里该写什么？
根据 Karpathy 的经验（那个 98k Star 的项目），一份好的 CLAUDE.md 应该包含：
项目概述 — 这个项目是干什么的
目录结构 — 关键目录各放什么
构建和测试命令 — 怎么跑、怎么测
代码规范 — 命名风格、注释要求等
踩坑记录 — 已知的坑，避免重复犯
关键原则：不超过 200 行。 Claude Code 创始人 Boris Cherny 说过，CLAUDE.md 超过 200 行，Claude 会选择性忽略。
五、memory 目录下还有什么？
~/.claude/projects/xxx/memory/ 不只有 MEMORY.md，通常还有这些：
文件
说明
MEMORY.md
记忆索引，列出所有记忆文件
user_preferences.md
用户偏好（输出目录、格式习惯等）
feedback.md
用户的纠正和认可
project.md
项目背景（进度、决策、约束）
reference.md
外部资源指引（文档链接、API 地址等）
这些文件会在新会话时自动加载，Claude 不用你重复解释。
六、两个额外的工具
claude-mem：一个让Claude code记忆持久化的skill
karpathy大神的CLAUDE.md ： 65 行四条铁律，直接给你的cc套上紧箍咒。
六、一句话总结
CLAUDE.md 告诉 Claude “你是什么”，MEMORY.md 记住 Claude “做过什么”。
一个是项目说明书，一个是 AI 笔记本。搞清楚这个区别，你的 Claude Code 用起来才能真正"越用越聪明"。
