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 模型。
开始使用的步骤:
在 Cursor 中安装 Codex IDE 扩展。点击此处(cursor:extension/openai.chatgpt)
从活动栏打开 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 的自定义基础 URL 进行连接。配置兼容的 API 后,OpenRouter 或 Vercel AI Gateway 等服务可能可以使用,但可用的模型和功能取决于提供商。
具体配置因提供商而异,但大致步骤如下:
在你的提供商平台上开通 OpenAI 模型。
创建所需的凭据、端点以及模型或部署名称。
打开 Cursor 设置,然后选择模型。
选择相应提供商的集成,或使用网关的自定义基础 URL 配置 OpenAI API 设置。
输入提供商提供的端点和凭据。
在 Cursor 中添加或启用对应的模型。
在本地聊天或智能体会话中测试该模型。
有关 Amazon Bedrock,请参阅通过 Amazon Bedrock 使用 OpenAI 模型。
不同网关的兼容性有所差异。自定义端点必须支持 Cursor 要求的 API 格式。通过自定义基础 URL 连接时,某些模型特有的控制参数可能不可用,或无法被转发。网关凭据也仅适用于受支持的本地聊天和智能体请求,不适用于 Cursor 的 Tab、自动模式、云端或后台智能体、自动化功能、Cursor CLI 以及 Cursor API 和 SDK。
