一、准备 WSL 环境
直接在Windows上安装各种坑,最后决定使用WSL,
WSL 是 Windows Subsystem for Linux 的缩写,意为适用于 Linux 的 Windows 子系统。它是微软为 Windows 10 和 Windows 11 引入的一项功能,允许用户在 Windows 系统中运行 Linux 操作系统及其相关命令和应用程序,而无需安装虚拟机或双系统。
WSL 提供了一个轻量级的环境,使开发者能够在 Windows 上无缝使用 Linux 工具和命令行,同时支持运行多种 Linux 发行版,如 Ubuntu、Debian 和 Kali。
1、安装 WSL
# 管理员运行 cmd 或 powershell
# 安装
C:\Windows\System32>wsl --install
2、安装 Node.js
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ sudo apt install -y nodejs
# 验证
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ node -v
3、安装 unzip【安装Bun需要】
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ sudo apt update && sudo apt install -y unzip
4、安装 Bun
# 手动安装 Bun
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ curl -fsSL https://bun.sh/install | bash
# 加载 Bun 环境变量
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ source ~/.bashrc
#验证 Bun 安装成功
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ bun --version
5、安装 claude code
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
6、安装 claude-mem
# 进入 WSL Ubuntu 终端,直接执行【安装配置中,space选择,enter确认】
abc@DESKTOP-S90NUOF:/mnt/c/Windows/System32$ npx claude-mem install
7、效果并测试服务状态
在浏览器打开 http://localhost:37700/api/health(你配置的端口),预期返回:
json
{
"status": "ok",
"version": "x.x.x",
"database": "connected"
}
在 Claude Code 测试记忆
-
重启 Claude Code(
Ctrl+D退出后重新输入claude) -
在 Claude Code 中发起一段包含个人信息或上下文的对话,例如:
我叫张三,我是一名后端工程师,主要用 Java 和 Python 开发,最近在做 WSL 相关的项目。 -
继续对话,故意遗忘之前的信息,测试 Claude 是否能从记忆中提取:
我之前说过我的职业是什么?我主要用什么语言开发? -
观察 Claude 是否能准确回答出你之前提到的信息,这就证明记忆功能生效了。
-
claude-mem中查看历史对话
二、claude-mem 解决什么问题
claude-mem 是为 Claude Code 设计的开源持久化记忆插件,主要解决 AI 编程助手跨会话失忆问题。
核心收益:
- 减少重复解释:下次打开还能延续上次项目上下文
- 节省 Token / 成本:通过渐进式检索,只注入最相关的记忆(据称可节省 69% - 90%)
- 自动化:用生命周期钩子自动抓取编辑/搜索/工具调用等
- 隐私可控:数据落在本地;可用
<private>...</private>标注不希望记住的内容
1、架构
-
组件拆解:
-
5 个生命周期钩子:会话开始、提交提示词、使用工具、会话结束等节点抓取“观察”
-
常驻 Worker:压缩日志为结构化摘要,并提供可视化界面
-
混合数据库:SQLite(关键词检索)+ Chroma(向量语义检索)
-
mem-search 技能:让 Claude 能用自然语言查询历史
-
三、应用
1、CC switch 修改WSL中claude code配置
\\wsl$\Ubuntu\home\你的用户名\.claude
- IDEA的配置
- setting -> tools -> Claude code:在 Claude command 输入框中填入
wsl -d Ubuntu -- bash -lic "claude"
如下如展示,提示记忆查看路径了:
四、后台服务
# 查看WSL进程状态
wsl --list --verbose
结果是 Running,表示后台运行正字啊运行着WSL。
- NAME STATE VERSION
- * docker-desktop Stopped 2
- Ubuntu Running 2
- 而IDEA中使用的是claude code的执行命令,所以wsl窗口关闭并不影响claude code的正常工作。