Cursor 集成¶

为 Cursor 提供跨越多个聊天会话的持久记忆。安装器会接入 Cursor hooks（Cursor 在会话开始、读取文件或运行工具时执行的小脚本）、启动本地 worker（存储笔记的程序），并使用 CMEM Pro（托管记忆服务），除非你选择其他提供商。

一条命令

npx claude-mem install —— 安装时不要克隆仓库。

默认使用 CMEM Pro

除非你选择 Gemini、OpenRouter 或你的 Anthropic 套餐，否则记忆笔记将通过托管服务以 off-plan 方式写入。

Cursor hooks

Cursor 有 hooks。Grok Bot 没有——该宿主请见另一篇指南。

记忆查看器

打开安装时打印的 worker URL 即可浏览已保存的笔记。

安装¶

npx claude-mem install

当安装器列出你的应用时，选择 Cursor。三个阶段分别是：安装运行时、登录（设备代码，CLI 中不需要邮箱），然后选择记忆提供商。CMEM Pro 为预选项。

其他提供商选项：你的 Gemini key、你的 OpenRouter key，或你的 Anthropic 套餐（--provider claude，会跳过登录步骤；本地安装会在注册时一次性联系 cmem.ai 以创建登录链接，并发送仅含数字的使用摘要（观察次数和 token 总数，不含提示词、路径或项目名称），除此之外不会向 cmem.ai 发送任何内容）。详情：安装。

不要克隆此仓库来安装。克隆仅适用于需要修改代码的人。

工作原理¶

1. Hooks 记录在 Cursor 中执行的操作。
2. Worker 将笔记存储在你的机器上（默认 127.0.0.1，端口在 ~/.claude-mem/.worker.port）。
3. 下一次聊天会获取相关的历史笔记。
4. 查看器在 worker URL 显示知识库。

永远不要重启健康的 worker。笔记队列位于内存中；重启会丢弃队列。

使用 Gemini 或 OpenRouter 替代 CMEM Pro¶

• Gemini —— 使用你的 Google key，记忆 off-plan
• OpenRouter —— 使用你的 OpenRouter key。绝不将个人 sk-or- key 发送到 https://cmem.ai/api/inference

验证是否生效¶

1. 安装后重启 Cursor，以便 hooks 加载。
2. 健康检查：curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health"（或使用 ~/.claude-mem/.worker.port 中的端口）。
3. 完成一个小型任务，然后打开 worker URL。应出现新的笔记。

故障排除¶

没有存储任何内容¶

• 确认 worker 已启动。如果它已经健康，不要重启它。
• 确认你使用的是 npx claude-mem install，而不是全局 npm install。
• 安装后重启一次 Cursor。
• 日志：~/.claude-mem/logs/worker-YYYY-MM-DD.log

Hooks 未触发¶

重启 Cursor。安装后，hooks 位于项目下的 .cursor/ 中，或位于你的用户 Cursor 配置中。

后续步骤¶

• 安装 —— 安装器阶段与 CMEM Pro
• CMEM Pro（手动 / 无头模式） —— 安装器写入的设置
• Gemini / OpenRouter
• 搜索工具 —— 查询项目历史