- 持久化记忆：观察数据存入 SQLite 数据库，跨会话自动保留并在新会话中注入。
- 自动捕获与压缩：通过 SessionStart、PostToolUse、Stop 等生命周期钩子全程记录，由后台工作服务用 AI 提取结构化学习内容。
- 语义搜索：提供 search、timeline、get_observations 三个 MCP 搜索工具，支持自然语言检索项目历史，约 10 倍 Token 节省。
- 渐进式披露：分层检索，先返回紧凑索引、再按需获取详情，Token 成本清晰可见。
- 文件夹上下文文件：自动生成 CLAUDE.md 活动时间线，让 Claude 开箱即知项目动态。
- Web 查看器：本地 37777 端口实时可视化记忆流，支持 SSE 更新。
- 隐私控制：使用 标签可在数据入库前剥离敏感内容。
- 多语言模式：支持中文、英文、日文等 28 种语言。

安装仅需一条命令：在终端执行 npx claude-mem install，或在 Claude Code 内通过 /plugin marketplace add thedotmack/claude-mem 与 /plugin install claude-mem 安装，重启后即自动生效。
使用过程完全自动化，无需手动干预：每次会话启动自动注入历史上下文，工具执行时自动捕获观察，会话结束时自动生成摘要。
如需按需查询，直接用自然语言向 Claude 提问，它会自动调用搜索工具；也可打开 http://localhost:37777 查看实时记忆流。
配置集中在 ~/.claude-mem/settings.json，可调整 AI 模型、端口、上下文注入策略与语言模式（如 code--zh 中文模式）。

- 全自动运行：安装后零干预，钩子自动完成捕获、压缩与注入。
- 真正的跨会话记忆：数据持久化存储，会话中断或重连后上下文依然完整。
- Token 高效：三层检索与渐进式披露，相比全量注入节省约 10 倍 Token。
- 隐私可控：钩子层即剥离敏感内容，11 项配置精细控制注入。
- 架构先进：Bun 管理的工作服务异步处理，不阻塞主流程；Chroma 向量库加 SQLite FTS5 混合检索，精准快速。
- 开源开放：Apache 2.0 协议，社区活跃，支持多 IDE 与多语言，持续迭代。

- 使用 Claude Code 的中高级开发者：在多会话中维护大型项目，需要 AI 记住架构决策与代码约定。
- 独立开发者：同时维护多个项目，希望上下文自动隔离、快速恢复。
- 技术团队：可通过团队记忆同步方案共享 AI 记忆，降低知识孤岛与“公车因子”风险。
- 追求效率的 AI 重度用户：减少重复背景说明，节省 Token、提升开发效率。

Q1: 安装后为什么没有生效？
A1: 请通过 npx claude-mem install 或 /plugin install 安装；npm install -g claude-mem 只安装 SDK 库，不会注册钩子。安装后务必重启 Claude Code。
Q2: 标签内容真的不会被存储吗？
A2: 是的。隐私剥离发生在钩子层，内容在写入数据库前即被完全移除。
Q3: 支持 Windows 系统吗？
A3: 支持 Windows、macOS 与 Linux。若提示 npm 无法识别，请确认 Node.js 已安装并加入 PATH 后重启终端。
Q4: 记忆数据存储在哪里？
A4: 默认存储在 ~/.claude-mem/claude-mem.db（SQLite），并配合 Chroma 向量库做语义检索，数据默认保留在本地。
Q5: 支持 Claude Code 以外的工具吗？
A5: 支持，还可用于 OpenClaw、Codex、Gemini、Copilot、OpenCode 等 AI 编程工具。
Q6: 会消耗大量 Token 吗？
A6: 不会。渐进式披露与三层检索仅在需要时获取详情，可节省约 10 倍 Token，注入数量也可配置。
Q7: 如何切换中文模式？
A7: 编辑 ~/.claude-mem/settings.json，将 CLAUDE_MEM_MODE 设为 code--zh，重启 Claude Code 即可。