windows【WSL】上实现 给 claude code 装上持久化记忆claude-mem【插件】

1 阅读1分钟

一、准备 WSL 环境

直接在Windows上安装各种坑,最后决定使用WSL,

WSL 是 Windows Subsystem for Linux 的缩写,意为适用于 Linux 的 Windows 子系统。它是微软为 Windows 10 和 Windows 11 引入的一项功能,允许用户在 Windows 系统中运行 Linux 操作系统及其相关命令和应用程序,而无需安装虚拟机或双系统。

WSL 提供了一个轻量级的环境,使开发者能够在 Windows 上无缝使用 Linux 工具和命令行,同时支持运行多种 Linux 发行版,如 UbuntuDebian 和 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

image.png

7、效果并测试服务状态

image.png

在浏览器打开 http://localhost:37700/api/health(你配置的端口),预期返回:

json

{
  "status": "ok",
  "version": "x.x.x",
  "database": "connected"
}

在 Claude Code 测试记忆

  1. 重启 Claude Code(Ctrl+D 退出后重新输入 claude

  2. 在 Claude Code 中发起一段包含个人信息或上下文的对话,例如:

    我叫张三,我是一名后端工程师,主要用 Java 和 Python 开发,最近在做 WSL 相关的项目。
    
  3. 继续对话,故意遗忘之前的信息,测试 Claude 是否能从记忆中提取:

    我之前说过我的职业是什么?我主要用什么语言开发?
    
  4. 观察 Claude 是否能准确回答出你之前提到的信息,这就证明记忆功能生效了。

  5. claude-mem中查看历史对话

image.png

二、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

image.png

  1. IDEA的配置
  • setting -> tools -> Claude code:在 Claude command 输入框中填入

wsl -d Ubuntu -- bash -lic "claude"

image.png

如下如展示,提示记忆查看路径了: image.png

四、后台服务

# 查看WSL进程状态
wsl --list --verbose 

结果是 Running,表示后台运行正字啊运行着WSL。

-   NAME              STATE           VERSION                                                
- * docker-desktop    Stopped         2                                                                                   
-   Ubuntu            Running         2                                                                                   
  • 而IDEA中使用的是claude code的执行命令,所以wsl窗口关闭并不影响claude code的正常工作。