Cursor + OpenRouter 配置

# Cursor + OpenRouter 设置 {#cursor--openrouter-setup}

使用你的 OpenRouter 密钥，让记忆笔记在你的 OpenRouter 额度上运行。你**无需**克隆仓库。

!!! warning

    **切勿**将个人的 `sk-or-` 密钥发送到 `https://cmem.ai/api/inference`。对于你自己的 OpenRouter 账户，请将 base URL 留空（或设为 `https://openrouter.ai/api/v1`）。CMEM Pro 使用 cmem.ai 推理 URL 和 **CMEM Pro** 密钥，而不是你的 OpenRouter 密钥。

## 安装 {#install}

1. 在 [OpenRouter API Keys](https://openrouter.ai/keys) 创建一个密钥。
2. 运行：

```bash
npx claude-mem install

选择 Cursor，然后选择 你的 OpenRouter 密钥 作为记忆提供方。

Warning

npm install -g claude-mem 只安装库本身。始终使用 npx claude-mem install 进行安装。

手动设置（可选）¶

mkdir -p ~/.claude-mem
cat > ~/.claude-mem/settings.json << 'EOF'
{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY"
}
EOF

对于 OpenRouter 本身，请将 CLAUDE_MEM_OPENROUTER_BASE_URL 保持未设置。然后重新运行 npx claude-mem install，以便 Cursor 钩子和 worker 就位。不要重启运行正常的 worker。

重启 Cursor¶

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

验证¶

健康检查：curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health"。打开安装时显示的 worker URL 即可查看笔记。

模型¶

如果你不希望使用默认模型，请设置 CLAUDE_MEM_OPENROUTER_MODEL。OpenRouter 上的免费模型 ID 通常以 :free 结尾——请查看模型列表。

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "your-key",
  "CLAUDE_MEM_OPENROUTER_MODEL": "poolside/laguna-xs-2.1:free"
}

其他 OpenAI 兼容服务器¶

OpenRouter 提供方是一个通用的 OpenAI 兼容客户端。将 CLAUDE_MEM_OPENROUTER_BASE_URL 设置为 DeepSeek、LM Studio，或任何支持 /chat/completions 的网关。模型 ID 会按原样发送。

Info

Base URL 解析： 当 CLAUDE_MEM_OPENROUTER_BASE_URL 为空（默认）时，请求将原样发送到 OpenRouter。设置后，claude-mem 会向 <base_url>/chat/completions 发送 POST 请求——你可以提供类似 https://api.deepseek.com/v1 的基础 URL（会自动附加 /chat/completions 路径），也可以提供完整的 .../chat/completions URL（保持原样）。尾随斜杠会被规范化，且 base URL 必须是 http/https URL（设置 UI 会拒绝其他任何值；手工编辑为非 HTTP URL 会导致请求失败，直到修复为止）。base URL 上的查询字符串或片段会保留，同时 /chat/completions 后缀保留在请求路径中，因此 https://my-gateway.example.com/v1?key=abc 会解析为 https://my-gateway.example.com/v1/chat/completions?key=abc。环境变量 OPENROUTER_BASE_URL 会作为回退值被采用。使用 claude-mem observer 时，base URL 由 npx claude-mem install 管理，设置 UI 会将其显示为只读。

DeepSeek¶

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "https://api.deepseek.com",
  "CLAUDE_MEM_OPENROUTER_MODEL": "deepseek-chat",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_DEEPSEEK_API_KEY"
}

LM Studio（本地）¶

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "http://localhost:1234/v1",
  "CLAUDE_MEM_OPENROUTER_MODEL": "your-local-model-id"
}

IO Intelligence（io.net）¶

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "https://api.intelligence.io.solutions/api/v1",
  "CLAUDE_MEM_OPENROUTER_MODEL": "meta-llama/Llama-3.3-70B-Instruct",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_IO_INTELLIGENCE_API_KEY"
}

模型 ID 是来自 IO Intelligence 模型列表的 org/name 对，例如 deepseek-ai/DeepSeek-R1-0528 或 zai-org/GLM-4.6。

故障排查¶

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

找不到模型 — 请在 OpenRouter Models 检查该 ID。

Worker 空闲 — 查看 ~/.claude-mem/logs/worker-YYYY-MM-DD.log。不要重启运行正常的 worker。

后续步骤¶

Cursor 集成 — 默认 CMEM Pro 安装
Gemini
配置 ```

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/claude-mem