Cursor + OpenRouter 配置

本指南将指导您使用 OpenRouter 在 Cursor 中设置 Claude-Mem。OpenRouter 提供来自各个提供商的 100 个 AI 模型的访问权限，包括几个免费选项。

**模型种类：**通过单一 API 密钥即可访问 Claude、GPT-4、Gemini、Llama、Mistral 及更多模型。

第1步：获取 OpenRouter API 密钥

1. 前往 OpenRouter
2. 注册或登录
3. 打开 API Keys
4. 点击 创建密钥
5. 复制你的 API 密钥——你将在步骤 3 中需要它

可用的免费模型： OpenRouter 提供多个模型的免费版本，包括 Gemini Flash 等。请查看 model list 了解当前的免费选项。

第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步：配置 OpenRouter 提供商

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

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

bun run cursor:setup

当提示选择提供商时，选择 OpenRouter。

选项 B：手动配置

手动创建设置文件：

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

# Create settings file with OpenRouter configuration
cat > ~/.claude-mem/settings.json << 'EOF'
{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY"
}
EOF

将 YOUR_OPENROUTER_API_KEY 替换为您的实际 API 密钥。

然后安装钩子并启动 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 以查看内存查看器。

推荐型号

免费模型

模型	提供商	备注
google/gemini-2.0-flash-exp:free	Google	快速，强大
xiaomi/mimo-v2-flash:free	小米	通用良好

付费模型（低成本）

型号	大约成本	备注
anthropic/claude-3-haiku	~$0.25/每百万 token	快速，高效
google/gemini-flash-1.5	~$0.075/1M token	超值
mistralai/mistral-7b-instruct	~$0.07/1M token	预算选项

要指定一个模型，请在设置中添加：

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "your-key",
  "CLAUDE_MEM_OPENROUTER_MODEL": "google/gemini-2.0-flash-exp:free"
}

成本管理

OpenRouter 按每个 token 收费。要控制成本：

1. 使用免费模型： 有几种高质量的免费模型可用
2. **监控使用情况：**检查你的 OpenRouter dashboard
3. 设置支出限制： 在 OpenRouter 设置中配置限制

成本意识： 与 Gemini 的免费层不同，OpenRouter 的付费模型按请求收费。如果使用付费模型，请监控你的使用情况。

故障排除

OpenRouter API 密钥未配置

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

cat ~/.claude-mem/settings.json

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

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "sk-or-..."
}

未找到模型

1. 检查 OpenRouter Models 中的模型 ID 是否正确
2. 有些模型可能需要付费——请检查你是否有积分
3. 免费的模型在其ID中有:free后缀

速率限制

OpenRouter 的速率限制因型号和您的账户等级而异。如果达到限制：

1. 稍等片刻后重试
2. 考虑升级您的 OpenRouter 账户等级
3. 切换到不太受欢迎的型号

API 错误

查看 Worker 日志以获取详细信息：

bun run worker:logs

常见问题：

• 无效的 API 密钥（请在 OpenRouter 重新生成）
• 付费模型的积分不足
• 模型暂时不可用

稍后更换供应商

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

{
  "CLAUDE_MEM_PROVIDER": "gemini"
}

下一步

• Cursor Integration Overview - 所有 Cursor 功能
• Gemini Setup - 替代的免费提供者
• Configuration Reference - 所有设置选项