第 12 课:进阶话题与 20 个常见问题解答

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

12.1 进阶:Auto Dream (暗发布功能)

Auto Dream 是 Claude Code 的“夜间整理工”,类比人类的睡眠。它会周期性地回顾并压缩 auto memory:

  • 触发:超过 24 小时且超过 5 个会话。
  • 作用:合并重复、将相对日期转为绝对日期、清理陈旧规则。
  • 现状:目前属于 Dark Launch (暗发布) 状态,功能由服务端开关控制。如果你的 /memory UI 没显示该项,可以通过对 LLM 说“帮我整理一下 auto memory”来手动实现类似效果。

12.2 故障排查清单

现象 检查方案
auto memory 没记录 正常现象。它不是录音机,需要 LLM 判断。建议手动说“记一下:xxx”触发。
claude-mem 报错 查看 ~/.claude-mem/logs/。检查是否安装了 Bun Runtime。
会话启动变慢 检查 MEMORY.md 是否过大(超过 200 行)。检查 Hook 是否超时。
跨项目搜不到 确认使用的是 mem-search 技能,而非普通搜索。

12.3 20 个核心 Q&A (精选)

Q1: auto memory 和 CLAUDE.md 是同一个东西吗? 不。CLAUDE.md 是人写的硬规则;auto memory 是 LLM 自动写的笔记。

Q2: claude-mem 把我的代码传到哪了? 它在本地存储(SQLite/Chroma),但“蒸馏”过程会把片段发给 Anthropic API。

Q3: 如何彻底卸载 claude-mem? 运行 /plugin uninstall 并删除 ~/.claude-mem 文件夹。

Q4: auto memory 能跨项目共享吗? 不能,仅限单一 Working Tree。跨项目请用 claude-mem。

Q5: 记录越多越好吗? 不。太多会稀释信号并增加 Token 成本。保持记忆的“高信噪比”是最佳实践。

Q6: 我可以手动编辑记忆文件吗? 可以,它们就是普通的 Markdown 或 SQLite 数据库。

Q7: 记忆系统如何处理敏感信息? 系统目前不会自动过滤 Secret。建议定期审查并在敏感项目中使用 --bare 模式。

(注:更多 Q&A 请参考原始完整文档)