Cursor 配置 OpenAI API Key：完整步骤，以及 ChatGPT 订阅能不能用

更新于 2026-10-21 · pateway.cyou

简答：可以。先创建 OpenAI API Key 并完成 API 账单设置，再在 Cursor 的 Settings > Models 中粘贴并保存，然后在本地 Chat 或 Agent 里手动选择已启用的 OpenAI 模型。ChatGPT 订阅不含 API 用量，不能代替这把 Key。它也不用于 Tab、Auto、Cloud 或 Background Agents。

定义：Cursor 配置 OpenAI API Key，是把 OpenAI API 账户的密钥填进 Cursor 的 Models 设置，让受支持的本地 Chat 或 Agent 改由该 API 账户调用模型并单独计费。

30 秒速查：Cursor 里先做这 5 步

可以按下面 5 步完成，直接调用 OpenAI 官方接口时不必先改 Base URL。入口是 Cursor 的 Settings > Models：粘贴 OpenAI API Key 并保存或验证，启用模型选择器里的一个 OpenAI 模型，在本地 Chat 或 Agent 中手动选中它，再到 OpenAI 的 Usage 页面看是否出现新请求。ChatGPT 订阅不能代替这把 Key，Tab 补全也不走这把 Key。

1. 在 OpenAI API 账户创建密钥，并完成 API 账单设置。
2. 打开 Cursor Settings > Models，找到 OpenAI，粘贴密钥并保存或验证。
3. 启用模型选择器中列出的一个 OpenAI 模型。
4. 在本地 Chat 或 Agent 里手动选择该模型，不要用 Auto，也不要用 Tab 判断是否生效。
5. 用有 Usage 权限的账户打开 Usage，按 UTC 时间核对是否出现这次请求。

OpenAI 帮助中心的在 Cursor 中使用 OpenAI 模型写明，自有密钥只适用于受支持的本地聊天和智能体。Cursor 帮助文档Bring your own API key写明，路径是 Settings > Models，粘贴密钥后点击 Save。两份文档一个写“保存或验证”，一个写 Save，按钮文案以你当前界面为准。本文为第三方整理的接入指南，不代表 Cursor 或 OpenAI 官方。

创建 OpenAI API Key，并单独配好 API 账单

密钥在 OpenAI API key 页面创建。OpenAI 的密钥管理说明写明，出于安全考虑，完整密钥只在创建时显示一次；没有保存就重新创建，并更新正在使用它的程序。删除时使用该页的垃圾桶图标，删除后依赖旧密钥的程序会无法调用。

1. 登录对应的 OpenAI API 组织，打开 API key 页面，创建一把新的 Secret Key。
2. 页面仍显示完整密钥时，立刻复制到安全位置。不要发到聊天、放进截图，也不要写进代码仓库。
3. 打开同一 API 组织的账单设置，添加支付方式，或按该页要求购买额度。
4. 账单设置完成后再回到 Cursor。只订阅 ChatGPT、没有配置 API 账单时，不要把这把 Key 当成已经可以付费调用。

ChatGPT 与 API 平台的账单说明写明，两边是分开的账单系统。要开始付费 API 用量，需要在 API 账户的账单设置里添加支付方式，API 用量按 API 账户规则计费，不包含在 ChatGPT 订阅里。

OpenAI 预付费账单说明写明，可以预先购买用量额度；设置流程中的 Auto recharge 默认开启，不需要自动充值就在确认购买前关掉。额度用尽后，API 请求会返回已达到账单配额的错误。该说明还写明已购买额度 1 年后过期且不可退款。打开页面时若规则有变，以页面文字为准，本文不抄固定购买金额。

在 Settings > Models 中保存密钥并选模型

按 OpenAI 帮助中心给出的顺序做，不要只粘贴密钥就去试 Tab。

1. 打开 Cursor 设置，选择 模型。英文界面的路径是 Cursor Settings > Models。
2. 找到 OpenAI API Key 设置，粘贴刚创建的密钥。
3. 按界面保存或验证。Cursor 文档写的是点击 Save，OpenAI 文档写的是保存或验证。当前界面没有某个特定英文开关时，以屏幕上的按钮为准，不要反复清空已粘贴的密钥。
4. 启用要使用的 OpenAI 模型。可用模型和使用限额取决于你的 OpenAI API 组织。
5. 在 Cursor 的本地 Chat 或 Agent 中选中该模型，发送一条不含密钥、也不含敏感代码的短请求。

Cursor 的 Bring your own API key 文档把 OpenAI 自有 Key 写成标准、非推理聊天模型，并写明模型选择器会显示当前可用的 OpenAI 模型。选择器里没有的模型，不要用展示名称手填。需要自己填写模型 ID 时，从 OpenAI 模型目录复制实际 id；本文用 <MODEL_ID> 表示这个位置，不写死某一个模型。

直接调用 OpenAI 官方接口时，保持 Cursor 的默认 OpenAI 地址，不要打开自定义 Base URL。

什么时候才填写兼容 Base URL

只有已经有一个 OpenAI 兼容 endpoint，并且服务方文档给出了完整地址时，才填写自定义 Base URL。在 Cursor 中使用 OpenAI 模型写明，Cursor 可以通过自定义的 OpenAI 兼容 Base URL 连接；自定义 endpoint 必须支持 Cursor 需要的 API 格式，部分模型控制项可能不会被转发。网关凭据同样只覆盖受支持的本地 Chat 和 Agent，不覆盖 Tab、Auto、Cloud 或 Background Agents、Automations、CLI、API 和 SDK。

地址按服务方文档填写完整 endpoint。常见形式类似 https://example.com/v1，是否带 /v1 以服务方说明为准，不要只凭一个域名猜测。

用 Usage 确认请求走了自有 Key

是否生效，用一次本地请求加上 Usage 记录判断。不要用 Tab、Auto、Cloud 或 Background Agents 来判断。

1. 确认 Settings > Models 里仍能配置 OpenAI 密钥。企业版若被管理员关闭个人 Key，按下一节的位置自查。
2. 保存或验证后，在本地 Chat 或 Agent 手动选中已启用的 OpenAI 模型，发送一条短请求。
3. 使用有权限的账户查看 Usage。OpenAI Usage 仪表盘说明写明，只有组织所有者或被授予 Usage Dashboard 权限的用户能查看，数据按 UTC 显示。同一时间段出现请求，才说明调用走到了你的 API 账户。
4. 没有新记录时，先分清是无权查看用量，还是请求没有成功。无权查看就改由组织所有者核对；请求失败则按下面的表一次只改一项。

密钥输入框再次打开后是否还会显示明文，本文未在 Cursor 官方文档中核实，不能把空白输入框当成密钥丢失。Bring your own API key核实的是另一件事：密钥不保存在 Cursor 服务器上，但每次请求都会经加密连接发到 Cursor 后端，用于最终提示词构建，请求结束后不持久保存。判断是否保存成功，仍以 Usage 里有没有对应请求为准。

费用、隐私，以及密钥泄露后怎么处理

个人套餐和团队套餐不要混着算。截至 2026-10-21，Cursor 的 Bring your own API key 文档写明：个人计划下，模型费用由提供方收取，这些请求不从套餐内用量或预付费额度扣除；Teams 和 Enterprise 使用自有 Key 时，第三方模型请求仍会计 Cursor Token Rate，该页给出的标准是每百万 token 0.25 美元，包含输入、输出和缓存 token。文档说明这不是把同一笔模型价款再收一次。旧版 Teams 计划下，这笔费用出现在 Spending 页的 Other Models 中。打开该页时若数字已变，以页面为准。

同一篇 Bring your own API key 写明，使用自有 Key 时，Cursor 的 Zero Data Retention 政策不适用，数据处理改按所选提供方的隐私政策。若团队依赖 Zero Data Retention，应改用 Cursor 内置模型，而不是继续用自有 Key。密钥不会留在 Cursor 服务器上，但会随每次请求发到后端，所以不要用它发送你不愿经过该路径的敏感代码。

Cursor 企业版模型与集成管理写明，企业版可以在团队仪表盘的 Team Settings → Models 里，用 Personal API Keys（BYOK） 禁止成员使用个人 API Key，用量改走 Cursor 包含的模型和用量池。这是企业版控制项，不是所有团队套餐都会拿掉入口。成员看不到设置时，先让管理员核对此处，再对照 Cursor 的 Settings > Models 路径。

怀疑密钥已经泄露时，立刻在 API key 页面删除旧密钥，创建新密钥，并更新 Cursor。OpenAI 关于不要共享密钥的说明写明，密钥不要提交到代码中，也不要以明文传播，怀疑暴露后就要轮换。API 密钥安全最佳实践还写明，不要共享密钥，也不要把密钥部署到浏览器或移动应用这类客户端环境。

过渡期说明，以及本文不覆盖的内容

截至 2026-10-21，OpenAI 帮助中心在 Cursor 中使用 OpenAI 模型写明：OpenAI 计划逐步终止向 Cursor 提供 OpenAI 模型的合同，并提议把过渡期设到 2026 年 11 月 12 日；在此期间继续向 Cursor 提供其目前使用的模型。正式终止日期要等双方确认后才公布，Cursor 也可能提前结束访问。这不是已经公布的终止日。上面的自有 Key 配置步骤不因此改变；若界面或支持范围变了，以该文和 Bring your own API key 当时的版本为准。

本文不覆盖 Codex IDE 扩展的安装、其他提供商的 Key、本地模型部署，以及兼容网关怎么选。本文未核实：你当前 Cursor 版本里密钥开关的准确英文文案、某一个具体模型 ID 是否出现在选择器中、兼容服务的 endpoint 是否必须带 /v1。这三项以屏幕上的界面和服务方文档为准。

常见问题

ChatGPT Plus 或 Pro 可以直接当作 Cursor 的 OpenAI API Key 吗？

不能。ChatGPT 和 OpenAI API 是分开的账单。Cursor 里要填的是 API 账户创建的密钥，API 用量按 API 账户计费，不会因为已经订阅 ChatGPT 就自动获得。

配置后 Cursor Tab 为什么还是不用我的 OpenAI API Key？

这是当前文档写明的范围，不是配置失败。自有 Key 用于受支持的本地 Chat 和 Agent；Tab 补全继续使用 Cursor 内置模型。请在本地 Chat 或 Agent 里手动选择已启用的 OpenAI 模型，再用 Usage 核对。

怎样才算确认请求走了自己的 Key？

在本地 Chat 或 Agent 发送一条短请求后，由组织所有者或有 Usage Dashboard 权限的账户打开 Usage，按 UTC 时间查看是否出现记录。只有用量出现，才能说明请求进入了你的 API 账户。看不到 Usage 时，先检查权限，不要立刻判断 Key 无效。

密钥输入框再次打开是空的，代表没有保存吗？

不能这么判断。本文没有在 Cursor 官方文档中核实输入框会不会再次显示明文。请重新粘贴并保存一次，再用本地 Chat 或 Agent 加 Usage 记录验证，不要只看输入框是否空白。

什么时候应该填写 Override OpenAI Base URL？

直接使用 OpenAI 官方接口时保持默认地址。只有服务方文档提供了 OpenAI 兼容 endpoint 时才填写完整地址，并同时核对认证方式和模型 ID。是否带 /v1 以服务方说明为准。界面上的开关英文名以当前 Cursor 版本为准。

企业版里没有个人 API Key 入口怎么办？

企业版管理员可以在团队仪表盘的 Team Settings → Models 中关闭 Personal API Keys（BYOK）。先让管理员查看这项，再对照 Settings > Models。这是企业版控制，不是所有团队套餐都会隐藏入口。

参考资料

1. OpenAI 帮助中心：在 Cursor 中使用 OpenAI 模型
2. Cursor 文档：Bring your own API key（cursor.com）
3. OpenAI 帮助中心：Where do I find my OpenAI API Key?
4. OpenAI 帮助中心：How can I set up prepaid billing?
5. OpenAI API：All models
6. OpenAI 帮助中心：API Usage Dashboard
7. Cursor 文档：Model and Integration Management（cursor.com）
8. OpenAI 帮助中心：Can I share my API key with my teammate/coworker?