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 大组件构成：

组件	作用
6 个生命周期钩子	SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd 在关键节点自动触发记录
Worker Service	本地 HTTP 服务（默认 37777 端口），管理数据库和 Chroma，向 Agent 提供搜索 API
SQLite 数据库	持久化存储 sessions、observations、summaries，支持 FTS5 全文搜索
Chroma 向量库	混合语义 + 关键词搜索，智能检索相关记忆
mem-search Skill	自然语言查询接口，支持渐进式披露（Progressive Disclosure）

记忆注入流程：

Agent 在会话中使用工具 → PostToolUse 钩子捕获观察
Worker Service 将观察摘要压缩存储到 SQLite + Chroma
下次 SessionStart 时，根据当前项目上下文自动检索相关记忆
注入上下文时按 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 的社区背书，值得一试。

01 它是什么？

02 核心原理/亮点

03 应用场景

04 快速上手

写在最后

相关链接