主题
1.5 记忆系统 — 让 AI 真正认识你
学习目标
- 理解 Claude Code 的三层记忆体系
- 学会创建和编辑项目记忆与个人记忆
- 了解自动记忆的工作方式
- 拿到一个开箱即用的 CLAUDE.md 配置模板
为什么需要记忆？
每次打开 Claude Code 开始新对话时，它其实什么都不记得。它不知道你的项目用的是 React 还是 Vue，不知道你喜欢用分号还是不用分号，不知道你们团队的代码规范是什么。
没有记忆的 Claude Code 就像一个每天都失忆的同事——能力很强，但每次都要从头交代背景。
记忆系统就是解决这个问题的。 你把重要信息写进记忆文件，Claude Code 每次启动时都会自动读取，相当于"上班前先看一遍备忘录"。
三层记忆体系
Claude Code 的记忆分三层，由近到远：
项目记忆（.claude/CLAUDE.md）
↓ 只对当前项目生效
个人记忆（~/.claude/CLAUDE.md）
↓ 对你所有项目生效
自动记忆
↓ AI 自己判断需要记住的信息第一层：项目记忆 — .claude/CLAUDE.md
位置：项目根目录下的 .claude/CLAUDE.md
作用：告诉 Claude Code 这个项目的具体信息。
适合写什么：
- 项目的技术栈和架构
- 编码规范和命名约定
- 常用命令（怎么跑测试、怎么启动项目）
- 目录结构说明
- 团队特定的约定
核心优势：这个文件可以提交到 Git 仓库，团队所有人共享。新人加入项目，Claude Code 直接就知道项目的规矩。
创建方式——直接在对话中说：
> 帮我创建 .claude/CLAUDE.md，写入以下项目信息：
> - 这是一个 Next.js 14 项目，用 TypeScript
> - 包管理器用 pnpm
> - 测试框架用 Vitest
> - 组件用 shadcn/ui
> - 代码风格：用双引号，不用分号，缩进 2 空格或者用命令：
> /memory[截图: /memory 打开的编辑界面]
Claude Code 会打开记忆文件让你直接编辑。
第二层：个人记忆 — ~/.claude/CLAUDE.md
位置：你的用户主目录下的 ~/.claude/CLAUDE.md
作用：记录你的个人偏好，不管打开哪个项目都生效。
适合写什么：
- 回复语言偏好（比如"用中文回复"）
- 你的编码习惯
- 你喜欢的代码风格
- 你常用的工具链
和项目记忆的区别：个人记忆是"你的习惯"，项目记忆是"项目的规矩"。个人记忆不会提交到 Git，是你自己的。
创建方式：
bash
# 在终端中手动创建
mkdir -p ~/.claude
touch ~/.claude/CLAUDE.md然后用你喜欢的编辑器打开写入内容。或者直接在 Claude Code 中说：
> 帮我编辑 ~/.claude/CLAUDE.md，加入这些偏好：
> - 回复语言：中文
> - 代码注释：中文
> - 在给出代码方案时，先解释思路再给代码[截图: 个人记忆文件的内容示例]
第三层：自动记忆
Claude Code 在对话过程中会自动识别一些值得记住的信息。比如你纠正了它多次之后，它可能会建议：
Claude: 我注意到你总是要求用 pnpm 而不是 npm。要不要我把这个记到记忆里？[截图: Claude Code 提议添加自动记忆时的界面]
你同意后，这条信息就会被自动写入记忆文件。下次就不用重复纠正了。
自动记忆是锦上添花的功能，核心记忆还是建议你自己手动写。自己写的才是最准确的。
开箱即用的配置模板
项目记忆模板
直接复制到你项目的 .claude/CLAUDE.md，根据实际情况修改：
markdown
# 项目信息
## 技术栈
- 框架：Next.js 14（App Router）
- 语言：TypeScript（strict 模式）
- 样式：Tailwind CSS
- UI 组件库：shadcn/ui
- 包管理器：pnpm
- 测试：Vitest + Playwright
## 常用命令
- 启动开发服务器：pnpm dev
- 运行测试：pnpm test
- 构建：pnpm build
- 代码检查：pnpm lint
## 编码规范
- 文件命名：组件用 PascalCase，工具函数用 camelCase
- 导出方式：组件用默认导出，工具函数用命名导出
- 错误处理：所有异步操作必须有 try-catch
- 注释：关键业务逻辑必须写注释
## 目录结构
- src/app/ — 页面路由
- src/components/ — 可复用组件
- src/lib/ — 工具函数和配置
- src/types/ — TypeScript 类型定义个人记忆模板
复制到 ~/.claude/CLAUDE.md：
markdown
# 个人偏好
## 回复语言
中文
## 编码习惯
- 偏好函数式编程风格
- 优先使用 const 和不可变数据
- 类型定义尽量严格，少用 any
- 变量命名要有意义，不要用 a, b, c
## 工作习惯
- 复杂功能先给方案再写代码
- 修改代码后说明改了什么、为什么改
- 遇到不确定的地方先问我，不要猜记忆的优先级
当项目记忆和个人记忆有冲突时，项目记忆优先。
比如你个人偏好双引号，但项目规范是单引号——在这个项目里 Claude Code 会用单引号。这很合理，项目规范应该高于个人偏好。
常见问题
Q：记忆文件有大小限制吗？ A：没有硬性限制，但建议保持简洁。几十行到一两百行就够了。太长了反而会稀释重点信息，Claude Code 可能会遗漏关键内容。
Q：记忆文件支持什么格式？ A：Markdown 格式（.md 文件）。用标题、列表、代码块来组织信息，Claude Code 对结构化内容的理解最好。
Q：写错了会有什么后果？ A：Claude Code 会把记忆当作参考信息，不会因为一条错误记忆就"崩溃"。你在对话中如果发现它的行为不对，随时可以修改记忆文件或者在对话中直接纠正。
Q：.claude/CLAUDE.md 要不要提交到 Git？ A：建议提交。这样团队其他人（或者新加入的人）使用 Claude Code 时，自动就能获得项目的上下文信息。这是一种非常高效的团队协作方式。
Q：可以有多个记忆文件吗？ A：主记忆文件是 CLAUDE.md，但你可以在里面引用其他文件。Claude Code 也支持在 .claude/ 目录下放置其他配置文件。不过对新手来说，一个 CLAUDE.md 完全够用。
小结
记忆系统是让 Claude Code 从"通用工具"变成"你的专属助手"的关键。
三层记忆，各司其职：
| 层级 | 文件 | 范围 | 提交到 Git |
|---|---|---|---|
| 项目记忆 | .claude/CLAUDE.md | 当前项目 | 是，团队共享 |
| 个人记忆 | ~/.claude/CLAUDE.md | 所有项目 | 否，个人私有 |
| 自动记忆 | AI 自动管理 | 当前项目 | 否 |
建议现在就做一件事：打开你的项目，创建一个 .claude/CLAUDE.md，把上面的模板填进去，根据你的实际情况改一改。下次打开 Claude Code 时，你会明显感觉它"懂你"了。
恭喜你完成了基础篇的全部 5 节课！到这里你已经掌握了 Claude Code 的核心使用方法：
- 怎么写好提示词
- 10 个必知的斜杠命令
- 文件操作的完整流程
- 检查点的使用技巧
- 记忆系统的配置方法
这些就是日常使用 Claude Code 80% 的操作了。接下来的效率篇会教你怎么把这些基础能力组合起来，释放更大的生产力。