在 cursor 中成功配置 google gemini api key 需三步：先在 google ai studio 创建并复制纯文本密钥（无引号、换行、空格）；再在 cursor settings → models 中粘贴密钥并保存（不填 base_url、不选模型、不启用 openai 兼容）；最后通过 ctrl/cmd+l 发送“hello”并确认状态栏显示“using google gemini”，且确保处于普通 chat 模式而非 agent composer。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在 Cursor 编辑器里直接调用 Google Gemini API 生成代码、解释逻辑或重构项目，但卡在 Key 填哪里、填什么格式、填完为什么没反应——这三步不走对，后续所有功能都跑不起来。
获取 Gemini API Key
打开 Google AI Studio（https://aistudio.google.com/），登录你的 Google 账号 → 点击左上角菜单 → 选择「Manage API Keys」→ 点击「Create API Key」→ 复制弹出的密钥字符串。
【密钥必须是纯文本，不能带引号、换行或空格】如果复制后开头结尾多了双引号，删掉；如果粘贴时自动换行，手动合并成一行。
这一步操作起来很简单，直接把密钥拖进记事本核对一遍就行。
在 Cursor 中填写 Key
打开 Cursor → 点击右上角齿轮图标 → 进入 Settings → 左侧选择 Models → 找到 Google API Key 区域 → 把刚复制的密钥粘贴进去 → 点击 Save。
注意：这里只填 Key，【不填 base_url，不选模型名，不启用 OpenAI 兼容开关】。Gemini 是原生支持通道，和 OpenAI 接口完全独立。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
填完立刻生效，无需重启 Cursor。
验证是否成功
第一步：按 Ctrl/Cmd + L 打开聊天框 → 输入 “Hello” → 发送。
第二步：观察右下角状态栏。如果显示 “Using Google Gemini”，说明已切换成功；如果仍显示 “Using GPT-4o” 或 “Loading…”，说明 Key 未生效。
第三步：若失败，回到 Settings → Models → 检查 Google API Key 输入框右侧是否有红色感叹号图标 → 有则代表 Key 格式错误或已被禁用 → 重新生成 Key 并粘贴。
第四步：确认当前对话模式不是 Agent Composer —— 【Agent Composer 模式下 Gemini 不可用】，必须切换回普通 Chat 模式才能调用。
