Cursor配置OpenRouter API密钥详细教程

前提条件

• 已安装Cursor编辑器
• 已有OpenRouter账户和API密钥
• 已知要使用的模型名称

配置步骤

1. 打开Cursor设置

• 点击右上角的齿轮图标（⚙️）
• 或使用快捷键 Ctrl/Cmd + ,
• 选择左侧菜单中的 Models（模型）

2. 关闭所有现有模型

⚠️ 重要： 在配置自定义API之前，必须先关闭所有现有模型的选择

• 取消勾选所有已启用的模型（GPT-4、Claude等）
• 这是验证成功的关键步骤

3. 配置OpenAI API密钥

在 OpenAI API Key 部分：

• API Key字段：粘贴您的OpenRouter API密钥
• Override OpenAI Base URL：输入 https://openrouter.ai/api/v1
• 点击 Save 保存配置

4. 添加模型

• 滚动到页面底部，找到 Add Model 按钮
• 输入OpenRouter支持的模型名称，例如：
  • anthropic/claude-3.5-sonnet
  • openai/gpt-4o-mini
  • google/gemini-pro
  • mistralai/mistral-7b-instruct
• 按 Enter 键或点击 Add Model 确认

5. 验证配置

• 点击 Verify 按钮验证API配置
• 如果验证成功，开关会变为绿色
• 如果失败，请检查API密钥和模型名称

重要注意事项

模型名称映射

• 必须使用OpenRouter的完整模型名称格式
• 例如：anthropic/claude-3.5-sonnet 而不是 claude-3.5-sonnet
• 避免在自定义模型名称中包含 claude 等关键词，可能被Cursor拦截

验证失败的解决方案

如果验证失败，可以尝试：

1. 重启Cursor：有时需要重启应用程序

2. 使用兼容模式：

   cursor.exe --disable-web-security
   

3. 检查网络连接：确保可以访问OpenRouter服务

4. 重新创建API密钥：在OpenRouter控制台生成新的密钥

功能限制

使用自定义API时的限制：

• ❌ Tab自动补全功能不可用
• ❌ Apply功能不可用
• ❌ Background Agent功能受限
• ✅ 聊天功能正常使用
• ✅ 代码生成功能正常使用

使用方法

在聊天中使用

1. 点击右上角的聊天图标
2. 在模型选择下拉菜单中选择您配置的OpenRouter模型
3. 开始对话即可

选择模型

• 在聊天界面的模型下拉菜单中
• 选择您添加的OpenRouter模型
• 如果只配置了一个模型，会自动选择

故障排除

常见错误及解决方案

“Invalid API Key” 错误

• 检查API密钥是否正确复制
• 确认API密钥在OpenRouter控制台中有效
• 重新生成新的API密钥

模型不可用错误

• 确认模型名称完全正确
• 检查OpenRouter账户是否有足够余额
• 验证模型是否在您的地区可用

连接失败

• 检查网络连接
• 确认Base URL设置正确
• 尝试使用免费模型测试连接

推荐模型配置

免费模型（用于测试）

• openai/gpt-4o-mini（OpenRouter提供免费额度）
• google/gemini-pro
• mistralai/mistral-7b-instruct

付费高质量模型

• anthropic/claude-3.5-sonnet
• openai/gpt-4o
• anthropic/claude-3-opus

小贴士

1. 首次配置：建议先使用免费模型测试配置是否正确
2. 备份配置：记录您的配置参数以备后用
3. 监控使用量：在OpenRouter控制台监控API使用情况
4. 定期更新：关注OpenRouter新增的模型和功能

完成以上配置后，您就可以在Cursor中使用OpenRouter的各种AI模型了！