今天与大家分享一项极具分量的功能更新。就在昨日，Claude Code 的开发者 Thariq 在 X 平台上正式宣布，全新 Auto Memory（自动记忆）功能已重磅上线。
这项功能的核心价值十分明确：让 Claude 自动记录你的项目上下文、调试模式、个人偏好等关键信息，并在后续对话中自动调用，无需你再手动整理。换句话说，你的 Claude 现在拥有了真正的“长期记忆”能力。
Thariq 在推文中写道：“We've rolled out a new auto-memory feature. Claude now remembers what it learns across sessions — your project context, debugging patterns, preferred approaches — and recalls it later without you having to write anything down.” 他还特别阐释了两份文件的分工：CLAUDE.md 是给 Claude 的指令手册，而 MEMORY.md 则是 Claude 自动更新的记忆笔记。当你告诉 Claude“记住某件事”，它就会写入该文件。
消息发布后，迅速获得了大量点赞与转发。众多开发者表示，该特性将大幅提升编程效率。如果你是 Claude Code 的用户，这无疑值得重点关注。
Auto Memory（自动记忆）功能全面详解
根据官方文档，Claude Code 的记忆系统包含两种持久化内存：Auto Memory（自动记忆）与 CLAUDE.md 文件。两者会在每次会话开始时加载到上下文中，帮助 Claude 跨会话保持行为一致性。
1. Auto Memory 的工作原理
- 自动保存上下文：Claude 会自动记录项目模式、常用命令、个人偏好以及调试洞察。例如，如果你习惯使用 pnpm 而非 npm，Claude 会记住这一偏好，并在后续推荐中自动应用。
- 存储位置：保存在
~/.claude/projects/目录下，主文件为/memory/ MEMORY.md（前 200 行会加载到提示中）。针对特定主题（如调试），会创建子文件（如debugging.md），按需加载。 - 启用与关闭：默认处于开启状态。你可以通过
/memory命令切换，或在设置文件中修改（用户级：~/.claude/settings.json中设置"autoMemoryEnabled": false；项目级：.claude/settings.json；环境变量：CLAUDE_CODE_DISABLE_AUTO_MEMORY=1）。 - 手动保存：直接对 Claude 说“remember we use pnpm”或“save that API tests need Redis”，它便会自动写入记忆文件。
2. CLAUDE.md 文件：你的自定义指令集
- 层级结构：支持多个位置的 CLAUDE.md 文件，从系统级到项目级，再到用户级。
- 系统级：如
/Library/Application Support/ClaudeCode/CLAUDE.md，用于定义组织标准。 - 项目级：
./CLAUDE.md或./.claude/CLAUDE.md，适合团队共享。 - 模块化规则：
.claude/rules/*.md，按主题组织（如code-style.md）。 - 用户级：
~/.claude/CLAUDE.md，存放个人偏好。 - 本地私有：
./CLAUDE.local.md，自动被 git 忽略，适合存放敏感信息。
- 系统级：如
- 加载机制：从当前目录递归向上加载。子目录中的 CLAUDE.md 在访问相关文件时按需加载。
- 导入支持：使用
@path/to/file语法导入其他文件（支持相对或绝对路径），首次使用需批准，最大递归深度为 5 层。 - 条件规则：在
.claude/rules/中使用 YAML 前置元数据指定路径（如paths: - "src/**/*.ts"），让规则仅对特定文件生效。
3. 带来的核心优势
- 持久上下文：无需在每次会话中重复解释项目细节，工作效率显著提升。
- 团队协作：共享记忆确保团队成员使用一致的编码风格与方法论。
- 隐私保护：CLAUDE.local.md 不会进入版本控制系统，保障敏感信息安全。
- 可扩展性：模块化规则与自动记忆让大型项目的管理变得更加轻松。
- 学习与调试：Claude 会自动捕捉调试洞察与解决方案，帮助你持续积累经验。
使用指南与实战示例
- 初始化项目记忆：运行
/init命令，生成./CLAUDE.md并自动填充项目上下文。 - 管理记忆：使用
/memory命令打开编辑器，查看或编辑 MEMORY.md 内容。 - 示例1：自动记忆。你只需说“remember we use pnpm, not npm”，Claude 就会将其保存到项目模式中，并在下次自动应用。
- 示例2：导入文件。在 CLAUDE.md 中写入：
# InstructionsSee @README for overview and @package.json for commands. - 示例3：条件规则。在
code-style.md中配置：--- paths: - "src/**/*.ts" --- # TypeScript Rules - Use strict null checks - Prefer interfaces over types - 示例4：共享规则。使用符号链接：
ln -s ~/shared-claude-rules .claude/rules/shared，实现跨项目规则共享。
注意事项与使用限制
- 大小限制：MEMORY.md 仅加载前 200 行，剩余内容需放入主题子文件中。
- 导入限制：不能在代码块中执行导入；一旦拒绝则无法重启；最大递归深度为 5 层。
- Git Worktree：每个 worktree 拥有独立的自动记忆目录。
- 符号链接：需警惕循环链接问题。
- 额外目录：需设置环境变量才能加载
--add-dir指定的 CLAUDE.md 文件。
这一功能是 Claude Code 向更智能的 AI 编程助手迈出的重要一步。如果你还在为反复输入项目细节而烦恼，不妨立即更新 Claude Code，亲身体验 Auto Memory 带来的效率提升。更多详情可查阅官方文档：https://code.claude.com/docs/en/memory。
