/memory
编辑 CLAUDE.md Memory 文件,开启/关闭 Auto-Memory,并查看 Auto-Memory 条目。
/memory 列出用户和项目范围内所有 CLAUDE.md 和 CLAUDE.local.md 文件的位置,包括那些还不存在的文件对应的条目。选中其中一项会在编辑器中打开该文件——像 VS Code 这样的图形界面编辑器会在单独的窗口中打开,会话期间仍可继续使用;而像 Vim 这样的终端编辑器会占用终端,直到关闭为止。此外,/memory 还可以开启或关闭 Auto-Memory(保存为 ~/.claude/settings.json 中的 autoMemoryEnabled),并打开 Auto-Memory 文件夹供查看。
Auto-Memory 是 Claude 根据纠正和偏好自主总结出的笔记——比如构建命令、调试经验或工作流偏好——保存在本机,并在同一仓库的所有 worktree 之间共享。相比之下,CLAUDE.md 文件是自己编写的,用于记录编码规范或架构等长期性规定。两者都会在每次对话中作为上下文加载,但并不会被强制执行——如果需要强制生效,需要用到 PreToolUse hook。
✅ 什么时候用?
为所有未来的会话记录一条长期规则
使用 /memory 把类似「始终使用 TypeScript strict mode」这样的规定写入 CLAUDE.md,而不是每次都重复说明。
查看 Claude 自己记录了哪些 Auto-Memory
调用 /memory 并打开 Auto-Memory 文件夹,查看自动保存的关于构建命令或偏好的笔记。
⛔ 什么时候不该用?
某条指令只适用于当前任务
/memory 写入的是会被长期加载的文件——对于一次性的指令来说没有必要,还会让 CLAUDE.md 变得臃肿。
更好的选择: 直接在当前会话的 prompt 中给出指令,而不保存它。
查看当前会话实际加载了哪些 memory 文件
/memory 列出所有位置,但不显示其中哪些实际已加载到当前会话中。
更好的选择: 调用 /context,查看「Memory files」下的列表。
来源
- Claude Code 文档(官方) ↗ code.claude.com