学习路径指南
难度等级
初级
预计时长
2-3小时
适合人群
使用Claude Code插件进行编程的开发者,希望让Claude AI在多个会话中保持项目记忆的TypeScript初学者

学习目标:学会安装配置Claude-Mem,让Claude AI在编程会话中保持持久记忆,并能使用Web界面查看记忆流

前置知识

TypeScript基础 了解

项目使用TypeScript开发,需要能理解基本的语法和类型

Node.js和npm 了解

需要安装Node.js环境来运行项目,使用npm安装依赖

Claude Code插件 熟悉

这是Claude-Mem的核心使用场景,需要在终端中使用Claude Code

命令行基础 了解

需要在终端中执行安装和配置命令

学习步骤

1

环境准备

15分钟

检查Node.js环境

打开终端,运行`node --version`和`npm --version`,确保Node.js版本在16以上

如果未安装Node.js,请先到官网下载安装

安装Claude Code插件

确保已在终端中安装并配置好Claude Code插件

Claude Code是Anthropic官方提供的终端插件,需要先完成设置

2

快速安装

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版本

3

基础配置

15分钟

启动Claude-Mem服务

运行:`npm start` 启动记忆系统

保持这个终端窗口运行,不要关闭

验证Web界面

打开浏览器访问 http://localhost:37777,确认能看到实时记忆流界面

如果无法访问,检查防火墙设置或端口是否被占用

4

首次使用

30分钟

启动新的Claude Code会话

在新的终端窗口中启动Claude Code,按照README中的Quick Start部分输入初始化命令

确保Claude-Mem服务正在运行,否则无法建立连接

测试记忆功能

在Claude Code中编写一些代码,然后关闭会话,重新打开新的会话,观察Claude是否能记住之前的上下文

可以故意创建一些函数或变量,然后在新会话中询问Claude相关内容

5

核心功能体验

40分钟

使用记忆搜索技能

在Claude Code中使用`mem-search`技能搜索项目历史,例如:`search 函数定义`

搜索功能需要先有一些历史记录才能看到效果

探索Web查看器

在浏览器中观察http://localhost:37777的实时记忆流,了解Claude-Mem如何记录和压缩信息

Web界面会显示Claude的所有操作记录和语义总结

测试Claude Desktop集成

如果使用Claude Desktop,尝试从桌面会话中搜索记忆

需要确保Claude Desktop正确配置了技能调用

6

进阶配置

20分钟

查看配置文件

检查`~/.claude-mem/settings.json`文件,了解可配置选项

配置文件可能不存在,首次运行时会自动创建

了解隐私控制

学习如何使用`[代码]search[代码]timeline[代码]getobservations[代码]search`等命令控制记忆访问

这些命令用于管理记忆的检索和显示

推荐资源

项目README 必看

包含快速开始、功能说明、配置选项等基本信息

docs/目录 推荐

更详细的技术文档和使用指南

GitHub Issues 推荐

查看常见问题和解决方案,或提交自己的问题

官方Discord 可选

加入社区与其他用户交流使用经验

常见错误与避坑指南

1

忘记启动Claude-Mem服务

在使用Claude Code前,确保在另一个终端中运行`npm start`启动了Claude-Mem服务

2

端口冲突导致Web界面无法访问

如果37777端口被占用,可以检查配置文件修改端口,或关闭占用端口的程序

3

Claude Code会话中记忆不生效

确保按照Quick Start正确初始化了Claude Code会话,并检查Claude-Mem服务连接状态

4

构建时TypeScript编译错误

检查TypeScript版本,确保与项目要求一致,可以尝试删除node_modules重新安装

下一步探索

探索高级配置选项,了解记忆压缩算法原理,学习如何扩展Claude-Mem功能,或贡献代码到开源项目

助手