How to Add an API Key to Cursor：从添加密钥到成功调用
简答：在 Cursor 桌面端打开 Settings > Models，找到对应的 OpenAI、Anthropic 或 Google 提供商，粘贴 API Key 后点击 Save 或 Verify，再启用可用模型，并在 Chat 或 Agent 中选择它。自有 API Key 通常只影响本地 Chat 和 Agent 请求，不会自动替换 Tab 补全、Auto、Cloud Agents 或 Cursor CLI 使用的模型。
定义：Cursor API Key 配置，是把模型提供商签发的 API 密钥添加到 Cursor 的 Models 设置中，让支持的本地 Chat 或 Agent 请求使用该提供商账户及其计费、权限和模型额度。
先照做：Cursor 添加 API Key 的最短步骤
如果你的目标只是把自己的 API Key 加到 Cursor，先完成下面这组最小闭环。Cursor 官方当前文档将桌面端入口指向 Settings > Models，支持的提供商包括 OpenAI、Anthropic、Google、Azure OpenAI 和 AWS Bedrock；不同版本的按钮可能显示为 Save、Verify 或相近文案。
- 在对应模型提供商的控制台创建 API Key，并确认账户具有 API 调用权限或已配置所需计费设置。
- 打开 Cursor 桌面应用，进入
Settings，再打开Models。 - 找到要使用的提供商，例如
OpenAI、Anthropic或Google。 - 把 API Key 粘贴到该提供商的密钥输入框，不要把前后空格、引号或换行一起复制进去。
- 点击
Save或Verify。如果密钥被提供商拒绝，该提供商对应的请求会继续失败，直到你更新或移除密钥。 - 在模型列表中启用目标模型，然后打开 Cursor Chat 或 Agent，手动选择该模型发送一条简单请求。
Cursor 官方说明了这一配置流程，并指出自有 API Key 只适用于聊天模型；Tab 补全仍使用 Cursor 内置模型。参见 Cursor 的 Bring your own API key 文档。
API Key、Cursor 登录和 ChatGPT 订阅不是一回事
添加 API Key 不等于登录 Cursor 账号。Cursor 登录账号用于访问编辑器、工作区和订阅功能；API Key 则代表你在 OpenAI、Anthropic 或 Google 等模型提供商处的调用身份。
| 项目 | 作用 | 费用或权限归属 |
|---|---|---|
| Cursor 账号登录 | 登录编辑器、同步账户、使用 Cursor 服务 | 由 Cursor 账户和套餐决定 |
| 模型提供商 API Key | 让支持的 Chat 或 Agent 请求使用指定提供商 | 通常由对应提供商按 API 账户计费 |
| ChatGPT 订阅 | 用于符合条件的 ChatGPT 产品或 Codex 扩展登录 | 不自动包含 OpenAI API 用量 |
| Cursor 内置模型 | 使用 Cursor 提供或路由的模型 | 按 Cursor 当前套餐、额度和用量规则处理 |
OpenAI 官方明确说明，ChatGPT 订阅不包含 OpenAI API 用量；如果在 Cursor 中使用 OpenAI API Key，调用费用会通过 OpenAI API 账户结算。相关说明见 OpenAI 关于在 Cursor 中使用模型的帮助文档。
OpenAI、Anthropic 和 Google API Key 怎么准备
Cursor 中的配置入口相似，但密钥的创建位置、权限和模型可用范围由各提供商决定。不要直接套用其他平台的模型名、Base URL 或接口路径；在 Cursor 的模型选择器中，以当前账户实际显示的可用模型为准。
| 提供商 | 准备方式 | 在 Cursor 中核对什么 |
|---|---|---|
| OpenAI | 在 OpenAI API 平台创建 API Key，并确认 API 账户已满足调用所需的计费和权限条件。 | OpenAI 提供商开关、模型是否出现在模型选择器、组织账户是否允许该模型。 |
| Anthropic | 在 Anthropic 的开发者控制台创建 API Key，并确认账户有对应 API 访问权限。 | Claude 模型是否可用，以及密钥是否属于正确的 Anthropic 账户。 |
| 在 Google AI Studio 或关联的 Google Cloud 项目中管理 Gemini API Key。 | 密钥限制、项目权限和 Gemini 模型是否被当前账户启用。 |
Google 的官方文档说明，Gemini API Key 与 Google Cloud 项目、权限和配额有关，并建议对密钥设置适当限制；相关信息见 Google Gemini API Key 文档。OpenAI API 的入口可从 OpenAI API Platform进入。对于 Anthropic，密钥创建和账户权限应以其当前开发者控制台及官方文档为准。
配置后如何确认真的生效
不要只看输入框是否保存成功，建议按“模型出现—请求成功—费用归属”三步核验。
- 确认模型出现：返回模型选择器，检查目标提供商的模型是否可选。如果模型没有出现，先确认提供商密钥保存成功，再检查团队权限或模型访问限制。
- 确认最小请求：在 Chat 或 Agent 中发送一个不涉及敏感代码的简单问题，例如“解释当前文件中一个函数的作用”。如果请求能返回结果，说明至少完成了基本调用链路。
- 确认使用的模型：检查当前会话顶部或模型选择器中是否确实选中了目标模型，不要把 Cursor 内置模型的成功响应误认为自有 API Key 已生效。
- 确认费用归属：个人方案下，提供商通常负责模型调用费用；团队或企业方案可能仍有 Cursor 相关用量规则。应同时查看 Cursor 当前账户页面和模型提供商的用量页面。
Cursor 官方还说明，使用自有 API Key 时，请求会经过 Cursor 后端进行最终提示词构建，密钥通过加密连接传输，但这不等同于 Cursor 的 Zero Data Retention 政策仍然适用；数据处理还要参考所选模型提供商的隐私规则。参见 Cursor API Key 文档。
哪些功能不会使用你添加的 API Key
这是最容易产生误解的边界：把 API Key 添加到 Cursor，并不会让所有 AI 功能都自动切换到该密钥。
| 功能 | 是否使用桌面端自有 API Key | 说明 |
|---|---|---|
| 本地 Chat | 支持 | 在支持的提供商和模型范围内，可以使用自有 Key。 |
| 本地 Agent | 支持 | OpenAI 官方将本地 Chat 和 Agent 列为适用范围。 |
| Tab 自动补全 | 通常不支持 | Cursor 文档明确表示 Tab 补全继续使用 Cursor 内置模型。 |
| Auto 模型选择 | 不应假定支持 | 自动路由可能仍由 Cursor 处理。 |
| Cloud 或 Background Agents | 不支持 OpenAI BYOK | 相关请求使用 Cursor 提供或路由的模型。 |
| Cursor CLI、API 和 SDK | 不支持桌面端 BYOK | 这些入口有独立的认证和服务边界。 |
| Codex IDE 扩展 | 独立认证 | 它在 Cursor 内运行，但不改变 Cursor Chat、Agent 或 Tab 的模型配置。 |
OpenAI 的官方说明特别列出了 Tab、Auto、Cloud 或 Background Agents、Automations、Cursor CLI、Cursor API 和 SDK 等不适用范围。参见 OpenAI 的 Cursor 使用说明。
常见错误排查：按现象判断下一步
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| API Key 无效或被拒绝 | 密钥是否复制完整、是否过期、是否来自正确账户 | 重新生成或轮换密钥，删除多余空格后再次 Save 或 Verify。 |
| 模型列表没有目标模型 | 提供商开关、账户权限、模型可用性 | 先启用提供商，再重新加载模型列表；不要手写未核实的模型 ID。 |
| Settings 中看不到 API Keys | 当前账号类型和团队策略 | 如果属于团队或企业工作区，联系管理员确认是否限制个人 API Key。 |
| 请求提示额度不足或付款问题 | 模型提供商 API 账户余额、账单和组织权限 | 到对应提供商控制台检查用量、付款方式和组织权限；Cursor 订阅不能替代 API 账户计费。 |
| 自定义 Base URL 失败 | 提供商是否支持该集成、端点格式和模型名称 | 先用 Cursor 已列出的官方提供商配置验证，再按服务商给出的端点和模型名填写；不要重复拼接 /v1。 |
| Chat 成功但 Tab 没变化 | 功能边界 | 这通常不是密钥失败，因为 Cursor 文档说明 Tab 补全继续使用内置模型。 |
团队或企业管理员可能限制个人 API Key。Cursor 的企业文档说明，管理员可以在团队模型设置中控制成员是否使用个人 API Key；如果入口消失，先确认是否属于受管控工作区，再联系管理员调整策略。参见 Cursor 模型与集成管理文档。
安全保存、撤销和轮换 API Key
- 不要把 API Key 写入项目源码、
.env示例文件、Git 提交记录、Issue、聊天记录或公开截图。 - 为不同设备、项目或团队用途使用不同密钥，便于出现异常用量时定位和撤销。
- 发现密钥泄露后，优先在提供商控制台立即撤销或轮换，再检查用量记录和相关项目。
- 不要把 Cursor 的登录密码、Cursor API Key 和模型提供商 API Key 混用。
- 如果团队依赖特定的数据保留协议，先确认自有 API Key 是否改变数据处理路径；Cursor 文档明确提示，使用自有密钥时应参考所选提供商的隐私政策。
截至 2026 年 10 月 27 日，OpenAI 的帮助页面还提示其与 Cursor 的模型合作存在拟议的过渡时间点，页面列出的日期是 2026 年 11 月 12 日，但最终安排可能变化。因此，如果你依赖 OpenAI 模型，配置成功后仍应查看 Cursor 和 OpenAI 的最新官方说明，不要把当前可用性当作长期承诺。
结论：最稳妥的配置顺序
最稳妥的顺序是：先确认提供商账户和 API Key 有效，再在 Cursor 的 Settings > Models 中保存密钥，启用列表中实际可用的模型，最后在本地 Chat 或 Agent 发送最小请求。遇到问题时，先区分是密钥、模型权限、团队策略、额度，还是功能本身不支持自有 Key。
本文是独立整理的使用指南，不代表 Cursor 官方；涉及按钮名称、模型列表、团队策略和费用的内容，应以 2026 年 10 月 27 日看到的官方页面及你的当前账户为准。
常见问题
Cursor 添加 API Key 后，Tab 自动补全会改用我的密钥吗？
通常不会。Cursor 官方文档明确说明，自有 API Key 只适用于聊天模型，Tab 补全继续使用 Cursor 的内置模型。因此 Chat 成功而 Tab 没有变化，不一定代表密钥配置失败。
ChatGPT 订阅可以直接当作 OpenAI API Key 使用吗？
不能直接等同。ChatGPT 订阅不包含 OpenAI API 用量；在 Cursor 中使用 OpenAI API Key 时，需要使用 OpenAI API 账户，并按照 OpenAI API 账户的权限和计费规则处理。
为什么 Cursor 里看不到 API Keys 入口？
先确认你打开的是 Cursor 桌面端的 Settings > Models，而不是其他设置页面。如果你加入了团队或企业工作区，管理员可能限制个人 API Key；此时需要联系管理员确认团队模型设置。
API Key 保存成功但模型仍然不可用，应该怎么办？
依次检查提供商是否启用、模型是否出现在模型选择器、API 账户是否有权限和额度，以及当前模型是否属于该提供商。不要直接填写搜索结果中的模型名或 Base URL；以 Cursor 当前列表和提供商官方文档为准。
在 Cursor 中使用自有 API Key，数据还适用 Cursor 的 Zero Data Retention 吗？
不能默认适用。Cursor 官方说明，使用自有 API Key 时，Zero Data Retention 政策不适用，数据处理应参考你所选模型提供商的隐私政策和协议。
Cursor CLI 能使用我在桌面端添加的 API Key 吗？
不能把两者视为同一套配置。OpenAI 官方说明，桌面端自有 API Key 不适用于 Cursor CLI；CLI、API 和 SDK 有独立的认证与服务边界。
相关阅读
- 如果你还要配置 Cline 的 OpenAI 兼容 API，可继续看 Base URL、模型 ID 与排错步骤
- 如果你的 API Key 还要接入 Dify，可参考 Base URL、模型名和请求失败排查
- 浏览更多 AI API、模型调用和客户端接入指南
参考资料
- Cursor：Bring your own API key（cursor.com）
- OpenAI：Using OpenAI models in Cursor
- Google AI for Developers：Using Gemini API keys
- OpenAI API Platform