第 3 课:auto memory 配置与实战技巧

⏱ 预计阅读 3 分钟 更新于 2026/5/7
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

3.1 配置选项

你可以通过 settings.json 或环境变量来管理 auto memory:

配置项 作用 默认值
autoMemoryEnabled 开关 auto memory true
autoMemoryDirectory 修改存储路径 系统默认路径
CLAUDE_CODE_DISABLE_AUTO_MEMORY 环境变量禁用
--bare 启动参数,完全跳过记忆系统

3.2 如何触发 LLM 记录记忆

由于 auto memory 是由 LLM 主动判断写入的,当对话中没有明显的经验产出时,它不会自动记录。你可以使用以下“触发语”引导它:

  • User 类:“我习惯用 pnpm 而不是 npm。”
  • Feedback 类:“这次重构的思路很好,以后遇到类似场景都按这个模式来。”
  • Project 类:“记一下:本项目目前正处于从 Webpack 迁移到 Vite 的过渡期。”
  • Reference 类:“相关的设计文档在 https://docs.example.com/design-v2。”

3.3 验证与管理

验证是否启用:

  1. 运行 claude --version(确保版本 ≥ 2.1.32)。
  2. 在会话内运行 /memory 命令,查看“Auto-memory”状态。

手动管理:

你可以直接编辑 ~/.claude/projects/<hash>/memory/ 下的文件。如果你觉得记忆太杂乱,可以对 LLM 说:“帮我整理一下 auto memory:删除过时的反馈,合并重复的条目。”

3.4 常见误区

  • 误区 1:“开了就该记下所有对话。” —— 真相:它只记结论性事实,不存原文。
  • 误区 2:“记忆越多越好。” —— 真相:太多会稀释关键信号,甚至导致启动时加载截断。
  • 误区 3:“记忆是全局共享的。” —— 真相:默认按 Working Tree 隔离,跨项目不通用。