使用说明

克劳德内存设置指南

此目录包含Claude AI助手（包括Claude Desktop和Claude Code）的持久内存存储。

⚠️ 重要提示：使用前请更换灯座！

在本指南中，替换 YOUR_USERNAME 使用您的实际Windows用户名（Mac/Linux用户应相应地调整路径）。

这是什么

这是一个本地知识图数据库，允许Claude记住对话和会话中的信息。所有数据都已存储 本地在您的计算机上 并且从未发送到外部服务器超过正常的Claude API使用。

目录结构

C:\Users\YOUR_USERNAME\.claude-memory\
├── README.md           # This file
└── memory.db           # SQLite database (created automatically on first use)

我们是如何构建这个的

1.创建内存目录

窗户：

mkdir C:\Users\YOUR_USERNAME\.claude-memory

Mac/Linux：

mkdir ~/.claude-memory

此目录存储包含所有内存的本地SQLite数据库文件。

2.配置克劳德桌面

窗户： C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

已添加配置：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory",
        "--memory-path",
        "C:\\Users\\YOUR_USERNAME\\.claude-memory"
      ]
    }
  }
}

Mac/Linux版本：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory",
        "--memory-path",
        "/home/YOUR_USERNAME/.claude-memory"
      ]
    }
  }
}

⚠️ 路径注释：

窗户： 使用双反睫毛(\\)JSON格式
Mac/Linux： 使用正斜杠(/)
替换 YOUR_USERNAME 使用您的实际用户名

3.配置克劳德代码

克劳德代码使用 单独的配置文件 来自Claude Desktop，允许两者共享同一内存数据库。

创建此文件： C:\Users\YOUR_USERNAME\memory-mcp-config.json （Windows） Mac/Linux： ~/.claude-memory/memory-mcp-config.json

文件内容：

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-memory",
    "--memory-path",
    "C:\\Users\\YOUR_USERNAME\\.claude-memory"
  ]
}

Mac/Linux版本：

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-memory",
    "--memory-path",
    "/home/YOUR_USERNAME/.claude-memory"
  ]
}

添加到克劳德代码：

打开克劳德代码
首选设置 → MCP服务器
点击 添加服务器
选择 从文件导入
选择您的 memory-mcp-config.json 文件
重新启动Claude代码

替代方法（克劳德代码中的直接方法）：

在克劳德代码设置中→ MCP服务器
点击 添加服务器 → 手动配置
姓名： memory
命令： npx

Args：

-y
@modelcontextprotocol/server-memory
--memory-path
C:\Users\YOUR_USERNAME\.claude-memory

4.使用MCP服务器

包裹： @modelcontextprotocol/server-memory

这是实现模型上下文协议（MCP）的官方Anthropic内存服务器。它提供：

具有实体和关系的知识图存储
存储事实和笔记的观察结果
语义搜索功能
跨会话的持久存储

5.工作原理

当您与Claude（桌面或代码）交互时，内存服务器：

运行通过 npx （节点包运行器）按需
在指定路径连接到本地SQLite数据库
提供创建和检索记忆的工具
将所有内容存储在 memory.db
两个应用程序共享同一个数据库 -可以从任一客户端访问内存

可用内存工具

配置并重新启动后，Claude可以访问这些工具：

核心业务

create_entities -存储有关人员、项目、概念的信息
创建关系 -将实体链接在一起（例如，“John works_at Company X”）
添加观察结果 -为实体添加事实、注释和上下文
搜索节点 -通过查询查找存储的记忆
open_nodes -检索特定实体的详细信息
read_graph -阅读整个知识图谱
删除内容 -从内存中删除实体
删除观察 -删除具体观察结果
删除关系 -删除实体之间的关系

使用示例

存储信息

"Remember that I prefer Python over JavaScript for backend work"

创建实体：用户首选项
添加观察：后端语言首选项

检索信息

"What programming languages do I prefer?"

在内存中搜索相关实体
返回存储的首选项

建筑背景

"I'm working on Project X with React and Supabase"

创建实体：项目X
可以链接到相关实体（技术、文档、决策）

存储项目详细信息

"Remember: SynthAssist.ai uses Supabase for backend, n8n for automation, and V0 for frontend"

创建实体：SynthAssist.ai
添加关于技术栈的观察
稍后可以查询：“SynthAssist使用什么技术栈？”

益处

✅ 持久上下文 -克劳德在各个环节都记得 ✅ 共享内存 -桌面和代码中提供相同的知识 ✅ 本地存储 -完整的数据隐私和控制 ✅ 结构化知识 -基于图形的关系 ✅ 可搜索 -查询您存储的信息 ✅ 交叉平台的 -适用于Windows、Mac和Linux

激活

克劳德桌面版

编辑 claude_desktop_config.json 根据上述配置
完全重新启动克劳德桌面
记忆工具自动激活
开始存储信息！

克劳德代码

创建 memory-mcp-config.json 根据上述配置
导入克劳德代码设置（或手动配置）
重新启动Claude代码
内存工具出现在可用工具中
自动与Claude Desktop共享

验证

要确认内存是否正常工作：

在克劳德桌面或代码中，问：
```
"Do you have access to memory tools?"
```

试验储存：

"Remember that my favorite color is blue"

测试检索：
```
"What's my favorite color?"
```
检查数据库文件是否存在：
- 窗户： C:\Users\YOUR_USERNAME\.claude-memory\memory.db
- Mac/Linux： ~/.claude-memory/memory.db

维护

备份你的记忆

窗户：

copy C:\Users\YOUR_USERNAME\.claude-memory\memory.db C:\Backup\location\memory-backup.db

Mac/Linux：

cp ~/.claude-memory/memory.db ~/Backup/location/memory-backup.db

查看数据库内容

您可以使用任何SQLite查看器来检查数据库：

窗户：

sqlite3 C:\Users\YOUR_USERNAME\.claude-memory\memory.db
.tables
.schema

Mac/Linux：

sqlite3 ~/.claude-memory/memory.db
.tables
.schema

重置内存

要重新开始，只需删除数据库文件：

窗户：

del C:\Users\YOUR_USERNAME\.claude-memory\memory.db

Mac/Linux：

rm ~/.claude-memory/memory.db

下次使用时将创建一个新的空数据库。

技术细节

协议： 模型上下文协议（MCP） 储存： SQLite数据库 运输： 标准输入/输出 范围： 本地文件系统 包管理器： npx（节点包运行器） 共享存储： Claude Desktop和Claude Code都访问相同的数据库文件

故障排除

内存工具未出现

克劳德桌面：

确保您已完全重新启动应用程序
检查 claude_desktop_config.json 具有正确的JSON语法
验证内存路径是否存在且可访问
检查Claude Desktop日志中的MCP连接错误

克劳德代码：

验证 memory-mcp-config.json 创建正确
确保在Claude Code设置中导入服务器
完全重新启动Claude代码
检查设置中的MCP服务器状态

验证npx是否可用

npx --version

如果找不到，请从以下位置安装Node.js nodejs.org

数据库锁定错误

关闭所有Claude应用程序（桌面和代码）
确保没有其他进程正在访问 memory.db
重新启动应用程序

未找到包

# Manually install the memory server
npm install -g @modelcontextprotocol/server-memory

权限错误

窗户：

确保您的用户帐户具有对 .claude-memory 目录
如果需要，以管理员身份运行Claude（不建议正常使用）

Mac/Linux：

chmod 755 ~/.claude-memory
chmod 644 ~/.claude-memory/memory.db

隐私和安全

所有数据已存储 仅限本地 在您的机器上
不涉及外部服务器（除了Claude API用于处理）
您控制所有数据-可以备份、删除或迁移
应用标准文件权限
考虑对目录中的敏感信息进行加密
Claude Desktop和Code都访问相同的本地数据库

多台机器的配置

如果要跨多台计算机同步内存：

使用云存储（手动同步）：
- 地方 .claude-memory 在Dropbox/OneDrive/谷歌云端硬盘中
- 更新两个配置文件中的路径以指向云文件夹
- ⚠️ 一次只运行一个Claude实例以避免冲突
手动备份/还原：
- 备份 memory.db 来自机器A
- 复制到机器B .claude-memory 目录
- 在机器B上重新启动Claude

未来的增强功能

您可以做出的潜在改进：

添加自动备份脚本（cron/Task Scheduler）
在静止状态下实施加密
为知识图创建导入/导出实用程序
为知识图构建可视化工具
为多机设置开发同步脚本
创建用于浏览记忆的web界面

配置文件示例

完整的克劳德桌面配置（Windows）

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory",
        "--memory-path",
        "C:\\Users\\YOUR_USERNAME\\.claude-memory"
      ]
    }
  }
}

完整的克劳德桌面配置（Mac/Linux）

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory",
        "--memory-path",
        "/home/YOUR_USERNAME/.claude-memory"
      ]
    }
  }
}

Claude代码配置文件（内存mcp-Config.json）

窗户：

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-memory",
    "--memory-path",
    "C:\\Users\\YOUR_USERNAME\\.claude-memory"
  ]
}

Mac/Linux：

{
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-memory",
    "--memory-path",
    "/home/YOUR_USERNAME/.claude-memory"
  ]
}

资源

快速入门检查表

[]安装Node.js（适用于npx）
[]创建 .claude-memory 目录
[]配置Claude桌面(claude_desktop_config.json)
[]配置克劳德代码(memory-mcp-config.json)
[]重新启动两个应用程序
[]测试内存存储和检索
[]验证 memory.db 已创建

安装说明

创建指南： 2025年1月 配置人： Claude代码助理 安装类型： Claude Desktop和Claude Code的共享内存数据库 储存： 本地SQLite数据库 平台支持： Windows、Mac、Linux

这个存储系统使Claude能够维护上下文，并根据您的需求和偏好构建一个持久的知识库，可以从Claude Desktop和Claude Code访问。

使用说明

克劳德内存设置指南

⚠️ 重要提示：使用前请更换灯座！

这是什么

目录结构

我们是如何构建这个的

1.创建内存目录

2.配置克劳德桌面

3.配置克劳德代码

4.使用MCP服务器

5.工作原理

可用内存工具

核心业务

使用示例

存储信息

检索信息

建筑背景

存储项目详细信息

益处

激活

克劳德桌面版

克劳德代码

验证

维护

备份你的记忆

查看数据库内容

重置内存

技术细节

故障排除

内存工具未出现

验证npx是否可用

数据库锁定错误

未找到包

权限错误

隐私和安全

多台机器的配置

未来的增强功能

配置文件示例

完整的克劳德桌面配置（Windows）

完整的克劳德桌面配置（Mac/Linux）

Claude代码配置文件（内存mcp-Config.json）

资源

快速入门检查表

安装说明

相关 MCP

知识图谱记忆服务器

AI持久记忆服务器

知识图谱存储服务

百度优选

自主代理操作系统

知识图谱记忆系统