如何在 Cursor 中免费使用 Gemini 2.5 Pro (2026)

Cursor 自带了 Claude 和 GPT 模型，但这些模型会很快消耗掉你的月度请求配额。许多开发者没有意识到的是，你可以使用免费的 Google AI Studio API 密钥将 Gemini 2.5 Pro 连接到 Cursor。这让你能够以基本上无限的免费额度，使用目前最顶尖的编程模型之一。

本指南将带你走完完整的配置流程，从生成免费 API 密钥到设置 Cursor 以及优化你的工作流。

为什么在 Cursor 中使用 Gemini 2.5 Pro？

在开始设置之前，以下是为什么 Gemini 2.5 Pro 值得加入你的 Cursor 配置：

特性	Gemini 2.5 Pro	Claude Sonnet (Cursor 默认)	GPT-4o (Cursor 默认)
上下文窗口	1,000,000 tokens	200,000 tokens	128,000 tokens
免费 API 层级	是 (5 RPM)	否	否
编程基准测试	顶级	顶级	强劲
多模态输入	文本、图像、视频	文本、图像	文本、图像
通过 Cursor 的成本	$0 (使用自己的密钥)	消耗 Cursor 配额	消耗 Cursor 配额

核心优势： 使用你自己的 API 密钥发起的 Gemini 2.5 Pro 请求不会计入你的 Cursor Pro 或免费版限制。你可以保留 500 次 (Pro) 或 50 次 (免费) 的计算配额给 Claude 和 GPT，同时在 Google 的免费速率限制内无限次使用 Gemini 2.5 Pro。

第一步：获取免费的 Google AI Studio API 密钥

访问 aistudio.google.com/apikey
使用你的 Google 账号登录
点击 Create API Key
选择一个现有的 Google Cloud 项目或创建一个新项目
复制生成的密钥并将其保存在安全的地方

该 API 密钥完全免费。不需要信用卡，也没有试用期限制——它在速率限制内无限期免费。

免费层级速率限制

限制项	额度
每分钟请求数 (RPM)	5
每分钟 Token 数	250,000
每天请求数	100
上下文窗口	1,000,000 tokens

对于 Cursor 中大多数个人开发者的工作流来说，每分钟 5 次请求和每天 100 次请求已经绰绰有余。如果你需要更高的限制，可以为你的 Google Cloud 项目添加账单并按 token 付费。

第二步：在 Cursor 中配置 Gemini 2.5 Pro

Cursor 通过其支持 OpenAI 兼容 API 的配置项支持自定义模型。Google 为 Gemini 模型提供了一个兼容 OpenAI 的端点，使得集成非常简单。

方法 A：通过 Cursor 设置界面

打开 Cursor
进入 Settings (齿轮图标) > Models
滚动到 OpenAI API Key 或 Custom Models
点击 Add Model 或 Add Custom Endpoint
输入以下信息：
- Model Name: gemini-2.5-pro
- Base URL: https://generativelanguage.googleapis.com/v1beta/openai
- API Key: 你的 Google AI Studio API 密钥
点击 Save 并确认该模型出现在模型选择器中

方法 B：通过 Cursor 配置文件

你也可以直接在 Cursor 的设置 JSON 中进行配置。打开命令面板 (Cmd+Shift+P / Ctrl+Shift+P) 并搜索 "Open Settings JSON"：

{
  "cursor.aiModels": {
    "custom": [
      {
        "name": "gemini-2.5-pro",
        "baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
        "apiKey": "YOUR_GOOGLE_AI_STUDIO_KEY",
        "model": "gemini-2.5-pro",
        "contextLength": 1000000
      }
    ]
  }
}

第三步：验证连接

配置完成后，测试 Gemini 2.5 Pro 是否正常工作：

打开一个新的 Cursor 聊天面板 (Cmd+L / Ctrl+L)
在顶部的模型下拉菜单中，选择 gemini-2.5-pro
输入测试指令："编写一个计算斐波那契数列的 Python 函数"
确认你收到了回复

如果你看到错误，请仔细检查：

你的 API 密钥是否正确且已激活
Base URL 是否以 /openai 结尾（而不仅仅是 /v1beta）
你是否超过了免费速率限制

第四步：在不同的 Cursor 模式下使用 Gemini 2.5 Pro

聊天模式 (Chat Mode)

Gemini 2.5 Pro 在 Cursor 的聊天面板中运行顺畅。从模型下拉菜单中选择它，以便用于：

解释代码
调试错误
生成样板代码
回答架构问题

Composer / Agent 模式

在 Agent 模式下，Gemini 2.5 Pro 可以执行多文件编辑。它的 100 万 token 上下文窗口在这里尤其有用，因为它可以将你的整个代码库放入上下文中：

@codebase 重构身份验证模块，使用 JWT token 代替基于 session 的认证。更新所有相关的源文件。

凭借 100 万 tokens 的上下文，Gemini 2.5 Pro 在单次对话中能比 Claude 或 GPT-4o 处理更多的代码逻辑。

行内编辑 (Inline Editing)

对于行内编辑 (Cmd+K / Ctrl+K)，Gemini 2.5 Pro 可以作为直接替代方案。突出显示代码，按下快捷键，输入你的编辑指令。模型将直接在行内建议更改。

第五步：优化你的工作流

大上下文用 Gemini，追求精度用 Claude

一个实用的策略是同时使用这两种模型：

任务	最佳模型	原因
多文件重构	Gemini 2.5 Pro	100万上下文可容纳整个模型库
复杂调试	Claude Sonnet	推理能力极强
生成样板代码	Gemini 2.5 Pro	免费、快速
架构决策	两者皆可	实力都很强
快速单行编写	Gemini 2.5 Flash	最快、免费

通过 Cursor 聊天面板中的下拉菜单切换模型。对于日常任务使用 Gemini，可以为你特别需要 Claude 或 GPT 的时刻节省 Cursor 高级请求次数。

同时添加 Gemini 2.5 Flash

当你添加自定义模型时，也可以添加 Gemini 2.5 Flash 用于快速、轻量化的任务：

{
  "name": "gemini-2.5-flash",
  "baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
  "apiKey": "YOUR_GOOGLE_AI_STUDIO_KEY",
  "model": "gemini-2.5-flash",
  "contextLength": 1000000
}

Gemini 2.5 Flash 拥有更宽松的免费层级（15 RPM，500 RPD）且响应更快。可以将它用于类似自动补全的任务，将 Gemini 2.5 Pro 留给复杂的逻辑推理。

系统提示词 (System Prompts)

Cursor 允许你在 .cursorrules 或设置中为每个模型设置自定义系统提示词。Gemini 2.5 Pro 在编程场景下的理想系统提示词：

你是一名资深软件工程师。编写整洁、生产就绪的代码。
遵循项目中现有的代码规范。优先选择简单的解决方案。
在编写代码前，务必简要解释你的理由。
如果请求不够明确，请要求澄清而非盲目猜测。

常见问题排查

“Model not found” 错误 确保模型名称准确为 gemini-2.5-pro（不是 gemini-2.5-pro-latest 或其他变体）。查看 Google AI Studio 文档以获取当前的模型 ID。

响应缓慢 免费层级有 5 RPM 的限制。如果你触及了该限制，请在请求之间稍作等待，或切换到 Gemini 2.5 Flash 以获得更快的响应。

响应在句中截断 在 Cursor 的模型设置中增加最大输出 token (max output tokens)。Gemini 2.5 Pro 支持高达 65,536 个输出 token。

API 密钥无效 确保你是在 aistudio.google.com/apikey 生成的密钥，而不是在 Google Cloud Console。AI Studio 密钥可直接使用；Cloud Console 密钥则需要额外的 OAuth 设置。

Cursor 下拉菜单中不显示该模型 添加自定义模型后重启 Cursor。如果仍不显示，请检查配置 JSON 是否有效（例如是否有冗余逗号、结构是否正确）。

常见问题 (FAQ)

使用我自己的 API 密钥会违反 Cursor 的服务条款吗？ 不会。Cursor 官方支持自定义 API 密钥和自定义模型端点。这是一项原生支持的功能。

Google AI Studio API 密钥真的是永久免费吗？ Google 提供了一个带有限制的免费层级，并自 Gemini 发布以来一直维持该政策。没有试用期，也不需要信用卡。Google 可能会随时间调整限制，但免费访问一直很稳定。

我可以在 Cursor 的免费 Hobby 计划中使用它吗？ 可以。此设置适用于任何 Cursor 计划，包括免费版。你的 Gemini 请求与你的 Cursor 订阅配额完全独立。

延迟与 Cursor 内置模型相比如何？ Gemini 2.5 Pro 的中等长度输出通常耗时 2-5 秒。这与通过 Cursor 服务器使用的 Claude Sonnet 相当。Gemini 2.5 Flash 则明显更快，约为 1-2 秒。

总结

将 Gemini 2.5 Pro 添加到 Cursor，能让你拥有一个拥有最大上下文窗口且高质量的免费编程模型。整个设置过程不到 5 分钟，你即可立即在免费速率限制内获得无限访问权限——且不会影响你的 Cursor 订阅配额。

对于正在开发 AI 生成媒体应用的开发者，Hypereal AI 提供了图像生成、视频生成和导言数字人的统一 API。免费注册即可开始使用，无需信用卡。