了解如何通过不同的记忆位置和最佳实践，管理 Claude Code 在会话之间的记忆。

Claude Code 可以在不同会话间记住你的偏好，比如风格指南和常用工作流命令。

---

确定记忆类型

Claude Code 提供三种记忆存储位置，各自有不同用途：

记忆类型	位置	目的	示例用法
项目记忆（共享）	./CLAUDE.md	团队共享的项目指令	项目架构、编码规范、常用工作流
用户记忆（全局）	~/.claude/CLAUDE.md	所有项目通用的个人偏好	代码风格偏好、个人工具快捷方式
项目记忆（本地/个人）	./CLAUDE.local.md	针对个人的项目专属偏好（已废弃，见下文）	沙盒 URL、首选测试数据

所有记忆文件在启动 Claude Code 时会自动加载进上下文。

---

CLAUDE.md 文件的导入功能

CLAUDE.md 文件可以使用 @path/to/import 语法导入其他文件。例如，以下代码导入了 3 个文件：

参见 @README 获取项目概览，参见 @package.json 获取本项目可用的 npm 命令。

其他说明

• git 工作流 @docs/git-instructions.md

相对路径和绝对路径都可以使用。尤其是导入用户主目录下的文件，这便于团队成员提供不需要提交到代码仓库的个性化指令。此前 CLAUDE.local.md 也有类似功能，但现在推荐用导入，因为它在多 git 工作区下效果更好。

个人偏好

• @~/.claude/my-project-instructions.md

为避免冲突，markdown 代码块和代码段中的导入不会被识别为导入指令。

此代码段不会被视为导入：@anthropic-ai/claude-code

被导入的文件还可以递归导入其他文件，最多允许 5 层嵌套。你可以通过 /memory 命令查看当前加载了哪些记忆文件。

---

Claude 如何查找记忆文件

Claude Code 以递归方式读取记忆文件：从当前工作目录（cwd）开始，向上递归到根目录 /，读取发现的所有 CLAUDE.md 或 CLAUDE.local.md 文件。这在大型代码库下尤其方便，例如你在 foo/bar/ 运行 Claude Code，同时在 foo/CLAUDE.md 和 foo/bar/CLAUDE.md 都有记忆文件。

Claude 还会发现当前工作目录下子树中嵌套的 CLAUDE.md。与启动时不同，这些记忆只在 Claude 读取这些子树文件时才会加载。

---

用 # 快捷方式快速添加记忆

添加记忆最快的方法是在输入前加上 # 号：

# 始终使用描述性变量名

你会被提示选择存储到哪个记忆文件。

---

用 /memory 直接编辑记忆

在会话中可使用 /memory 斜杠命令，在系统编辑器中打开任意记忆文件，方便你批量添加或整理内容。

---

记忆的最佳实践

• 具体明确：如“使用 2 空格缩进”优于“请正确格式化代码”。
• 结构化整理：建议每条记忆用列表项（bullet point）写，并用有意义的 markdown 标题分组。
• 定期审查：随着项目发展及时更新记忆，确保 Claude 总能获取最新的信息和上下文。

---