Claude Code 的记忆按项目目录隔离

Claude Code 的自动记忆按项目目录存。在 A 目录让它记住的事，换到 B 目录它就不知道了。这篇讲它存在哪、分几类、怎么让一条偏好在所有项目里生效。

一、Claude Code 的两套持久化机制

Claude Code 有两套独立的「记忆」：

二、核心机制：按项目目录隔离

记忆存在哪？

所有自动记忆存储在 ~/.claude/projects/ 目录下，每个项目对应一个独立的子目录：

~/.claude/projects/
├── -home-ubuntu-workspace/           # /home/ubuntu/workspace 的记忆
│   └── memory/
│       ├── MEMORY.md                 # 索引文件
│       ├── user_profile.md           # 用户画像
│       └── project_xxx.md            # 项目信息
├── -home-ubuntu-my-app/              # /home/ubuntu/my-app 的记忆
│   └── memory/
│       └── MEMORY.md
└── -home-ubuntu-another-project/     # 另一个项目
    └── memory/
        └── MEMORY.md
复制

目录命名规则：把项目的绝对路径里的 / 换成 -。输入一个路径试试：

1. 你在项目 A 里告诉 Claude 的偏好，在项目 B 里 Claude 完全不知道
2. /resume 恢复会话也是项目隔离的——只能恢复当前目录下的历史会话
3. 同一个 git 仓库的不同 worktree 共享同一份记忆（因为路径归属同一个 repo）

三、Auto Memory 的四种类型

Claude 会自动将学到的信息分为四类：

1. user（用户画像）

记录你是谁、擅长什么、怎么协作效率最高。

---
name: 用户画像
description: 前端全栈工程师，Node+TS 技术栈
type: user
---
前端全栈工程师，熟悉 Node.js + TypeScript 技术栈...
复制

作用：Claude 会根据你的背景调整回答深度。对资深工程师不会解释基础概念，对新手会多给上下文。

2. feedback（反馈偏好）

你纠正过 Claude 的行为，或者确认过某个做法是对的。

---
name: wrangler 必须加 --remote
description: wrangler R2 命令必须加 --remote，因为本地 GLIBC 版本问题
type: feedback
---
wrangler R2 操作必须加 --remote 参数。
**Why:** 本机 GLIBC 版本低，本地模拟会报错。
**How to apply:** 所有 wrangler r2 相关命令都要加 --remote。
复制

作用：同样的坑不踩第二次。这是最有价值的记忆类型。

3. project（项目上下文）

当前项目的背景、目标、进展。

---
name: CoffeesMap V2 迁移
description: V2 进行中，Supabase 数据迁移 + R2 图片迁移已完成
type: project
---
CoffeesMap V2 正在进行中...
复制

作用：Claude 能理解你当前在做什么，给出更贴合上下文的建议。

4. reference（外部引用）

外部系统的位置和用途。

---
name: Cloudflare 账号信息
description: Cloudflare R2 bucket、API token 的位置
type: reference
---
R2 bucket 名称: xxx, API token 在 ...
复制

作用：Claude 知道去哪里找信息，不用每次都问你。

四、MEMORY.md：记忆的索引

MEMORY.md 是每个项目记忆目录下的索引文件，每次会话启动时自动加载前 200 行。它只包含指向详细记忆文件的链接：

# Memory Index

- [user_profile.md](user_profile.md) — 前端全栈工程师，Node+TS
- [feedback_wrangler.md](feedback_wrangler.md) — wrangler 命令必须加 --remote
- [project_coffeesmap.md](project_coffeesmap.md) — CoffeesMap V2 迁移进展
复制

注意：超过 200 行的内容会被截断，所以要保持索引简洁。详细内容放在各个记忆文件里，Claude 会按需读取。

五、/resume 也是隔离的

/resume 命令用于恢复之前的会话，它默认只显示当前项目目录下的历史会话。

快捷键扩展范围

在 /resume 的会话选择器中：

• Ctrl+A：显示本机所有项目的会话
• Ctrl+W：显示同一仓库所有 worktree 的会话
• Ctrl+B：只显示当前 git 分支的会话
• Space：预览会话内容

命令行用法

claude --continue          # 继续当前目录的最近一次会话
claude --resume            # 打开选择器
claude --resume "会话名"   # 按名称恢复（搜索当前仓库及其 worktree）
复制

六、CLAUDE.md 的层级体系

CLAUDE.md 也有作用域，但它的层级更丰富：

组织级策略（强制执行，不可跳过）
  └── 用户级：~/.claude/CLAUDE.md（所有项目生效）
       └── 项目级：./CLAUDE.md 或 ./.claude/CLAUDE.md（当前项目）
            └── 本地级：./CLAUDE.local.md（个人覆盖，加入 .gitignore）
                 └── 子目录级：子目录下的 CLAUDE.md（按需加载）
复制

实用建议：

• 团队共享的规则放 ./CLAUDE.md，提交到 git
• 个人偏好放 ./CLAUDE.local.md，加入 .gitignore
• 全局个人偏好放 ~/.claude/CLAUDE.md

七、实战建议

1. 让记忆跨项目生效

如果你希望某些偏好在所有项目中都生效（比如"我是 TypeScript 开发者，偏好函数式风格"），把它写进 ~/.claude/CLAUDE.md，而不是依赖 Auto Memory。

2. 定期审查记忆

运行 /memory 命令可以查看当前加载的所有记忆文件，选中即可编辑。建议定期清理过时的记忆。

3. 主动让 Claude 记住关键信息

当你发现某个知识点未来会反复用到，直接说"记住这个"，Claude 会立即保存。比如：

• "记住：这个项目的部署用 GitHub Actions，触发条件是 push 到 main"
• "记住：数据库连接串在 Vault 里，key 是 prod/db-url"

4. 切换目录前想清楚

如果你的工作跨多个目录，记得：每个目录的 Claude 是「独立的」。在一个目录里建立的上下文，不会自动带到另一个目录。

5. 善用 /resume 的快捷键

忘了在哪个目录聊过？用 Ctrl+A 显示所有项目的会话历史，可以快速定位。

八、总结