claude-db

claude-db 为 Claude Code 提供持久化记忆能力，让 AI 每次都能记住项目的关键决策和技术上下文。项目默认使用本地 SQLite（存储在 ~/.claude-memory/memory.db），零配置、无需账号、不产生订阅费用。如需多设备共享，也可切换至 MongoDB 或 PostgreSQL 等远程数据库。

核心原理：Claude Code 每轮对话都会将会话内容写入 JSONL 文件，claude-db 读取该文件，提取当次编辑或命令执行的关键信息，生成结构化记忆条目并建立向量索引。每次新对话开始时，claude-db 自动将最相关的记忆条目注入上下文，无需人工干预。安装后会在项目根目录写入 CLAUDE.local.md，作为全会话级别的记忆规则，使 recall 成为默认行为而非被动触发。

支持功能：命令式记忆写入（/cdb remember）、语义搜索（/cdb search）、跨项目记忆合并、冷启动从 Git 历史填充、敏感信息自动脱敏（.env、secrets/、node_modules 等路径内容永不写入记忆）。依赖 Node 22.5+，内置 SQLite，向量嵌入可按需安装 @xenova/transformers 进行语义搜索。本地优先，隐私友好。