用途:Memory 为 Claude Code 会话提供持久上下文,把项目决策、用户偏好和编码约定保存到本地 JSON 文件,新会话启动时自动加载,使先前确立的模式延续,无需重新解释。
主要能力:会话开始时读取 .claude/memories/project_memory.json 并解析带时间戳的记忆条目;按关键词和主题匹配当前任务,提取适用的决策(如“用 pnpm 而非 npm”)、架构模式、库选择和代码风格偏好;静默应用记忆,不主动声明;在出现重要决策时写入带时间戳的新条目;当记忆与当前明确请求冲突时优先当前请求,并更新或删除过时条目;条目超过 10 条时清理噪音、保留高价值内容,阈值可在 hooks/stop_cleanup.py 配置。
使用方式:需具备 .claude/memories/project_memory.json(首次保存时自动创建)及该目录读写权限,并安装 Claude Never Forgets 插件:/plugin install yldrmahmet/claude-never-forgets。可用 /remember [text] 手动添加记忆,/forget [text] 删除匹配记忆,/memories 列出全部带时间戳的记忆。
适用场景:跨会话记住包管理器、测试框架、命名约定等偏好;记录库选择、架构决策、工具拒绝等信号;在后续会话中自动按既有约定生成代码或执行操作。
限制:记忆存于本地 JSON 文件,依赖文件存在与权限;文件缺失需以空 JSON 结构初始化;格式损坏需备份后重建;多条记忆冲突时应用最新条目并建议清理;具体实现细节见 ${CLAUDE_SKILL_DIR}/references/implementation.md 与 errors.md。