Claude-Mem 会自动记录在使用工具时的重要操作，并把这些信息整理成简明的摘要，留给后面的会话继续使用。

这样即使结束对话或重新连接，Claude 也能接着之前的进度，对项目始终保持连贯的理解。

• 持久记忆：对话结束也不会丢，上下文自动延续
• 项目上下文（CLAUDE.md）：在项目目录自动生成，记录关键过程和时间线
• 模式切换：不同工作流程之间切换（代码编写、邮件调查、休闲）
• 历史搜索（MCP）：用自然语言直接查项目里的历史记录
• 知识库：把过往操作整理成一个可查询的“记忆库”
• 可视化界面：实时查看记忆流（http://localhost:37777）
• 隐私控制：用 <private> 标记的内容不会被记录
• 上下文配置：可以精细控制哪些内容被注入
• 自动运行：全程自动记录，不用手动干预
• 全文搜索（FTS5）：快速查找所有历史内容
• 引用能力：可以用 ID 直接引用过去的记录

系统要求

• Node.js：v18.0.0 或更高版本
• Claude Code：最新版本，支持插件
• Bun：JavaScript 运行时和进程管理器（如果缺失则自动安装）
• SQLite 3：用于持久化存储（已捆绑）

快速安装

方式一：npx（推荐）

npx claude-mem install

方式二：插件市场

在终端中启动新的 Claude Code 会话并输入以下命令：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

自动加载

安装后启动自动配置钩子并启动工作服务。

启动一个新的 Claude Code 会话后，会看到之前会话的上下文信息已自动加载。

数据目录

数据存储在~/.claude-mem/：

• 数据库：~/.claude-mem/claude-mem.db
• PID 文件：~/.claude-mem/.worker.pid
• 端口文件：~/.claude-mem/.worker.port
• 日志：~/.claude-mem/logs/worker-YYYY-MM-DD.log
• 设置：~/.claude-mem/settings.json