记忆系统

Claude Code 有一套文件级的持久化记忆系统，让 AI 在不同对话之间记住项目信息和你的个人偏好。

记忆层级

层级	文件位置	作用域	提交 Git
全局	`~/.claude/CLAUDE.md`	所有项目	否
项目（共享）	`./CLAUDE.md`	当前项目所有人	是
项目（个人）	`./CLAUDE.local.md`	当前项目仅自己	否
子目录	`./子目录/CLAUDE.md`	特定目录	是
自动记忆	`~/.claude/projects/.../memory/`	自动收集	否

优先级：更具体的覆盖更通用的。

/memory

打开记忆编辑器，直接编辑你的记忆文件。

Claude Code 会自动从对话中提取有用信息保存到记忆：

当 Claude 了解到你是谁、做什么工作：

我是前端开发，主要用 React 和 TypeScript
→ 保存：用户是前端开发，擅长 React/TypeScript

当你纠正 Claude 的行为：

不要用 npm，我们项目用 pnpm
→ 保存：该项目使用 pnpm，不要用 npm

停止每次都总结你做了什么，我自己看 diff
→ 保存：用户偏好简洁回复，不需要尾部总结

我们下周五之前要完成 v2.0 发布
→ 保存：v2.0 发布截止日期 2026-04-10

自动记忆保存在 ~/.claude/projects/<path>/memory/ 目录下：

memory/
├── MEMORY.md           # 记忆索引
├── user_profile.md     # 用户画像
├── feedback_style.md   # 行为反馈
└── project_context.md  # 项目信息

每个记忆文件有 frontmatter：

---
name: 工作风格偏好
description: 用户的代码风格和工作流偏好
type: feedback
---

使用 pnpm 不要用 npm。
**Why:** 项目统一使用 pnpm workspace。
**How to apply:** 所有包管理命令使用 pnpm。

类型	用途	示例
`user`	用户角色和偏好	"资深后端工程师，偏好函数式编程"
`feedback`	行为纠正和确认	"不要自动提交 git"
`project`	项目状态和目标	"正在做 v2.0 迁移"
`reference`	外部资源指引	"bug tracker 在 Linear 的 BACKEND 项目"

记住：这个项目的测试要用 vitest 跑，不是 jest

忘掉之前关于数据库迁移的记忆，我们已经改用 Drizzle 了

忽略记忆，从头开始

Claude 会当作 MEMORY.md 为空来工作。

最佳实践： 项目规范写 CLAUDE.md，个人偏好靠自动记忆。