第 6 课：claude-mem 安装、初始化与目录结构

6.1 推荐安装方式

在 Claude Code 会话中，你可以使用以下命令通过插件市场安装 claude-mem：

# 1. 添加 marketplace 来源
/plugin marketplace add thedotmack/claude-mem

# 2. 安装插件（格式：插件名@市场名）
/plugin install claude-mem@thedotmack

# 3. 重载插件使生效
/reload-plugins

注意：请不要使用 npm install -g claude-mem 安装，这种方式只会安装 SDK，而不会注册必要的 Hooks 和 Worker 进程。

6.2 验证安装

安装完成后，你可以通过以下方式验证：

1. 检查配置文件：

   cat ~/.claude/plugins/installed_plugins.json | grep claude-mem
   

2. 检查插件缓存：

   ls ~/.claude/plugins/cache/thedotmack/claude-mem/
   

6.3 初始化后的目录结构

当你首次在会话中触发 claude-mem 操作（或会话启动后自动初始化）后，系统会在用户目录下创建 ~/.claude-mem/ 文件夹：

~/.claude-mem/
├── claude-mem.db           # SQLite 数据库，存储元数据与全文索引
├── chroma/                 # 向量数据库文件夹
├── settings.json           # 插件配置，包含默认值
└── logs/                   # 后台 Worker 进程日志

6.4 跨项目识别逻辑

claude-mem 会通过 Git 的远程 URL (Remote URL) 和当前路径自动推断“项目标识 (Project ID)”：

• 同一仓库的不同 Worktree 会被识别为同一项目。
• 不同仓库会被识别为不同项目。
• 这种机制保证了在进行跨项目搜索（如 mem-search）时，能够精确过滤相关内容。