OpenAI 计划逐步终止向 Cursor 提供 OpenAI 模型的合同。我们提议将过渡期设为截至 2026 年 11 月 12 日。在此期间,我们将继续向 Cursor 提供其目前使用的 OpenAI 模型。Cursor 可能会选择提前停止接入。双方公司确认正式终止日期后,我们会尽快公布。
如需继续在 Cursor 应用中使用 OpenAI 模型,请选择最适合你工作流程的方案:
使用自己的 OpenAI API 密钥 — 继续在 Cursor 的本地聊天和智能体功能中使用 OpenAI 模型,按 OpenAI API 价格计费。
使用 Codex IDE 扩展 — 通过 ChatGPT 订阅或 OpenAI API 密钥,直接在 Cursor 中使用 Codex。
使用 AI 网关提供商 — 通过你在兼容提供商处的账户,将 Cursor 连接到 OpenAI 模型,例如 Amazon Bedrock、Azure 或其他兼容 OpenAI 的网关。
以下指南仅供方向性参考,Cursor 日后可能会调整这些功能及其可用性。请参阅 Cursor 官方文档,了解最新信息。
这些选项适用于 Cursor 桌面应用中的本地工作。Cursor Tab、自动模式、云端或后台智能体、自动化功能、Cursor CLI,以及 Cursor 的 API 和 SDK 均不支持“使用自有密钥”。这些功能使用由 Cursor 提供或路由的模型,无法使用你的 OpenAI API 密钥或网关凭据。
使用你自己的 OpenAI API 密钥
Cursor 支持在本地聊天和智能体功能中使用你自己的 OpenAI API 密钥来调用 OpenAI 模型。请求通过你的 OpenAI API 账户发送,费用与你的 Cursor 或 ChatGPT 订阅分开计算。
配置密钥的步骤如下:
创建 OpenAI API 密钥。访问 API 需要使用已配置计费的 OpenAI API 账户。
打开 Cursor 设置,然后选择模型。
找到 OpenAI API 密钥设置,粘贴你的密钥,然后保存或验证。
启用你想使用的 OpenAI 模型。
在 Cursor 的聊天或智能体模式中选择该模型。
可用模型和用量限制取决于你所属的 OpenAI API 组织。
你的 OpenAI API 密钥仅适用于受支持的本地聊天和智能体请求。它不适用于:
Cursor Tab 和自动补全
自动模式下的模型选择和路由
云端或后台智能体
自动化功能
Cursor CLI
Cursor API 或 SDK
Cursor 提供的模型或专有模型
ChatGPT 订阅不包含 OpenAI API 用量。如果你使用 API 密钥,使用费用将通过你的 OpenAI API 账户结算。
在 Cursor 中使用 Codex IDE 扩展
Codex IDE 扩展可让你直接在 Cursor 中使用 Codex 智能体。它作为独立扩展运行,无论 Cursor 自带的模型选择器中是否提供 OpenAI 模型,都可以使用。
开始使用的步骤如下:
打开上方链接指向的 Codex IDE 扩展页面,选择 Cursor 以安装扩展。
从活动栏打开 Codex。
选择使用 ChatGPT 登录以使用符合条件的 ChatGPT 订阅,或选择使用 API 密钥以使用 OpenAI API 账户。
打开你的项目,然后从 Codex 面板启动任务。
你可以使用 Cursor 的布局控件,将 Codex 面板移到编辑器右侧。从视图 > 外观菜单启用辅助侧边栏,然后将 Codex 视图拖入其中。
Codex 扩展在 Cursor 内提供独立的智能体体验。它不会改变 Cursor 的聊天、智能体、Tab、自动模式、云端智能体或其他 Cursor 服务所使用的模型。有关可用的登录方式,请参阅 Codex 身份验证。
使用 AI 网关提供商
你也可以通过兼容的 AI 网关或托管服务提供商,将 Cursor 连接到 OpenAI 模型。如果你的组织已通过 Amazon Bedrock、Azure 或其他网关管理模型访问和计费,这种方式会很有用。
Cursor 可以通过提供商专属设置进行连接,也可以通过兼容 OpenAI API 的自定义基础 URL 进行连接。OpenRouter 或 Vercel AI Gateway 等服务在配置了兼容的 API 后可能可以使用,但可用的模型和功能取决于提供商。
具体配置因提供商而异,但大致设置步骤如下:
在提供商处开通 OpenAI 模型。
创建所需的凭据、端点以及模型名称或部署名称。
打开 Cursor 设置,然后选择模型。
选择提供商集成,或使用网关的自定义基础 URL 配置 OpenAI API 设置。
输入提供商提供的端点和凭据。
在 Cursor 中添加或启用相应的模型。
在本地聊天或智能体会话中测试该模型。
有关 Amazon Bedrock 的说明,请参阅通过 Amazon Bedrock 使用 OpenAI 模型。
不同网关的兼容性有所不同。自定义端点必须支持 Cursor 要求的 API 格式,而且某些模型特有的控制参数可能无法使用,或无法通过自定义基础 URL 转发。网关凭据同样仅适用于受支持的本地聊天和智能体请求,不适用于 Cursor Tab、自动模式、云端或后台智能体、自动化功能、Cursor CLI,以及 Cursor 的 API 和 SDK。
