学习目标:学会安装配置Claude-Mem,让Claude AI在编程会话中保持持久记忆,并能使用Web界面查看记忆流
前置知识
项目使用TypeScript开发,需要能理解基本的语法和类型
需要安装Node.js环境来运行项目,使用npm安装依赖
这是Claude-Mem的核心使用场景,需要在终端中使用Claude Code
需要在终端中执行安装和配置命令
学习步骤
环境准备
15分钟检查Node.js环境
打开终端,运行`node --version`和`npm --version`,确保Node.js版本在16以上
如果未安装Node.js,请先到官网下载安装
安装Claude Code插件
确保已在终端中安装并配置好Claude Code插件
Claude Code是Anthropic官方提供的终端插件,需要先完成设置
快速安装
20分钟克隆项目仓库
在终端中运行:`git clone https://github.com/thedotmack/claude-mem.git`
如果没有git,可以直接下载ZIP包解压
安装项目依赖
进入项目目录:`cd claude-mem`,然后运行:`npm install`
如果安装缓慢,可以尝试使用淘宝镜像:`npm config set registry https://registry.npmmirror.com`
构建项目
运行:`npm run build` 编译TypeScript代码
确保没有编译错误,如有错误请检查TypeScript版本
基础配置
15分钟启动Claude-Mem服务
运行:`npm start` 启动记忆系统
保持这个终端窗口运行,不要关闭
验证Web界面
打开浏览器访问 http://localhost:37777,确认能看到实时记忆流界面
如果无法访问,检查防火墙设置或端口是否被占用
首次使用
30分钟启动新的Claude Code会话
在新的终端窗口中启动Claude Code,按照README中的Quick Start部分输入初始化命令
确保Claude-Mem服务正在运行,否则无法建立连接
测试记忆功能
在Claude Code中编写一些代码,然后关闭会话,重新打开新的会话,观察Claude是否能记住之前的上下文
可以故意创建一些函数或变量,然后在新会话中询问Claude相关内容
核心功能体验
40分钟使用记忆搜索技能
在Claude Code中使用`mem-search`技能搜索项目历史,例如:`search 函数定义`
搜索功能需要先有一些历史记录才能看到效果
探索Web查看器
在浏览器中观察http://localhost:37777的实时记忆流,了解Claude-Mem如何记录和压缩信息
Web界面会显示Claude的所有操作记录和语义总结
测试Claude Desktop集成
如果使用Claude Desktop,尝试从桌面会话中搜索记忆
需要确保Claude Desktop正确配置了技能调用
进阶配置
20分钟查看配置文件
检查`~/.claude-mem/settings.json`文件,了解可配置选项
配置文件可能不存在,首次运行时会自动创建
了解隐私控制
学习如何使用`[代码]search[代码]timeline[代码]getobservations[代码]search`等命令控制记忆访问
这些命令用于管理记忆的检索和显示
推荐资源
包含快速开始、功能说明、配置选项等基本信息
更详细的技术文档和使用指南
查看常见问题和解决方案,或提交自己的问题
加入社区与其他用户交流使用经验
常见错误与避坑指南
忘记启动Claude-Mem服务
在使用Claude Code前,确保在另一个终端中运行`npm start`启动了Claude-Mem服务
端口冲突导致Web界面无法访问
如果37777端口被占用,可以检查配置文件修改端口,或关闭占用端口的程序
Claude Code会话中记忆不生效
确保按照Quick Start正确初始化了Claude Code会话,并检查Claude-Mem服务连接状态
构建时TypeScript编译错误
检查TypeScript版本,确保与项目要求一致,可以尝试删除node_modules重新安装
下一步探索
探索高级配置选项,了解记忆压缩算法原理,学习如何扩展Claude-Mem功能,或贡献代码到开源项目
相关项目推荐
freeCodeCamp/freeCodeCamp
freeCodeCamp.org开源代码库与课程体系,免费学习数学、编程与计算机科学
kamranahmedse/developer-roadmap
提供交互式学习路线图、指南和其他教育内容,帮助开发者在职业生涯中成长。
openclaw/openclaw
属于你个人的AI助手。全操作系统支持。全平台兼容。龙虾之道。🦞
vuejs/vue
此仓库为Vue 2版本。Vue 3版本请访问https://github.com/vuejs/core
microsoft/vscode
Visual Studio Code
n8n-io/n8n
具备原生AI能力的公平代码工作流自动化平台。支持可视化构建与自定义代码,可选自托管或云端部署,集成400多种服务。