Cursor + Gemini 设置¶

使用你的 Google Gemini 密钥，让记忆笔记在订阅计划之外运行（不消耗你的 Claude 订阅）。你无需克隆仓库。

安装¶

1. 在 Google AI Studio 获取密钥。
2. 运行：

npx claude-mem install

选择 Cursor，然后选择 Gemini 作为记忆提供者并粘贴密钥。

手动设置（可选）¶

mkdir -p ~/.claude-mem
cat > ~/.claude-mem/settings.json << 'EOF'
{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
}
EOF

然后重新运行 npx claude-mem install，以便 Cursor 钩子和 worker 就位。不要重启运行正常的 worker。

重启 Cursor¶

关闭并重新打开 Cursor，以便钩子加载。

验证¶

健康检查：curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health"（端口也记录在 ~/.claude-mem/.worker.port 中）。打开安装时生成的 worker URL 即可查看笔记。

模型¶

固定模型：

{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "your-key",
  "CLAUDE_MEM_GEMINI_MODEL": "gemini-3.5-flash"
}

速率限制取决于模型以及 Google Cloud 中是否启用了结算。当结算关闭时，Claude-mem 会拉大请求间隔。在启用 Google 结算后，要关闭这一额外限流：

{
  "CLAUDE_MEM_GEMINI_BILLING_ENABLED": true
}

故障排查¶

未配置密钥——cat ~/.claude-mem/settings.json 应显示 CLAUDE_MEM_PROVIDER 为 gemini 并包含你的密钥。

HTTP 429——等待、启用 Google 结算，或使用 OpenRouter。

Worker 空闲——查看 ~/.claude-mem/logs/worker-YYYY-MM-DD.log。不要重启运行正常的 worker（笔记队列保存在内存中）。

后续步骤¶

• Cursor 集成——默认 CMEM Pro 安装
• OpenRouter
• 配置