安装指南

快速开始

选项 1：npx（推荐）

使用一条命令安装并配置 Claude-Mem：

npx claude-mem install

交互式安装程序将会：

• 检测你已安装的 IDE（Claude Code、Cursor、Gemini CLI、Windsurf 等）
• 将插件文件复制到正确的位置
• 将插件注册到 Claude Code
• 安装所有依赖项（包括 Bun 和 uv）
• 自动启动 Worker 服务

选项 2：插件市场

直接从 Claude Code 内的插件市场安装 Claude-Mem：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

这两种方法都会自动配置挂钩并启动 Worker 服务。启动一个新的 Claude Code 会话，你会看到之前会话的上下文会自动加载。

重要： Claude-Mem 已在 npm 上发布，但运行 npm install -g claude-mem 会安装 仅限 SDK/库。它不会注册插件钩子或启动 Worker 服务。 始终通过上述的 npx claude-mem install 或 /plugin 命令进行安装。

系统要求

• Node.js：18.0.0 或更高
• Claude Code：支持插件的最新版本
• Bun：JavaScript 运行时和进程管理器（如果缺失会自动安装）
• SQLite 3：用于持久存储（捆绑）

高级安装

用于开发或测试，您可以从源代码克隆并构建：

克隆与构建

# Clone the repository
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem

# Install dependencies
npm install

# Build hooks and worker service
npm run build

# Worker service will auto-start on first Claude Code session
# Or manually start with:
npm run worker:start

# Verify worker is running
npm run worker:status

安装后验证

1. 自动依赖安装

依赖项在插件安装过程中会自动安装。SessionStart 钩子还确保每次会话开始时依赖项都是最新的（这是快速且幂等的）。适用于 Windows、macOS 和 Linux 跨平台运行。

2. 验证插件安装

检查 Claude Code中是否配置了钩子：

cat plugin/hooks/hooks.json

3. 数据目录位置

数据存储在 ~/.claude-mem/ 中：

• 数据库：~/.claude-mem/claude-mem.db
• PID 文件：~/.claude-mem/.worker.pid
• 端口文件：~/.claude-mem/.worker.port
• 日志：~/.claude-mem/logs/worker-YYYY-MM-DD.log
• 设置: ~/.claude-mem/settings.json

使用环境变量覆盖：

4. 检查工作日志

npm run worker:logs

5. 测试上下文检索

npm run test:context

升级

通过插件市场更新时，升级是自动进行的。最近版本的主要变化：

v7.1.0：PM2 被原生 Bun 进程管理替换。首次触发钩子时自动迁移。

**v7.0.0 **：11个配置设置，双标签隐私系统。

v5.4.0：基于技能的搜索取代了 MCP 工具，每次会话节省约 2,250 个 token。

请参阅 CHANGELOG 获取完整版本历史记录。

下一步

• 入门指南 - 了解 Claude-Mem 如何自动工作]
• MCP 搜索工具 - 查询您的项目历史]
• 配置 - 自定义 Claude-Mem 行为]