用途:为 Claude Code 提供有意的记忆管理,跨会话保存上下文、决策和用户偏好,避免上下文重置后重复犯错或重复解释。
主要能力:记录用户偏好(命名约定、导入风格、错误处理、状态管理等);记录架构决策及其理由、备选方案和影响;跟踪用户纠正模式,同一模式出现 2 次以上后自动应用;保存项目知识(技术栈、目录结构、集成点、部署方式)。
使用方式:记忆存放在 .claude/memory/ 目录,采用 JSON 格式,如 project/knowledge.json、project/decisions.json、{skill-name}/preferences.json、corrections.json。提供命令:/show-memory、/clear-memory [skill]、/clear-all-memory、/refresh-memory、/export-memory、/import-memory [file]。当用户明确说“总是/从不”、给出架构决策、第二次纠正同一模式或定义项目约定时立即持久化;单次偏好可等待确认后再存。
适用场景:需要跨会话保持偏好、记录决策理由、从纠正中学习、维持项目连续性的开发工作。
限制:不得存储 API 密钥、令牌、凭据、个人信息、敏感业务逻辑或带令牌的私有 URL;不应持久化临时实验、代码或配置中已有的信息、通用最佳实践;记忆可能过期,依赖变更或超过约 30 天需刷新;记忆不应提交到 git,需加入 .gitignore。原则是选择性、透明、有意、尊重隐私。