claude-mem · Claude Code 跨会话记忆插件
记录智能体会话内容、压缩后在之后的会话中补回相关上下文的插件。
发布者：thedotmackthedotmack/claude-mem
你将打开的内容
适合希望 Claude Code（或经 T3 Code 使用的 Codex）记住之前会话中的决定和修复、而不用手动粘贴笔记的场景。
如何配置
- 先决定记忆是否只保存在本地，再用对应选项运行安装器。
- 重启 Claude Code 以加载钩子。
- 先工作一个会话，依赖它之前检查保存了什么内容。
依赖与第三方条款
需要 Node.js 20 或更高版本；缺少 Bun 和 uv 时安装器会自动安装。安装器默认会要求登录发布者的托管记忆服务，并开始 30 天试用。如需只在本地保存记忆，请显式传入 --provider，或设置 CLAUDE_MEM_ONLINE_OPTIN=false。片段固定为 2026-11-02 核对的 npm 版本 15.8.1（标签 v15.8.1）。npm install -g claude-mem 只安装库，不会注册钩子。收录不等于审计，运行前请检查脚本。
claude-mem 是什么，不是什么
claude-mem 由 thedotmack 发布（thedotmack/claude-mem，Apache-2.0），是一个插件：生命周期钩子记录智能体会话内容，本地 worker 压缩后，在之后的会话中补回相关上下文。本页是目录条目与安装说明，不是 Anthropic 的产品页，不是 skills.sh 或其他市场上的同名技能包，也不是 AgentSkillsDir 运营的托管记忆服务。我们只钉选 thedotmack/claude-mem，本页不会安装任何东西。
本地记忆还是托管试用
直接运行 npx claude-mem install 会要求邮箱登录，并开始发布者托管观察服务的 30 天试用；登录后可选择服务方（其观察服务、你自己的 OpenRouter 或 Gemini 密钥，或你的 Anthropic 套餐）。如需跳过账号步骤，像 Setup 标签那样设置 CLAUDE_MEM_ONLINE_OPTIN=false，或显式传入 --provider。会话与记录由 worker 写入本地 SQLite 数据库；同步到 cmem.ai 的 Cloud Sync 是另一项单独设置。
Codex：经 T3 Code，并非原生插件
v15.8.1 README 记载了 npx claude-mem install --ide t3code，它会为 T3 Code 管理的服务方注册 claude-mem，其中包括 T3 管理的 Codex。README 并未说明有原生、官方的 Codex 插件，本站也不这样宣称。Codex 标签使用的就是这条路径；AgentSkillsDir 尚未亲自运行（待本站实测）。安装后重启 T3 Code，按提示信任服务方钩子，再新建会话。
安装后的首次检查
重启 Claude Code 以加载钩子，完成一个会话后再开新会话，确认之前的上下文出现。依赖它之前，先在本地查看器中检查保存了什么。如果没有出现，运行 npx claude-mem doctor。在 Windows 上，钩子调用 %LOCALAPPDATA%\claude-mem\bin\claude-mem.exe；请重启终端或 IDE，让新的 Path 生效。
相关工作流程
- Claude Code 插件: 比较其他附固定版本来源与发布者资料的插件。
- 如何安装 Claude Code 技能: 插件、skills CLI 与手动复制文件夹三种方式对照。
常见问题
claude-mem 是什么？
thedotmack 发布的插件，记录智能体会话、压缩后在之后的会话中补回相关上下文，首先面向 Claude Code。源码为 GitHub 上的 thedotmack/claude-mem，许可为 Apache-2.0。
如何安装 claude-mem？
在 Claude Code 中运行 /plugin marketplace add thedotmack/claude-mem，再运行 /plugin install claude-mem。也可以在终端运行 CLAUDE_MEM_ONLINE_OPTIN=false npx claude-mem@15.8.1 install。完成后重启 Claude Code。不要用 npm install -g claude-mem：它只安装库，不会注册钩子。
claude-mem 能只用本地记忆、不用托管试用吗？
可以。默认安装器会提供登录和 30 天托管试用。设置 CLAUDE_MEM_ONLINE_OPTIN=false 或显式传入 --provider，安装即可在不涉及账号的情况下完成。除非开启 Cloud Sync，记忆本身保存在本地 SQLite 数据库中。
claude-mem 支持 Codex 吗？
可经 T3 Code 使用：上游 README 记载了针对 T3 管理的 Codex 的 npx claude-mem install --ide t3code。本站不将其列为原生 Codex 插件，AgentSkillsDir 也尚未实测这条路径（待本站实测）。
claude-mem 在 Windows 上不工作，该检查什么？
确认 Node.js 20+ 和 npm 已加入 PATH，然后重启终端或 IDE，让 %LOCALAPPDATA%\claude-mem\bin 中的 claude-mem 启动器能被找到。如果钩子报告找不到 claude-mem，运行 npx claude-mem doctor 并参照上游排障指南。不需要 Git Bash。
claude-mem 已安装但会话什么都不记得，为什么？
安装后需重启 Claude Code 以加载钩子，并开启新会话而不是继续旧会话。在本地查看器中检查是否已保存记录，再运行 npx claude-mem doctor。只用 npm install -g 安装是无效的，因为它不会注册钩子。
这是 skills.sh 上的 claude-mem 吗？
不是。本条目只钉选 thedotmack/claude-mem。skills.sh 或其他市场上的同名技能或软件包来自不同发布者，安装前请核对仓库所有者。
为什么没有 /skills/claude-mem 页面？
claude-mem 是插件，因此唯一页面位于 /plugins/claude-mem。/skills/claude-mem 地址会永久重定向到这里。
添加前请检查
- 先阅读指令并检查脚本，再决定是否执行。
- 检查工具权限、所需凭据和外部网络请求。
- 以来源许可和资源专属条款为准。
