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
