Cursor + Gemini 配置

本指南将引导您使用 Google 的 Gemini API 在 Cursor 中设置 Claude-Mem。Gemini 提供了一个慷慨的免费层，可满足典型的个人使用需求。

免费套餐： 每天1,500次请求，适用于gemini-2.5-flash-lite。无需信用卡。

步骤 1：获取 Gemini API 密钥

1. 前往 Google AI Studio
2. 使用您的 Google 帐号登录
3. 接受服务条款
4. 点击 创建 API 密钥
5. 选择或创建一个 Google Cloud 项目
6. 复制你的 API 密钥——你将在步骤 3 中需要它

更高的速率限制： 在您的 Google Cloud 项目上启用计费，以解锁 4,000 RPM（未启用计费时为 10 RPM）。只有在超出免费配额时才会收费。

第2步：克隆并构建 Claude-Mem

# Clone the repository
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem

# Install dependencies
bun install

# Build the project
bun run build

步骤 3：配置 Gemini 提供程序

选项 A：互动设置（推荐）

运行设置向导，它会引导你完成所有步骤：

bun run cursor:setup

巫师将会：

1. 检测到你尚未配置 Claude Code
2. 提示你选择 Gemini 作为提供商
3. 请输入您的 API 密钥
4. 自动安装钩子
5. 启动 Worker 进程

选项 B：手动配置

手动创建设置文件：

# Create settings directory
mkdir -p ~/.claude-mem

# Create settings file with Gemini configuration
cat > ~/.claude-mem/settings.json << 'EOF'
{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
}
EOF

用你的实际 API 密钥替换 YOUR_GEMINI_API_KEY。

然后安装钩子并启动 Worker 进程：

bun run cursor:install
bun run worker:start

步骤 4：重启 Cursor

关闭并重新打开 Cursor IDE，以使钩子生效。

步骤5：验证安装

# Check worker is running
bun run worker:status

# Check hooks are installed
bun run cursor:status

打开 http://localhost:37777 查看内存查看器。

可用的Gemini模型

模型	免费额度 RPM	备注
gemini-2.5-flash-lite	10（计费时为 4,000）	默认。 最快，免费层 RPM 最高
gemini-2.5-flash	5（计费时为1,000）	更高的能力
gemini-3-flash-preview	5（计费时为1,000）	最新型号

要更改模型，请更新您的设置：

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

速率限制

Claude-mem 会自动处理免费套餐使用的速率限制：

• 请求间隔以保持在限制范围内
• 处理可能会稍慢，但仍在配额范围内
• 没有错误或丢失的观测值

要移除速率限制： 在您的 Google Cloud 项目中启用计费，然后添加到设置：

{
  "CLAUDE_MEM_GEMINI_BILLING_ENABLED": true
}

您仍然可以使用免费配额，但速率限制会高得多。

故障排除

未配置 Gemini API 密钥

确保您的设置文件存在并且格式正确：

cat ~/.claude-mem/settings.json

应该输出类似这样的内容：

{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "AIza..."
}

速率限制错误（HTTP 429）

您已超出免费套餐的限制。选项：

1. 等待几分钟以重置速率限制
2. 在 Google Cloud 上启用计费以解锁更高的限制
3. 切换到 OpenRouter 以满足更高的容量需求

API 密钥无效

1. 在 Google AI Studio 验证您的密钥
2. 确保你的 settings.json 中没有多余的空格或换行
3. 尝试生成一个新的 API 密钥

Worker 进程未处理观测

检查 Worker 日志：

bun run worker:logs

查找与 Gemini API 调用相关的错误消息。

稍后更换供应商

您可以随时通过更新设置在 Gemini、OpenRouter 和 Claude SDK 之间切换。无需重启——更改将在下一次观察时生效。

{
  "CLAUDE_MEM_PROVIDER": "openrouter"
}

下一步

• Cursor集成概述 - 所有 Cursor 功能
• OpenRouter 设置 - 拥有 100 款模型的替代提供商]
• 配置参考 - 所有设置选项]