claude-mem：让Claude Code拥有持久记忆的开源插件

你是不是也遇到过这种情况？

4| 5|每天用 Claude Code 写代码，昨天刚让它帮你重构了用户模块，今天开个新会话再问，它一脸懵——"什么用户模块？我没做过啊。" 你不得不把昨天的上下文重新描述一遍，复制粘贴各种文件路径、函数签名、改了哪些地方……一轮下来，半个小时没了。更要命的是，上周你让它修过一个线上 bug，今天类似的问题又出现了，你翻遍聊天记录都找不到当时具体改了什么。AI 编程助手明明很强大，但每次对话都像失忆一样从零开始，这谁受得了？ 6| 7|## claude-mem 是什么？ 8| 9|claude-mem 是一个给 Claude Code 加上"持久记忆"能力的开源插件——它会自动记住你每次编程会话中做了什么，并在你开启新对话时智能地注入相关历史，让 Claude 像一个真正记得住事的搭档一样工作。 10| 11|项目目前在 GitHub 上已收获 58K+ Star（今天还新增了 2300+），火爆程度可见一斑。 12| 13|GitHub 地址：https://github.com/thedotmack/claude-mem 14| 15|## 核心功能一览 16| 17|先解释几个关键概念，方便后面理解： 18| 19|- 记忆：这里说的"记忆"不是人脑的记忆，而是把 AI 每次会话中的操作记录（比如读了什么文件、改了什么代码、跑了什么命令）保存下来，形成一份可检索的历史档案。 20|- 上下文注入：相当于在开新对话之前，自动把之前相关的历史摘要"喂"给 AI，让它不需要你重复描述背景就能接着干活。 21|- 语义摘要：不是把所有对话原封不动存下来（那太长了），而是用 AI 把一段对话压缩提炼成几句关键信息，类似于你读完一本书后写的读书笔记。 22| 23|好，概念清楚了，下面看具体功能： 24| 25|| 功能 | 说明 | 26||------|------| 27|| 自动会话捕获 | 你在 Claude Code 里做的所有操作——读文件、写代码、执行命令，全部自动记录，无需手动保存 | 28|| AI 压缩摘要 | 用 AI 智能压缩冗长的会话内容，生成精炼的语义摘要，省空间又不丢关键信息 | 29|| 自动上下文注入 | 开新对话时自动把相关历史喂给 Claude，它"记得"之前做过什么，不用你重新描述 | 30|| mem-search 自然语言搜索 | 直接用中文或英文问它"上次那个登录模块怎么改的？"，就能搜到对应的历史记录 | 31|| Web 查看器 | 浏览器打开 localhost:37777，实时查看你的记忆流，像翻日记一样回顾项目演进 | 32|| 多 IDE 支持 | 不只是 Claude Code，Claude Desktop、Gemini CLI、OpenCode 等都能用 | 33|| 隐私控制 | 用 <private> 标签包裹敏感内容，这些部分不会被记录到记忆中，保护你的代码机密 | 34|| 渐进式上下文披露 | 不是一次把所有历史都塞进去，而是根据相关性逐步注入，节省 token（省钱的！） 35|| 中文模式 | 设置 code--zh 模式后，搜索、摘要都走中文，对国内开发者非常友好 | 36|| Chroma 向量数据库 | 内置混合搜索引擎，既能按"意思"搜（语义搜索），也能按"关键词"搜，找东西又快又准 | 37|| MCP 三层搜索工具 | search（搜索）→ timeline（时间线）→ getobservations（查看细节），从粗到细三层工作流 | 38| 39|## 安装步骤（手把手版） 40| 41|### 前置条件 42| 43|安装之前，确保你的电脑上有这些东西： 44| 45|| 依赖 | 要求 | 说明 | 46||------|------|------| 47|| Node.js | 18 或更高版本 | 大部分开发者应该已经有了，没有的话去 nodejs.org 下载 | 48|| Claude Code | 最新版（支持插件） | 如果你还在用旧版本，需要先更新 | 49|| Bun | 无需手动安装 | 安装过程会自动帮你装好 | 50|| uv | 无需手动安装 | 同上，自动安装 | 51|| SQLite3 | 无需手动安装 | 程序内置，不用操心 | 52| 53|检查 Node.js 版本的命令： 54| 55|``bash 56|node -v 57|` 58| 59|如果显示 v18.x.x 或更高，就没问题。如果版本低或者没有安装，去 Node.js 官网下载 LTS 版本即可。 60| 61|### 方式一：一行命令安装（推荐） 62| 63|这是最简单的方式，适合大多数人。 64| 65|Mac / Linux 用户： 66| 67|打开终端，复制粘贴这行命令回车： 68| 69|`bash 70|npx claude-mem install 71|` 72| 73|等待一分钟左右，你会看到安装成功的提示。期间它会自动下载 Bun 和 uv 等依赖，不需要你操心。 74| 75|Windows 用户： 76| 77|打开 PowerShell（推荐）或 CMD，同样执行： 78| 79|`bash 80|npx claude-mem install 81|` 82| 83|> 💡 Windows 用户注意：如果你遇到权限相关的报错，试试以管理员身份运行 PowerShell 再执行。如果 npx 命令报错，确认 Node.js 已经正确安装并且重启了终端。 84| 85|### 方式二：在 Claude Code 内安装（插件市场方式） 86| 87|如果你已经在用 Claude Code，可以直接在里面操作： 88| 89|1. 打开 Claude Code 90|2. 输入以下命令添加插件源： 91| 92|` 93|/plugin marketplace add thedotmack/claude-mem 94|` 95| 96|3. 然后安装插件： 97| 98|` 99|/plugin install claude-mem 100|` 101| 102|这种方式的好处是全程在 Claude Code 内完成，不用切换到终端。 103| 104|### 方式三：Gemini CLI 用户 105| 106|如果你用的是 Google 的 Gemini CLI 工具，安装命令稍作修改： 107| 108|`bash 109|npx claude-mem install --ide gemini-cli 110|` 111| 112|Mac、Linux、Windows 都是这个命令，区别只是你在哪个终端里执行。 113| 114|### 方式四：OpenCode 用户 115| 116|`bash 117|npx claude-mem install --ide opencode 118|` 119| 120|### 方式五：OpenClaw 网关用户 121| 122|OpenClaw 是一种 AI 网关方案，安装方式不同，用的是 shell 脚本： 123| 124|Mac / Linux： 125| 126|`bash 127|curl -fsSL https://install.cmem.ai/openclaw.sh | bash 128|` 129| 130|Windows 用户： 暂不支持此方式，建议使用 WSL（Windows Subsystem for Linux）后执行，或者用前面的一行命令方式安装。 131| 132|### 安装成功后的确认 133| 134|安装完成后，你可以通过以下方式确认是否正常工作： 135| 136|1. 打开 Claude Code，随便开始一个对话 137|2. 执行一些操作（比如让它读个文件、改个代码） 138|3. 打开浏览器，访问 http://localhost:37777 139|4. 如果能看到 Web 查看器界面，说明安装成功 140| 141|### 配置文件说明 142| 143|安装完成后，配置文件在： 144| 145|` 146|~/.claude-mem/settings.json 147|` 148| 149|你可以用任何文本编辑器打开它（比如 VS Code）： 150| 151|`bash 152|# Mac / Linux 153|code ~/.claude-mem/settings.json 154| 155|# Windows（在 PowerShell 中） 156|code $env:USERPROFILE\.claude-mem\settings.json 157|` 158| 159|主要配置项： 160| 161|| 配置项 | 说明 | 默认值 | 162||--------|------|--------| 163|| AI 模型 | 用于压缩摘要的模型 | 跟随 Claude Code 默认模型 | 164|| worker 端口 | 后台服务端口 | 37777 | 165|| 数据目录 | 记忆数据存储位置 | ~/.claude-mem/data | 166|| 日志级别 | 日志详细程度 | info | 167| 168|### 开启中文模式（强烈推荐国内开发者设置） 169| 170|claude-mem 支持中文模式，设置方式是通过环境变量： 171| 172|Mac / Linux（添加到 ~/.bashrc 或 ~/.zshrc）： 173| 174|`bash 175|export CLAUDEMEMMODE=code--zh 176|` 177| 178|保存后执行 source ~/.bashrc 或 source ~/.zshrc 使其生效。 179| 180|Windows（PowerShell，以管理员身份执行）： 181| 182|`powershell 183|[System.Environment]::SetEnvironmentVariable('CLAUDEMEMMODE', 'code--zh', 'User') 184|` 185| 186|设置后重启终端。 187| 188|开启中文模式后，mem-search 搜索和 AI 摘要都会以中文输出，体验更自然。 189| 190|## 使用方法（从简单到进阶） 191| 192|### 基础用法：自动记忆（装完就能用） 193| 194|安装完 claude-mem 之后，你什么都不用做，它就开始工作了。 195| 196|每次你在 Claude Code 里编程——读文件、写代码、跑测试、查日志——claude-mem 都在后台默默记录。会话结束后，它会自动用 AI 把这次会话压缩成一段摘要保存起来。 197| 198|下次你开新对话时，claude-mem 会根据你提到的话题，自动把相关历史注入到 Claude 的上下文中。比如你说"继续改那个登录页"，Claude 就能"想起"上次改了什么。 199| 200|这一步完全不需要你操作，装完即用。 201| 202|### 进阶用法一：用 mem-search 搜索历史记忆 203| 204|这是最实用的功能之一。假设你想找之前的一个操作但又记不清具体内容了，直接用自然语言搜索： 205| 206|在 Claude Code 中输入： 207| 208|` 209|/mem-search 上次处理支付接口的时候改了哪些文件 210|` 211| 212|或者： 213| 214|` 215|/mem-search 三天前那个数据库迁移的 bug 是怎么修的 216|` 217| 218|claude-mem 会用内置的 Chroma 向量数据库做混合搜索——不光匹配关键词，还匹配"意思"。所以哪怕你搜索的措辞跟当时记录的不完全一样，也能找到相关内容。 219| 220|搜索结果会按相关度排序，最相关的排在最前面。 221| 222|### 进阶用法二：Web 查看器回顾记忆流 223| 224|浏览器打开： 225| 226|` 227|http://localhost:37777 228|` 229| 230|你会看到一个可视化界面，按时间线展示了所有记忆。就像翻看一本"项目日记"——哪天改了什么、为什么改、改完效果怎样，一目了然。 231| 232|这个功能特别适合： 233|- 回顾自己一周内都做了什么（写周报神器！） 234|- 排查某个 bug 是什么时候引入的 235|- 新成员了解项目演进历史 236| 237|### 高级用法：隐私控制 + MCP 三层搜索 238| 239|#### 隐私控制 240| 241|有些代码是敏感的，比如数据库密码、API 密钥、私有算法等。你不想让这些内容被记到记忆里，可以用 <private> 标签： 242| 243|` 244|请帮我连接数据库，连接信息如下： 245|<private> 246|host: 192.168.1.100 247|password: mysecretpassword 248|</private> 249|` 250| 251|被 <private> 包裹的内容不会被记录到记忆中。 252| 253|#### MCP 三层搜索工作流 254| 255|claude-mem 提供了三个 MCP 搜索工具，按从粗到细的顺序使用： 256| 257|1. search：关键词或语义搜索，找到相关的记忆条目 258|2. timeline：查看某段时间内的操作时间线，了解先后顺序 259|3. getobservations：深入查看某条记忆的完整细节 260| 261|举个例子：你想回顾上周重构用户系统的整个过程： 262| 263|- 先用 search 搜索"用户系统重构"，找到几条相关记忆 264|- 再用 timeline 查看这几条记忆对应的时间段，理清操作顺序 265|- 最后用 getobservations 查看关键节点的详细操作内容 266| 267|这套工作流让你既能看到全貌，又能深入细节，非常强大。 268| 269|## 实际场景举例 270| 271|| 场景 | 怎么用 claude-mem | 272||------|-------------------| 273|| 昨天改了登录模块，今天想继续 | 无需任何操作，开新对话直接说"继续改登录模块"，Claude 自动知道上次改了什么 | 274|| 想回顾过去一周做了哪些功能 | 打开 Web 查看器 localhost:37777，按时间线浏览，直接截图写周报 | 275|| 搜索三个月前处理过的一个线上 bug | 用 mem-search 搜索"那个内存泄漏的线上 bug"，秒定位到当时的操作记录 | 276|| 新人加入项目，想了解演进历史 | 通过 Web 查看器或 mem-search，快速浏览项目过去的故事线，比读 wiki 直观得多 | 277|| 项目涉及敏感信息 | 用 <private> 标签排除密码、密钥等敏感内容，防止泄露到记忆中 | 278|| 同时开发多个项目 | claude-mem 按项目自动区分记忆，不同项目的记忆互不干扰 | 279|| 想省钱，减少 token 消耗 | 渐进式上下文披露只注入最相关的内容，而不是一股脑全塞给 AI | 280|| 用中文开发更顺手 | 设置 CLAUDEMEM_MODE=code--zh，搜索和摘要全部中文化 | 281| 282|## 跟同类方案对比 283| 284|目前给 AI 加"记忆"的方案不止 claude-mem 一个，下面是跟常见方案的对比： 285| 286|| 对比维度 | claude-mem | 手动复制粘贴上下文 | Claude 自带的对话历史 | 其他记忆插件 | 287||----------|-----------|-------------------|---------------------|-------------| 288|| 是否需要手动操作 | 全自动，装完即用 | 每次都要复制粘贴 | 不需要，但仅限同一会话 | 多数需要手动触发 | 289|| 跨会话记忆 | ✅ 支持，新会话自动继承 | 需要你自己找、自己贴 | ❌ 关闭会话就没了 | 部分支持 | 290|| 记忆压缩 | ✅ AI 自动压缩摘要 | 无压缩，原文越来越长 | 无压缩 | 部分有，质量参差不齐 | 291|| 自然语言搜索 | ✅ 语义+关键词混合搜索 | 只能肉眼看 | 只能翻聊天记录 | 多数只支持关键词搜索 | 292|| 隐私保护 | ✅ <private> 标签排除 | 你自己判断 | 无保护 | 少数有类似功能 | 293|| 中文支持 | ✅ code--zh 中文模式 | ✅ 天然支持 | ✅ 支持 | 多数不支持 | 294|| 多 IDE 支持 | ✅ Claude Code/Desktop、Gemini CLI、OpenCode | ✅ 处处可用 | 仅限 Claude 生态 | 通常只支持一种 | 295|| 可视化界面 | ✅ Web 查看器 | 无 | 无 | 少数有 | 296|| Token 节省 | ✅ 渐进式上下文披露 | 常常超限 | 越聊越长 | 普遍较费 | 297|| Star 数量 | 58K+ | — | — | 远低于此 | 298|| 维护活跃度 | 极高，今日新增2300+星 | — | — | 参差不齐 | 299| 300|一句话总结：claude-mem 是目前最成熟、最省心、生态最广的 AI 编程记忆方案。其他方案要么不够自动化，要么功能太单一，要么不支持中文，综合体验差距明显。 301| 302|## 常见问题 303| 304|Q：claude-mem 会不会让我的代码泄露？ 305| 306|A：所有记忆数据存储在你本地（~/.claude-mem/data），不会上传到任何第三方服务器。如果你有特别敏感的内容，用 <private> 标签包裹即可排除。 307| 308|Q：会不会占很多磁盘空间？ 309| 310|A：不会。因为用了 AI 压缩摘要，原始对话不会完整保存，只保留最关键的信息。项目运行几个月也就几十 MB。 311| 312|Q：会不会拖慢 Claude Code 的速度？ 313| 314|A：记忆压缩是在后台异步进行的，不会阻塞你的编程操作。上下文注入采用渐进式披露，只注入最相关的少量内容，对性能几乎没有影响。 315| 316|Q：我换了电脑怎么办？ 317| 318|A：把 ~/.claude-mem/data 目录拷贝到新电脑的对应位置就行，所有记忆都会跟着迁移。 319| 320|Q：支持哪些操作系统？ 321| 322|A：Mac、Windows、Linux 全平台支持。Windows 用户建议用 PowerShell 或 WSL，体验更好。 323| 324|Q：Claude Desktop 也能用吗？ 325| 326|A：可以！claude-mem 同时支持 Claude Code 和 Claude Desktop。 327| 328|## 小结 329| 330|claude-mem 让 Claude Code 从"每次对话都失忆的实习生"变成了"记得住所有事情的靠谱搭档"——自动记录、智能压缩、精准搜索、隐私可控、中文友好，58K Star 说明了一切。 331| 332|项目地址：https://github.com/thedotmack/claude-mem 333| 334|一行命令安装：npx claude-mem install`，装完立刻就能感受到差别。", 335| "type": "ARTICLE", 336| "tags": ["Claude Code", "AI记忆", "开源工具", "编程效率", "持久记忆"], 337| "categoryName": "工程实践" 338|