Claude Code 最强大的跨会话学习功能叫「持久记忆系统」(Persistent Memory),它让 AI 真正记住你上一次做了什么、项目状态、你的偏好和修正记录。下次打开 Claude Code 时,它会自动加载这些记忆,就像老朋友一样接着上一次的工作继续。

这个功能完全基于本地文件(无需云端),分为两种互补机制:**CLAUDE.md(手动记忆)** 和 **Auto Memory(自动记忆)**。两者同时工作,效果最佳。

一、Claude Code 记忆系统工作原理

每次启动新会话时,Claude Code 会自动加载以下文件:

  • CLAUDE.md:你手动编写的永久指令(项目规则、编码风格、常用命令等)
  • MEMORY.md:Claude 自己自动生成的记忆索引(总结上一次的工作、发现的问题、你的偏好)
  • 专题记忆文件(topic files):如 debugging.md、patterns.md 等,Claude 需要时按需读取

记忆位置(默认):

~/.claude/projects/你的项目名称/memory/

Claude 只加载 MEMORY.md 的前 200 行或 25KB(防止上下文爆炸),超出部分会按需调用。

二、如何开启和使用跨会话记忆(一步一步操作)

步骤 1:确认 Auto Memory 已开启(默认已开启)

在 Claude Code 终端中输入:

/memory

它会显示当前加载的记忆文件,并告诉你 Auto Memory 是开启还是关闭。

如果显示 “Auto memory: ON”,就说明已经自动运行。

步骤 2:创建 CLAUDE.md(手动告诉 AI 你的规则)

  1. 在项目根目录创建文件 CLAUDE.md
  2. 写入你的永久指令,例如:
# 项目永久规则

## 技术栈
- 始终使用 TypeScript + React + Tailwind
- 包管理器必须是 pnpm
- 所有 API 调用必须添加错误重试机制

## 编码风格
- 函数名使用 camelCase
- 每个组件必须有详细 JSDoc 注释
- 优先使用 server actions 而不是 API routes

## 我的偏好
- 回复时先给出完整代码,再解释改动点
- 永远不要使用 console.log,改用 structured logging

保存后,下次启动 Claude Code 时,它会自动读取并严格遵守这些规则。

步骤 3:让 AI 自动记住上次干了什么(Auto Memory)

无需手动操作!只要你在对话中说类似指令:

  • “记住这个:以后所有数据库操作必须使用 Prisma”
  • “把这个 bug 修复方案记下来”
  • “总结今天我们做的架构决策”

Claude 会自动把重要信息写入 MEMORY.md。下次会话开始时,它会主动说:“我记得上次我们把用户认证改成了 JWT + Redis,现在继续吗?”

步骤 4:手动强化记忆(/remember 命令)

在任何会话中输入:

/remember

Claude 会回顾本次会话所有内容,提取重要模式,并建议写入 CLAUDE.local.md(项目级永久记忆)。你确认后即可永久保存。

三、实用技巧(让记忆效果翻倍)

  1. 定期清理:输入 /memory → 选择文件 → 编辑删除过时内容
  2. 项目级 vs 全局级:项目根目录的 CLAUDE.md 只影响当前项目;全局 ~/.claude/CLAUDE.md 影响所有项目
  3. 结合 KAIROS(后台模式):如果未来 KAIROS 正式上线,它会自动在你不看时整理记忆
  4. 让 AI 自己总结:会话结束前说“请把今天的重要决策总结到 MEMORY.md”

四、常见问题解答

  • 记忆不生效? 检查是否在同一个 git 项目目录下运行;确认 Auto Memory 已开启
  • 记忆太多导致变慢? Claude 会自动压缩,只保留前 25KB 关键内容
  • 想删除所有记忆? 删除整个 memory 文件夹即可
  • 跨电脑同步? 目前是本地文件,建议用 Git 或云盘同步 memory 文件夹

总结

Claude Code 的跨会话学习功能超级简单:**创建 CLAUDE.md 写规则 + 让 AI 自动写 MEMORY.md**。从此以后 AI 就能记住你上次干了什么、项目状态和你的偏好,每次启动都像老朋友接着聊。

现在就打开 Claude Code,输入 /memory 查看当前记忆状态,然后创建一个 CLAUDE.md 文件试试吧!你会立刻感受到“AI 真的在学习”的强大。

使用过程中遇到记忆不准或想优化 Prompt,欢迎在评论区贴出你的情况,我可以帮你进一步调整。

官方参考链接:
Claude Code 记忆文档:https://code.claude.com/docs/en/memory
Claude Code 官网:https://code.claude.com
Anthropic 文档:https://docs.anthropic.com