Claude Code 的持久记忆压缩系统——
会话间无缝延续，让 Claude 记住你的项目。
自动捕获 · 语义压缩 · 智能注入 · 渐进式披露
← 返回汇总给 Claude Code 装上海马体。
自动捕获工具使用观察 → AI 压缩成语义摘要 → 未来会话按需注入。
每次新会话，Claude 从零开始，上次的工作毫无记忆。
手动维护的记忆文件有限，且容易过时。
项目架构、技术选型、踩过的坑，每次都要重新说明。
完整历史塞进窗口，token 成本高且淹没关键信息。
不存全部，只存精华。
SessionStart / UserPromptSubmit / PostToolUse / Stop / SessionEnd
缓存依赖检查器，预 hook 脚本
本地 HTTP API + Web 查看器，Bun 管理
存会话、观察、摘要，FTS5 全文搜索
自然语言查询，渐进式披露
语义 + 关键词混合检索
| Hook | 触发时机 | 作用 |
|---|---|---|
SessionStart | 会话开始 | 注入历史上下文 |
UserPromptSubmit | 用户提交 | 记录请求 |
PostToolUse | 工具调用后 | 捕获观察结果 |
Stop | 会话暂停 | 压缩中间状态 |
SessionEnd | 会话结束 | 生成最终摘要 |
hooks 让记忆全程自动化，无需手动操作。
不是一股脑塞全部记忆，而是分层检索，每层显示 token 成本，按需深入。
先看索引定位，再看时间线理解上下文，最后取详情。token 用在刀刃上。
| 工具 | 用途 |
|---|---|
search | 紧凑索引 + ID（~50-100 tok/结果） |
timeline | 围绕结果的时间线上下文 |
get_observations | 获取完整详情 |
mem-search skill | 自然语言查询入口 |
遵循 token 高效的 3 层工作流模式。
# 方式一：npx 一键装 npx claude-mem install # 方式二：Claude Code 插件市场 /plugin marketplace add thedotmack/claude-mem /plugin install claude-mem # 重启 Claude Code 即可 # 历史会话上下文会自动出现在新会话中
⚠ 注意：npm install -g claude-mem 只装 SDK，不注册 hooks。务必用 npx claude-mem install。
上下文跨会话存活。
分层检索，token 成本可见。
实时记忆流，可视化浏览。
用标签排除敏感内容不入库。
通过 ID 引用过去观察。
无需手动干预，hooks 全程托管。
Claude Code 生态最热门的记忆方案（86k Stars）。差异化在于：渐进式披露的 token 经济性、完整 hooks 自动化、混合检索质量。随着 Claude Code 用户群扩大，记忆痛点持续存在，claude-mem 有稳定增长空间。最大风险是官方 Memory 功能替代——但第三方方案在灵活性、跨工具支持上仍有优势。对研究 Agent 记忆架构的人，它的 v3→v5 演进文档极具参考价值。