Claude-Mem 给 Claude Code 装上跨会话的持久记忆

每个 Claude Code 会话都从零开始。你重新解释架构、重讲昨天追的 bug、重辩已经定过的决策。Claude-Mem，一个 94k 星的插件，补上了这个缺口：它在你工作时捕捉工具使用观察，压缩成语义摘要，再把相关内容注入未来的会话。

为什么这个 Skill 重要

系统通过生命周期钩子运行——SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd——捕捉和注入全自动，不需要手工维护笔记。底层是一个由 Bun 管理的本地 worker 服务（对外提供 HTTP API 和网页查看器）、一个存储会话、观察与摘要的 SQLite 数据库，以及一个做语义加关键词混合搜索的 Chroma 向量数据库。mem-search skill 让 agent 用自然语言查询项目历史。

设计目标是保持连续性，同时不让 token 膨胀。记忆搜索遵循三层工作流：search 返回带 ID 的紧凑索引，timeline 补上有趣命中前后的时间线，get_observations 只为通过筛选的 ID 拉取完整细节。

安装

npx claude-mem install

安装器把一切配置好，然后请你在浏览器登录（邮箱魔法链接，无需绑卡）。登录会发放一个 memory key，并解锁 claude-mem observer——一种不占用你 Anthropic 套餐的记忆服务，前 30 天免费，试用结束后若不订阅则自动回落到 Anthropic 套餐。提供方可选：observer、你自己的 OpenRouter 或 Gemini key，或你的 Anthropic 套餐。

不想走账号流程？传一个显式的 --provider 参数、设 CLAUDE_MEM_ONLINE_OPTIN=false，或在 CI 里运行——安装器不需要任何登录即可完成。

在 Claude Code 里也可以走插件市场路线：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

之后重启 Claude Code。README 里有个值得标出的坑：npm install -g claude-mem 只装 SDK 库——不注册钩子，也不启动 worker。依赖要求是 Node.js 20 或更高；Bun 和 uv（Python 包管理器）缺失时会自动安装。

实战：让它自己跑，然后看结果

重启之后，记忆是免维护的：过往会话的上下文会自动出现在新会话里。启动时打印的 worker URL 打开网页查看器，实时记忆流在眼前逐步填充。

实战：主动搜索

想要一个具体答案而不是自动预热时，按顺序驱动这三层：

// Step 1: Search for index
search(query="authentication bug", type="bugfix", limit=10)

// Step 2: Review index, identify relevant IDs (e.g., #123, #456)

// Step 3: Fetch full details
get_observations(ids=[123, 456])

索引结果每条约花 50–100 个 token；完整观察要 500–1,000。先筛选再拉取就是 README 所说约 10 倍 token 节省的来源——记得在一条 get_observations 调用里批量传 ID。

技巧

• 在 ~/.claude-mem/settings.json 里设 "CLAUDE_MEM_MODE": "code--zh" 即可输出简体中文观察——该模式内置，一个设置同时控制工作流行为和观察语言。改完重启 Claude Code 生效。
• 用 <private> 标签包裹敏感内容，它就不会进入存储。
• Claude Desktop 的 skill 可以在桌面对话里搜索同一份记忆。
• 用 ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ 列出全部可用模式。

何时不用这个 Skill

Claude-Mem 记的是会话里发生过的事——工具调用、决策、修复——不是手工打理的第二大脑，所以别指望它记住你从没在会话里记下的笔记。如前所述，全局 npm 安装对插件用户是错误路线。另外，如果完全不想要托管组件，就明确拒绝登录：observer 是托管选项，显式的 --provider 路线则把记忆生成留在你自己的 key 或 Anthropic 套餐上。

查看 排行榜 了解更多 skill。