Claude Code 的记忆靠两样东西,每次会话开始时都会加载。CLAUDE.md 存你写的指令。自动记忆存 Claude 根据你的纠正自己写的笔记。新会话从空的上下文窗口开始,你之前说过的其他话不会在里面。claude --continue 或 claude --resume 可以重新打开旧对话,但进入全新会话的只有 CLAUDE.md 和自动记忆。
| CLAUDE.md 文件 | 自动记忆 | |
|---|---|---|
| 谁来写 | 你 | Claude |
| 存什么 | 指令和规则 | 学到的经验和模式 |
| 范围 | 项目、用户或组织 | 每个仓库,各 worktree 共用 |
| 何时加载 | 每个会话 | 每个会话(前 200 行或 25KB) |
来源:Claude Code 记忆文档,2026 年 10 月 9 日读取。Claude 把两者都当作上下文,而不是强制配置。
新会话里能带过去的东西:CLAUDE.md 和自动记忆
CLAUDE.md:你总在重复的规则
- 控制在 200 行以内。 文件越长,占用的上下文越多,遵守程度越低。只适用于部分代码的规则,放进
.claude/rules/,只有 Claude 处理匹配文件时才加载。 - 导入只是整理,不会变短。 用
@path/to/file导入的文件同样在启动时加载。 - 写具体。 指令越简洁具体,Claude 越能稳定地遵守。
自动记忆:Claude 自己写的笔记
每个项目有一个 ~/.claude/projects/<project>/memory/,里面是 MEMORY.md 索引,加每个主题一个文件。
- 只在本机。 同一 git 仓库的所有 worktree 共用;其他机器不共享。
- 索引有上限。
MEMORY.md只加载前 200 行或 25KB。每条记忆一行,细节放主题文件。 - 你可以查看和修改。 文件是普通 Markdown。
/memory会列出它们,并有开关。
怎么选
| 你想要…… | 用 |
|---|---|
| 固定构建和测试命令、约定、禁碰的文件夹 | CLAUDE.md |
| 让 Claude 记住你纠正过一次的事 | 自动记忆 |
| 只对部分文件夹生效的规则 | .claude/rules/ 里的文件 |
| 和队友共享规则 | 提交项目的 CLAUDE.md(自动记忆留在你的机器上) |
| 保证某件事绝不发生 | PreToolUse hook,不要靠记忆 |
| 共享多个 agent 在同一项目里学到的东西 | Crewly 的 remember 和 recall(见下) |
五分钟设置
- 在项目根目录写一个简短的 CLAUDE.md:构建命令、测试命令、约定、禁碰的文件夹。
- 运行
/memory,确认 CLAUDE.md 在列表里,自动记忆是开着的。 - 用大白话纠正 Claude 一次,比如“这个仓库用
check脚本跑测试,不是test”,然后去记忆文件夹里看有没有保存的笔记。 - 一周后打开
MEMORY.md,删掉过时的行,合并重复的。
当你运行多个 agent
CLAUDE.md 和自动记忆默认是一个人、一个会话。我们做的开源工具 Crewly 为 agent 团队加了两个技能。remember 保存一条笔记,范围是 agent(个人)或 project(项目内所有 agent 共享)。recall 搜索已保存的笔记。新决定可以用 --supersedes 指明它取代了哪一条旧决定,这样 agent 不会再把旧的当作现行答案。它不取代 CLAUDE.md。搭建方法见:如何在 Claude Code 里运行多个 agent。
常见问题
Claude Code 会在会话之间记住东西吗?
会,靠两种机制:你写的 CLAUDE.md,和 Claude 自己写的自动记忆。两者都在每次新对话开始时加载。进入全新会话的只有它们;想接着旧对话,用 claude --continue 或 --resume。
Claude Code 的自动记忆存在哪里?
在 ~/.claude/projects/<project>/memory/,里面有 MEMORY.md 索引。它只在本机,同一仓库的所有 worktree 共用。
MEMORY.md 能有多大?
每次对话开始时加载前 200 行或 25KB。超出的部分不会加载,所以每条记忆写一行。
来源
How Claude remembers your project,2026 年 10 月 9 日读取。Crewly 记忆:Crewly 仓库中 remember 和 recall 的技能定义,2026 年 10 月 9 日核对。