夜雨聆风
Claude-Mem：给你的 AI 编程助手装上记忆
在 GitHub 的海洋里，每天都有让人眼前一亮的新项目诞生。
Claude-Mem
不少人在使用 Claude Code、Gemini CLI 这类 AI 编程代理时都有同一种感受：每次新开一个会话，就像换了一个完全不了解前因后果的临时工，之前反复沟通好的设计决策、环境细节、调试路径统统归零。Claude-Mem 就是为了消除这种“失忆症”而出现的。它能静默记录代理在会话中做的每一件事，用 AI 压缩、提炼出关键线索，并在后续会话里自动把相关的上下文塞回去，让 AI 助手终于可以带着记忆工作。
一句话定位：一个面向 AI 编码代理的持久化记忆层，支持跨会话的上下文自动捕获、压缩与注入，原生兼容 Claude Code、Gemini CLI 和 OpenCode。
核心能力与实现特点
- 全自动记忆流转
：不需要手动保存或粘贴，代理的每一次操作都会被捕获，经过 AI 压缩后转化为结构化记忆。新会话启动时，与当前任务相关的历史信息会自动注入，整个过程完全无感。 - 渐进式记忆检索
：采用分层的记忆披露机制，你可以直观地看到每次注入消耗了多少 token，对成本有清晰预期。 - 内置搜索技能
：提供 `mem-search` 技能，在代理对话中就能直接查询项目历史，不用跳出工作流。 - 本地 Web 查看器
：启动后在 `http://localhost:37777` 提供实时记忆流界面，可以浏览、管理所有记忆记录。 - 隐私控制
：支持用 ` ` 标签包裹不想被存储的敏感内容，给临时不适合入库的信息留了一扇后门。 - 细粒度上下文配置
：可以自定义注入哪些类型的上下文，避免无关记忆占用窗口。 - 引用追溯
：每条记忆都有唯一 ID，可以通过 API（`http://localhost:37777/api/observation/{id}`）或 Web 查看器引用和回溯。 - 实验性 Beta 频道
：通过 Web 界面就能切换到 Beta 版本，体验 Endless Mode（仿生记忆架构），用于处理超长会话。
安装与上手
安装途径很直接，首选通过 npx 一条命令搞定基础环境：
bash
npx claude-mem install如果你使用的是 Gemini CLI，可以加上对应的安装标记，安装程序会自动识别 ~/.gemini 路径：
bash
npx claude-mem install --ide gemini-cli类似的，面向 OpenCode 的安装命令是：
bash
npx claude-mem install --ide opencode除了命令行方式，Claude Code 还支持从插件市场直接添加，在 Claude Code 内执行：
bash
/plugin marketplace add thedotmack/claude-mem/plugin install claude-mem安装完成后，重启 Claude Code 或 Gemini CLI，此前会话中沉淀下来的上下文就会自动出现在新的会话里。
有一点需要特别注意：Claude-Mem 虽然发布在 npm，但 npm install -g claude-mem 安装的只是 SDK 函数库，不会注册插件钩子，也不会启动后台工作服务。要想获得开箱即用的记忆能力，务必使用上面的 npx claude-mem install 或插件安装方式。
另外，Claude-Mem 还提供了面向 OpenClaw 网关的一键部署脚本，让记忆能力可以接入更广泛的渠道：
bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash该安装程序会自动处理依赖项、插件设置、AI 提供商配置以及工作进程启动，并支持将实时观察推送到 Telegram、Discord、Slack 等工具。
适用场景
适合经常在 Claude Code、Gemini CLI 或 OpenCode 中进行长周期项目开发的工程师。比如同一个功能需要在多天多轮对话中迭代，或者前后几个任务共享同一份项目背景时，Claude-Mem 可以省去大量重复的背景交代。通过 OpenClaw 网关，它也适合希望跨团队或跨工具共享代理记忆的开发者。
适合人群
AI 辅助编码工具的深度用户，尤其重视任务连贯性、不愿反复粘贴上下文的人。对工具链集成不排斥，愿意尝试用插件扩展默认体验的开发人员会更受用。
使用边界
目前主要支持的代理前端为 Claude Code、Gemini CLI 和 OpenCode，更广泛的集成依赖 OpenClaw 网关串联。隐私控制需要用户主动使用 <private> 标签，不适合自动过滤所有敏感信息，切勿在对话中直接暴露密钥等机密。Beta 频道中的 Endless Mode 尚处于实验阶段，长期运行的稳定性还需自行评估。记忆数据保留在本地，Web 查看器仅面向本地回环地址，没有内置的远程共享能力（除非通过 OpenClaw 网关配置）。
总结
Claude-Mem 用一种非常薄的方式补上了 AI 编码代理缺失的那块拼图：连续的记忆。它不要求你搭建向量数据库，也不需要每次都手动粘贴长长的背景文档。一条命令安装后，代理就默默开始记住你每一次的需求、每一次的决策，并在下次对话中把这些上下文重新组装回来。如果你想让自己常用的 AI 编程搭档从“单次任务助手”升级成真正了解项目历史的协作伙伴，这个项目值得一试。
拆解AI，遇见下一个十年。
