Claude-Mem 是什么：编程 Agent 如何跨会话记忆
部署 Claude-Mem：本地 worker 与服务端 API 要分开
为选定路线规划运行环境、存储、访问控制和恢复
部署 Claude-Mem：本地 worker 与服务端 API 要分开知识学习CN编辑简报更新 2026-10-08
你将学会
- 核对运行要求
- 选择本地或远端
- 准备运维记录
开始前需要
- 合成的双会话项目
- 一种受支持宿主
- 明确选择的记忆供应商
用合成的两次会话，再做排除和删除检查
先看结论
- 包要求比 README 概述更严格。
- 远端 API 的控制需要配置。
- 存储必须有恢复方案。
核对运行要求
固定 README 概述 Node 20，并介绍 Bun、uv 与内置 SQLite。`package.json` 更精确，要求 Node `>=20.12.0` 和 Bun `>=1.1.31`；复现安装时应按更严格的包要求。
本地架构文档显示按用户运行的 HTTP worker、SQLite 与 Chroma 存储。对外开放任何接口前，先检查绑定地址和数据目录。
选择本地或远端
服务端 API 文档描述 `/v1` 端点、可选的 API Key 认证及只读远程 MCP 检索端点。它的 beta 服务路径不能直接等同于本地 worker API。
文档中的限流、配额和计量都需要显式启用；未配置不代表生产环境已受限制。公网部署还需设计认证、网络边界、备份和保留期限。
准备运维记录
记录所选宿主适配器、供应商、包版本、worker 状态、存储位置和恢复办法。生产指南把待处理队列、活动会话、WAL 与 Chroma 增长列作健康信号。
我们没有启动 worker、部署服务端 API 或测试恢复。指南中的历史吞吐量和节省数据来自上游经验，本文没有复现。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
满足包元数据中的引擎要求。
- 2
清楚区分本地 worker 与服务端 API。
- 3
开放访问前测试健康检查、备份和恢复。
可复制示例
yaml
runtime: node_20_12_plus_and_supported_bun
mode: local_worker_or_server_api
storage: backed_up_and_access_restricted
auth: explicit_for_remote_access
restore: tested常见问题
可以直接把本地 worker 暴露到公网吗？
不要从本地安装说明推断安全性，先核对绑定和认证。
本地插件必须部署 beta 服务端吗？
文档描述的是不同运行路线，应按实际集成选择。
资料来源
- Claude-Mem / README.md来源核查 2026-10-08
- Claude-Mem / package.json来源核查 2026-10-08
- Claude-Mem / docs/architecture-overview.md来源核查 2026-10-08
- Claude-Mem / docs/production-guide.md来源核查 2026-10-08
- Claude-Mem / docs/api.md来源核查 2026-10-08