Repolode
thedotmack

thedotmack/claude-mem

为编码智能体提供跨会话的持久记忆,自动记录会话活动并用 AI 压缩,再把相关上下文注入后续会话。

Star
101,763
Fork
8,950
未关闭 Issue
92
最近提交
昨天

这是什么?

Claude-Mem 是为 AI 编码智能体设计的记忆层。它记录每次会话中的工具调用和观察结果,用 AI 模型生成压缩后的语义摘要,并在之后的会话开始时将相关内容注入上下文,使智能体在会话结束或重新连接后仍能延续对项目的理解。

项目以 Claude Code 的生命周期钩子为核心,并提供 OpenCode、Codex、OpenClaw、T3 Code 等宿主的安装方式。本地 worker 服务提供 HTTP API 和网页查看器,数据存储在 SQLite 中并支持 FTS5 全文检索,同时通过 Chroma 实现向量检索,可将语义与关键词搜索结合。

智能体通过四个 MCP 工具按三层流程查询记忆:先获取紧凑的搜索索引,再查看匹配结果前后的时间线,最后仅对选定的 ID 获取完整详情。用 private 标签包裹的内容不会被存储,另有模式设置可调整工作流风格和生成观察记录的语言。

核心功能

  • 01通过生命周期钩子自动记录工具调用和会话观察。
  • 02使用 AI 模型将会话活动压缩为语义摘要。
  • 03在新会话启动时注入相关的历史上下文。
  • 04提供 MCP 搜索工具,采用节省 token 的三层检索流程。
  • 05结合 SQLite 全文检索与 Chroma 向量检索。
  • 06内置本地网页查看器和 HTTP API,便于浏览记忆内容。

适用场景

  • 在长期维护的代码库中,跨多次 Claude Code 会话保持项目上下文。
  • 让智能体回忆之前的 bug 修复和设计决策,无需重新阅读完整对话记录。
  • 通过 MCP 工具按关键词、类型或日期检索过往的智能体工作记录。

快速上手

  1. 1

    使用一条命令安装插件

    npx claude-mem install
  2. 2

    在浏览器中登录 claude-mem(邮件魔术链接)或选择记忆服务提供方

  3. 3

    重启 Claude Code,之前会话的上下文将出现在新会话中

使用前须知

  • 登录后可使用 claude-mem 观察器,享有 30 天免费试用;试用结束后,除非订阅,记忆将回退到你的 Anthropic 套餐。
  • npm 包仅安装 SDK/库,若要获得钩子和工作服务,请使用 npx 安装程序或 /plugin 命令。
  • 需要 Node.js 20 或更高版本。

标签

常见问题

claude-mem 是什么?
为编码智能体提供跨会话的持久记忆,自动记录会话活动并用 AI 压缩,再把相关上下文注入后续会话。 Claude-Mem 是为 AI 编码智能体设计的记忆层。它记录每次会话中的工具调用和观察结果,用 AI 模型生成压缩后的语义摘要,并在之后的会话开始时将相关内容注入上下文,使智能体在会话结束或重新连接后仍能延续对项目的理解。
claude-mem 可以免费使用吗?用的什么许可证?
claude-mem 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
claude-mem 还在维护吗?
活跃维护中。claude-mem 最近一次提交是在 2026年10月19日。
claude-mem 适合用来做什么?
在长期维护的代码库中,跨多次 Claude Code 会话保持项目上下文。 让智能体回忆之前的 bug 修复和设计决策,无需重新阅读完整对话记录。 通过 MCP 工具按关键词、类型或日期检索过往的智能体工作记录。
claude-mem 怎么安装和运行?
使用一条命令安装插件: npx claude-mem install 在浏览器中登录 claude-mem(邮件魔术链接)或选择记忆服务提供方 重启 Claude Code,之前会话的上下文将出现在新会话中
在哪里获取 claude-mem?
源代码和安装说明在 GitHub 上:https://github.com/thedotmack/claude-mem

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目