79.3K+ star 的 AI 记忆插件:让 Claude Code 跨越会话记住一切

AI 每次新对话都是从零开始？代码写到一半换了 Session，上下文全丢了——这种痛，Claude Code 用户太熟悉了。Claude-Mem 彻底解决这个痛点：79.3K+ stars 开源社区验证，它能让 AI Agent「记住」每个项目的上下文，自动压缩历史会话，注入新会话的相关记忆。

01 它是什么？

Claude-Mem 是一个持久化上下文压缩系统，专为 AI 编程助手设计。它的核心逻辑很简单：自动记录每次会话中 Agent 使用的工具、产生的观察和决策，通过 AI 生成语义摘要，下一次会话开始时自动将相关记忆注入上下文。

与同类项目的差异：

• 开箱即用：
  一条 npx claude-mem install 命令完成全部配置，无需手动管理记忆文件
• 多 Agent 支持：
  不只支持 Claude Code，还支持 OpenClaw、Codex、Gemini CLI、Hermes、Copilot、OpenCode 等 10+ 主流 AI 编程工具
• 三层检索架构：
  search → timeline → get_observations，按需获取记忆细节，相比直接拉取全部上下文节省约 10 倍 Token
• 本地优先：
  SQLite + Chroma 向量数据库，所有数据存储在本地，支持 <private> 标签保护敏感内容

02 核心原理/亮点

Claude-Mem 的架构由 5 大组件构成：

记忆注入流程：

1. Agent 在会话中使用工具 → PostToolUse 钩子捕获观察

2. Worker Service 将观察摘要压缩存储到 SQLite + Chroma

3. 下次 SessionStart 时，根据当前项目上下文自动检索相关记忆

4. 注入上下文时按 Token 成本分层显示（ Progressive Disclosure）

03 应用场景

Claude-Mem 适合谁：

• 长期维护复杂项目的开发者（记忆之前解决过的 bug、架构决策）

• 多项目并行的工程师（新会话切入时无需重新解释项目背景）

• 需要研究代码库结构的 AI 编程助手用户

典型使用场景：

• 项目中途换了 Session，AI 自动「记起」上次修复的数据库迁移问题

• 问 AI「上次这段代码是谁改的、为什么改」，直接得到历史上下文

• 开启 Endless Mode（Beta），让记忆架构更贴近生物本能式持续学习

▶️ 观看演示（https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif）

04 快速上手

一条命令完成安装，自动检测并配置对应的 AI Agent 环境：

#Claude Codenpx claude-mem install#Gemini CLInpx claude-mem install --ide gemini-cli#OpenCodenpx claude-mem install --ide opencode

配置文件位置：~/.claude-mem/settings.json（首次运行自动创建），可配置 AI 模型、端口、数据目录、语言模式等。

切换中文模式（内置支持，无需额外安装插件）：

{  "CLAUDE_MEM_MODE": "code--zh"}

安装完成后重启 Agent，之前的项目上下文就会自动出现在新会话中。

写在最后

Claude-Mem 解决了一个长期被忽视但极其影响效率的问题：AI 编程助手的记忆缺失。通过自动化的上下文捕获 + AI 压缩 + 智能检索，它让 AI Agent 从「每次都是陌生人」变成「了解你项目的长期搭档」。TypeScript 开源，架构清晰，79.3K+ stars 的社区背书，值得一试。

相关链接

• GitHub 仓库：
  https://github.com/thedotmack/claude-mem
• 官方文档：
  https://docs.claude-mem.ai/
• 项目官网：
  https://claude-mem.ai
• Discord 社区：
  https://discord.com/invite/J4wttp9vDu