Claude Mem

Claude Mem 快速入门

一句话卖点：给 AI 装上「长期记忆」——跨会话记住你的偏好和上下文，告别每次对话都从零开始。

这是什么？适合谁？

Claude Mem 是一个跨会话持久化记忆 Skill，GitHub 80K+ Stars，兼容 20+ Agent 平台（Claude Code、Cursor、Windsurf、Codex CLI 等），TypeScript 实现，安全审计评分 87/100。
核心功能：让 AI 在不同对话之间记住信息。比如：

• 你在今天的对话里告诉 AI「我喜欢用 pnpm 而不是 npm」；
  
• 明天新开一个对话，AI 自动知道这个偏好，不用再重复说；
  
• 项目背景、技术栈选择、代码风格偏好等都能记住。
  官方数据：安装后降低 70%+ 的重复解释成本——你不用每次对话都重新描述项目背景。
  适合谁？高频使用 AI 编程助手的开发者、需要多会话协作的项目、向 AI 反复解释同一件事疲惫的用户。
  不适合对隐私极其敏感的场景——记忆数据存储在本地文件中，但理论上 AI 可访问。
  

准备工作

1. 一个 AI 编程助手（Claude Code / Cursor / Windsurf 等）；
   
2. Node.js >= 18（Skill 本身是 TypeScript，依赖 Node 运行）。
   

3 步快速上手

第 1 步：安装

# Clone 仓库<br>
git clone https://github.com/thedotmack/claude-mem.git<br>
cd claude-mem<br>
# 安装依赖<br>
npm install<br>
# 构建<br>
npm run build<br>
```<br>
然后将 Skill 加载到 AI 助手：<br>
```bash<br>
# Claude Code<br>
ln -s $(pwd)/dist/claude-mem.js ~/.claude/skills/claude-mem.js<br>
# 或者全局安装 CLI 版本<br>
npm install -g claude-mem<br>
```<br>
### 第 2 步：配置<br>
初始化记忆存储：<br>
```bash<br>
# 创建记忆目录<br>
mkdir -p ~/.claude-mem<br>
# 初始化配置<br>
cat > ~/.claude-mem/config.json << 'EOF'<br>
{<br>
"storage": "local",<br>
"path": "~/.claude-mem/memories/",<br>
"maxTokens": 8000,<br>
"autoSave": true,<br>
"platforms": ["claude-code", "cursor"]<br>
}<br>
EOF<br>
```<br>
`maxTokens` 限制每次加载到 prompt 的记忆总量（避免记忆过多撑爆上下文窗口）。<br>
### 第 3 步：首次使用<br>
在 AI 助手中设置一个偏好：
> "记住：我的项目使用 pnpm，TypeScript strict 模式，测试框架是 vitest。"

AI 会调用 Claude Mem 的存储接口保存这三条信息。下次新开对话问：

> "我的项目用什么包管理器？"

AI 应该回答「pnpm」，即使当前对话中你从未提过。这说明记忆持久化生效了。

## 常见踩坑

1. **记忆混乱**：开了太多会话、记了太多信息，导致记忆冲突。定期用「列出所有记忆」命令清理。

2. **Token 消耗增加**：每次对话会加载记忆到 prompt 中。如果记忆总量接近 `maxTokens`（8000），token 消耗显著增加。设置合理的 `maxTokens` 值（建议 2000-4000）。

3. **跨平台记忆不共享**：Claude Mem 的本地存储在不同 AI 助手上是共享的，但前提是他们都配置了同一个 `path`。

4. **安全风险**：记忆内容明文存储在本地 JSON 文件中。如果记忆了 API Key、密码等敏感信息，存在泄露风险。不建议用记忆存敏感数据。

## 初级用法

- **记住偏好**：「记住：我的项目使用 PostgreSQL，端口 5432」；

- **查询记忆**：「列出所有关于数据库的记忆」；

- **删除记忆**：「忘记我之前说的 PostgreSQL，改用 MySQL」；

- **搜索记忆**：「回忆所有与 API 设计相关的记忆」。

## 高级玩法

- **项目级记忆隔离**：不同项目配置不同的 `path`，记忆互不干扰；

- **记忆同步**：通过 Git 同步记忆目录，团队共享项目记忆；

- **记忆标签分类**：手动给记忆打标签（`#database`、`#frontend`），AI 按标签检索；

- **自动记忆清理**：设置 `maxAge`（如 30 天），自动删除过期记忆。

## 小技巧

1. **记忆要精确**：「记住用 pnpm」比「记住用包管理器」好——精确记忆 AI 检索更准；

2. **定期审查**：每周 `claude-mem list` 看一遍记忆，删掉过时的；

3. **分项目隔离**：每个项目用独立记忆目录，避免跨项目混淆；

4. **重点记忆项目决策**：API 选型、架构决策、命名规范——这些是最值得记住的。

## 常见问题 FAQ

**Q1: Claude Mem 和 Claude 自带的 Memory 功能有什么区别？**

A: Claude 自带 Memory 是 Anthropic 官方功能，仅限 Claude AI（claude.ai 网页版和 App）。Claude Mem 是一个第三方的跨平台 Skill，可以在 Claude Code、Cursor、Windsurf 等所有 Agent 平台使用。前者是 Anthropic 维护的功能，后者是社区 Skill。

**Q2: 记忆安全吗？会不会被 Anthropic/OpenAI 看到？**

A: 记忆存储在本地文件（`~/.claude-mem/memories/`）。但对话时记忆会被加载到 prompt 中发送给 AI 服务商（Anthropic/OpenAI）。所以记忆内容本身不直接上传，但会作为 conversation context 发送。

**Q3: 支持多设备同步吗？**

A: 原生不支持云同步。但可以把记忆目录放到 iCloud/Dropbox/OneDrive 里，或通过 Git 管理同步。

**Q4: 兼容哪些 AI 平台？**

A: Claude Code、Cursor、Windsurf、Codex CLI、Aider、OpenCode、Continue.dev 等 20+ 个平台。完整列表见仓库 README。

**Q5: TypeScript 版本需要编译吗？**

A: 如果用全局安装 `npm install -g claude-mem`，已预编译。如果从源码安装，需要 `npm run build`。

## 参考链接

- Claude Mem 仓库：<https://github.com/thedotmack/claude-mem>

- Claude 官方 Memory 文档：<https://docs.anthropic.com/en/docs/claude/memory>

- OpenAgentSkill 安全审计：<https://openagentskill.com>