快速开始
一条命令，装好就能用
安装程序会先完成所有基础设置，然后提示你在浏览器中登录 claude-mem（邮箱魔法链接，无需绑卡）。
npx claude-mem install安装程序会先完成所有基础设置，然后提示你在浏览器中登录 claude-mem（邮箱魔法链接，无需绑卡）。登录会为你的账户分配一个记忆密钥，并解锁带 30 天免费试用的 claude-mem 观察器：记忆运行于套餐之外，因此你最多可从套餐中获得 100% 的额外用量。免费试用结束后，除非你订阅，否则记忆会自动回退到你的 Anthropic 套餐。
登录与提供者
30 天免费试用，之后可自选提供者
登录会为你的账户分配一个记忆密钥，并解锁带 30 天免费试用 的 claude-mem 观察器：记忆运行于套餐之外，因此你最多可从套餐中获得 100% 的额外用量。免费试用结束后，除非你订阅，否则记忆会自动回退到你的 Anthropic 套餐。
想跳过登录？传入明确的
--provider 参数、设置 CLAUDE_MEM_ONLINE_OPTIN=false，或在 CI / 非交互式 shell 中运行——安装程序会在不产生任何账户交互的情况下完成安装。登录后，你可以选择记忆提供者——claude-mem 观察器、你自己的 OpenRouter 或 Gemini 密钥，或者你的 Anthropic 套餐。
系统要求
环境前置
| 组件 | 要求 | 说明 |
|---|---|---|
| Node.js | 20.0.0 或更高 | 运行时 |
| Claude Code | 支持插件的最新版本 | 宿主 |
| Bun | 自动安装 | JavaScript 运行时与进程管理器 |
| uv | 自动安装 | 用于向量搜索的 Python 包管理器 |
| SQLite 3 | 已内置 | 用于持久化存储 |
Windows
Windows 安装说明
如果你看到 npm : The term 'npm' is not recognized 这类错误，请确保已安装 Node.js 和 npm，并已加入 PATH。
Claude Code 钩子不需要 Git Bash。每个钩子直接运行
claude-mem，而 npx claude-mem install 会将该启动器放到 %LOCALAPPDATA%\claude-mem\bin\claude-mem.exe，并把该文件夹加入你的用户 Path。完成后请重启终端或 IDE，以便 Claude Code 读取新的 Path。如果钩子报错 Executable not found in $PATH: "claude-mem"，运行诊断命令：
npx claude-mem doctor注意：Claude-Mem 也发布在 npm 上，但
npm install -g claude-mem 只安装 SDK / 库——它不会注册插件钩子，也不会设置 worker 服务。请始终通过 npx claude-mem install 或 /plugin 命令来安装。