5分钟上手 Claude-Mem

本指南将帮助你在5分钟内安装并启动Claude-Mem,让Claude AI在编程会话中拥有持久记忆能力

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js >= 18.0 必需

所需工具

Git

克隆项目代码

必需
Claude Code

Claude AI的代码编辑器插件

必需

操作步骤

1

克隆项目

将Claude-Mem项目克隆到本地

克隆项目到当前目录
git clone https://github.com/thedotmack/claude-mem.git

预期结果:项目文件夹 claude-mem 被成功创建

确保你有稳定的网络连接

2

安装依赖

进入项目目录并安装必要的依赖包

进入项目目录
cd claude-mem
安装项目依赖
npm install

预期结果:看到依赖包安装进度,最后显示安装完成

如果遇到权限问题,可以尝试使用 sudo(仅限macOS/Linux)

3

启动Claude-Mem服务

启动记忆压缩系统的后台服务

启动Claude-Mem服务
npm start

预期结果:看到服务启动日志,包括端口信息和启动状态

服务默认运行在端口37777,确保该端口未被占用

4

在Claude Code中启用

打开Claude Code并启用记忆功能

在Claude Code中启动记忆系统
在Claude Code中新建会话,输入:
/cmem start

预期结果:Claude会确认记忆系统已启动,并开始记录操作

确保Claude Code已安装并正常运行

验证成功

确认Claude-Mem已成功运行并开始工作

在浏览器中访问 http://localhost:37777 能看到Web查看界面
Claude Code会话中显示记忆系统已启动的确认信息
后续的Claude Code会话会自动显示之前的上下文

快速提示

配置

使用 /cmem search 命令在Claude Code中搜索历史记忆

调试

Web界面实时显示记忆流,方便查看Claude的操作记录

配置

记忆数据存储在本地SQLite数据库中,确保隐私安全

常见问题

1

npm install 失败,显示权限错误

尝试使用 sudo npm install 或修改npm全局安装目录权限

2

端口37777被占用

修改项目配置中的端口号,或关闭占用该端口的程序

3

Claude Code中 /cmem 命令无效

确保Claude-Mem服务正在运行,并重启Claude Code会话

4

Web界面无法访问

检查防火墙设置,确保允许本地端口37777的访问

下一步

探索Web查看界面

访问 http://localhost:37777 查看实时记忆流和项目历史

尝试记忆搜索功能

在Claude Code中使用 /cmem search 命令搜索项目历史

查看配置选项

查看 ~/.claude-mem/settings.json 文件自定义记忆系统设置

助手