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 你的规则)
- 在项目根目录创建文件
CLAUDE.md - 写入你的永久指令,例如:
# 项目永久规则
## 技术栈
- 始终使用 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(项目级永久记忆)。你确认后即可永久保存。
三、实用技巧(让记忆效果翻倍)
- 定期清理:输入
/memory→ 选择文件 → 编辑删除过时内容 - 项目级 vs 全局级:项目根目录的 CLAUDE.md 只影响当前项目;全局 ~/.claude/CLAUDE.md 影响所有项目
- 结合 KAIROS(后台模式):如果未来 KAIROS 正式上线,它会自动在你不看时整理记忆
- 让 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