Agent之Memory：claude-mem的简介、安装和使用方法、案例应用之详细攻略
目录
[T1、Claude Code 安装](#T1、Claude Code 安装)
[T2、Gemini CLI 安装](#T2、Gemini CLI 安装)
[T3、OpenCode 安装](#T3、OpenCode 安装)
[T4、通过 Claude Code 插件市场安装](#T4、通过 Claude Code 插件市场安装)
[（3）查看 Web Viewer](#（3）查看 Web Viewer)
[案例四：AI Agent 长周期自动化任务](#案例四：AI Agent 长周期自动化任务)
[案例五：个人开发者 AI 编程助手增强](#案例五：个人开发者 AI 编程助手增强)
claude-mem 的简介
Claude-Mem 是一个面向 Claude Code 的持久化记忆系统插件，旨在解决 AI 编程助手在不同会话之间无法持续保留项目上下文的问题。该项目通过自动捕获 Agent 在开发过程中的工具调用行为（Tool Usage Observations），利用 AI 对这些信息进行语义压缩和总结，并在后续会话中重新注入相关上下文，使 Claude 能够持续理解项目历史状态，而无需用户反复解释背景信息。
Claude-Mem 的核心理念是"让 AI Agent 拥有长期记忆能力"。传统 AI 编程会话通常受到上下文窗口限制，当会话结束、重新连接或开启新任务时，之前的架构设计、代码修改记录、问题分析过程等信息容易丢失。Claude-Mem 通过生命周期 Hooks、后台 Worker 服务、SQLite 数据库存储以及语义检索机制，将开发过程中的重要信息进行结构化保存，并在需要时智能恢复。
从架构角度看，Claude-Mem 由多个核心组件组成，包括生命周期 Hooks、Worker Service、SQLite 数据库、mem-search 技能以及 Chroma 向量数据库。其中 Hooks 负责监听 Claude Code 工作过程中的关键事件；Worker Service 提供 HTTP 服务处理记忆管理逻辑；数据库负责保存会话、观察记录和摘要；搜索模块则通过自然语言查询实现历史上下文检索。
1 、特点
|-----------------------------------------|----------------------------------------------------------------------------------|
| 特点 | 详细说明 |
| 持久化记忆（Persistent Memory） | Claude-Mem 可以跨会话保存项目上下文，使 Claude 在新的开发会话中继续理解之前完成的工作内容，包括代码修改、设计决策和开发过程中的关键观察信息。 |
| 自动捕获开发过程 | 系统通过生命周期 Hooks 自动记录 Agent 行为，不需要开发者手动整理笔记或维护上下文文件，可以持续捕获 Claude Code 的工具调用和操作过程。 |
| AI 驱动的信息压缩 | Claude-Mem 使用 Claude Agent SDK 对原始观察记录进行语义总结，将大量过程信息转换为更高价值、更易检索的上下文摘要。 |
| 渐进式信息披露（Progressive Disclosure） | Claude-Mem 不会一次性加载所有历史信息，而是根据任务需求逐层获取相关记忆，同时提供 Token 成本可见性，降低上下文浪费。 |
| 智能语义搜索 | 通过 mem-search 技能和 Chroma 向量数据库，用户可以使用自然语言查询历史项目内容，实现基于语义理解的上下文检索。 |
| 多组件架构设计 | 项目包含生命周期 Hooks、Worker Service、SQLite 存储、搜索服务和 Web Viewer 等多个模块，各模块职责清晰，便于扩展和维护。 |
| Web Viewer 可视化界面 | Claude-Mem 提供 Web Viewer UI，可以实时查看记忆流、历史观察记录以及系统生成的上下文信息。 |
| 隐私控制能力 | 支持通过 <private> 标签标记不希望保存的敏感内容，使用户能够控制哪些信息进入长期记忆系统。 |
| 自动化运行 | 安装完成后，Claude-Mem 可以自动工作，无需用户在每次会话开始前手动加载历史资料。 |
| 多环境支持 | 除 Claude Code 外，项目还支持 Gemini CLI、OpenCode、OpenClaw 等环境，通过不同安装方式接入持久化记忆能力。 |
| 历史引用能力 | Claude-Mem 支持通过 Observation ID 引用过去的观察记录，使用户能够追踪具体历史信息来源。 |
| 本地数据管理 | 项目采用 SQLite 存储会话、观察记录和摘要信息，强调对 Agent 长期记忆数据的管理能力。 |
claude-mem 的安装和使用方法
1、安装
Claude-Mem 官方推荐通过 npx claude-mem install 方式安装，该方式会完成插件注册、Hooks 配置以及 Worker 服务初始化。项目特别说明，直接执行 npm install -g claude-mem 只会安装 SDK/库文件，并不会自动注册插件 Hooks 或启动 Worker 服务，因此不推荐作为完整安装方式。
T1、 Claude Code 安装
执行：
npx claude-mem install安装完成后，需要重新启动 Claude Code，使插件 Hooks 和记忆服务生效。之后，新会话会自动加载之前保存的项目上下文。
T2、 Gemini CLI 安装
Claude-Mem 支持 Gemini CLI 环境，可以执行：
npx claude-mem install --ide gemini-cli安装程序会自动识别 Gemini CLI 环境并完成相关配置。
T3、 OpenCode 安装
对于 OpenCode 环境：
npx claude-mem install --ide opencode即可完成插件安装。
T4、 通过 Claude Code 插件市场安装
也可以在 Claude Code 内执行：
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem完成插件安装。
2、使用方法
（1）自动记忆模式
Claude-Mem 安装后无需额外操作即可运行。
其工作流程如下：
Claude Code 开始执行任务；
生命周期 Hooks 捕获关键操作；
Worker Service 接收并处理观察数据；
AI 模型对操作记录进行压缩总结；
信息保存到 SQLite 数据库；
后续会话通过搜索机制恢复相关上下文。
（2）查询历史项目记忆
Claude-Mem 提供 mem-search 技能，用户可以通过自然语言查询过去的开发记录，例如：
"之前为什么选择这个数据库？"
"上次修复登录 Bug 使用了什么方案？"
"这个模块之前有哪些设计决定？"
系统会根据语义匹配历史观察记录，并返回相关上下文。
（3）查看 Web Viewer
Claude-Mem 提供实时 Web Viewer UI，可以访问：
查看：
当前记忆流；
历史观察记录；
系统生成的摘要；
记忆检索结果。
（4）配置运行模式
Claude-Mem 支持通过配置文件调整工作模式，例如语言模式：
配置文件：
~/.claude-mem/settings.json
示例：
{
"CLAUDE_MEM_MODE": "code--zh"
}其中：
code：默认英文模式；
code--zh：中文模式；
code--ja：日文模式。
修改后需要重新启动 Claude Code 才能生效。
（5）隐私信息控制
如果某些内容不希望被保存到长期记忆，可以使用：
<private>
敏感内容
</private>
Claude-Mem 会跳过这些内容的存储。
claude-mem 的案例应用
案例一：大型软件项目持续开发中的上下文保持
在长期的软件开发项目中，开发人员通常需要持续数周甚至数月维护同一个代码库。由于 AI 会话存在上下文限制，新会话往往无法知道此前完成的架构调整、代码重构原因以及历史 Bug 修复方案。
通过 Claude-Mem：
开发人员每天使用 Claude Code 编写和修改代码；
Claude-Mem 自动记录代码分析、文件修改、工具调用过程；
系统生成项目历史摘要；
后续开发会话启动时自动恢复相关背景信息；
Claude 可以继续基于过去决策进行开发。
例如，当开发人员询问：
"为什么这个 API 使用这种认证方式？"
Claude 可以通过历史记忆检索之前的设计讨论，而无需重新分析整个项目。
案例二：复杂代码重构任务管理
大型代码重构通常涉及多个阶段，包括：
当前代码分析；
架构设计；
模块拆分；
测试调整；
性能优化。
如果每次重新开启 AI 会话，都需要重新说明重构目标，会降低开发效率。
使用 Claude-Mem 后：
第一次会话中记录重构计划；
Claude-Mem 保存模块调整过程；
后续会话自动获取历史重构状态；
Claude 可以继续执行未完成任务。
例如：
第一阶段完成数据库层重构；
第二阶段继续优化 API 层；
第三阶段补充测试。
整个过程可以保持连续性。
案例三：团队知识沉淀与项目维护
对于多人维护的软件项目，新成员通常需要花费大量时间理解：
项目结构；
技术选型原因；
历史问题；
重要开发决策。
Claude-Mem 可以作为 AI Agent 的项目知识库：
自动积累开发过程信息；
保存关键技术决策；
提供历史上下文搜索；
帮助 Claude 快速理解项目。
例如，新成员向 Claude 提问：
"这个服务为什么没有采用微服务拆分？"
Claude 可以检索过去的设计讨论，并结合历史记录给出解释。
案例四：AI Agent 长周期自动化任务
对于需要持续运行的 AI Agent，例如：
自动代码维护 Agent；
项目监控 Agent；
自动化测试 Agent；
短期上下文不足以支撑长期任务。
Claude-Mem 可以提供：
长期任务状态保存；
历史执行过程记录；
下一阶段任务上下文恢复；
Agent 连续工作能力增强。
通过持久化记忆机制，AI Agent 不再是一次性执行工具，而可以逐渐形成持续工作的智能助手。
案例五：个人开发者 AI 编程助手增强
个人开发者通常同时维护多个项目，容易遇到：
忘记之前修改内容；
重复解释项目背景；
找不到历史解决方案。
使用 Claude-Mem 后：
每个项目形成独立记忆；
Claude 自动保存开发历史；
用户通过自然语言查询过去经验；
AI 辅助效率持续提升。
例如：
"去年这个项目遇到的部署问题怎么解决？"
Claude 可以通过历史观察记录快速定位相关方案。