Cursor 自带多家厂商的模型,大多数情况下直接在模型选择器里切换即可。如果你想用自己的 API Key 付费,或者接入公司内部的模型服务,可以使用 BYOK(Bring Your Own Key)。
支持的提供方
- OpenAI
- Anthropic:Anthropic API 上的 Claude 模型
- Google:Google AI API 上的 Gemini 模型
- Azure OpenAI:你在 Azure 上部署的模型
- AWS Bedrock:在 IDE 里填 AWS 访问密钥,或在 Cursor 后台配置 IAM 角色
配置步骤
- 打开 Cursor 设置,进入 Models 页面
- 在 API Keys 区域找到对应的提供方,填入 Key 并启用
- 回到 Agent 面板,在模型选择器里选择要用的模型
接入 OpenAI 兼容服务
Models 设置里的 Override OpenAI Base URL 可以把 OpenAI 请求改发到其他兼容 OpenAI 接口的服务,然后添加对应的自定义模型名。
社区反馈中需要留意:
- 开启覆盖后,所有走 OpenAI 通道的请求都会改发到新地址,可能影响 Cursor 自带的模型,需要时手动切换开关
- 不同版本的行为可能有差异,遇到问题先查看官方论坛的最新说明
限制与计费
- 自己的 Key 只用于对话类模型,Tab 补全仍然使用 Cursor 自带的模型
- 个人套餐(Pro、Pro+、Ultra):模型费用由提供方向你收取,不占用套餐内额度
- 团队和企业套餐:模型费用由提供方收取,但每次第三方模型请求(包括用自己 Key 的请求)会按 Cursor Token Rate 计费,具体以官方文档为准
数据与隐私
- 你的 Key 不会保存在 Cursor 服务器上,但每次请求都会经过 Cursor 的后端(用于组装最终提示词),传输全程加密,请求结束后不保留
- 使用自己的 Key 时,Cursor 的零数据保留(Zero Data Retention)政策不适用,数据处理遵循你所选提供方的隐私政策
想完全使用自定义模型?
因为请求一定会经过 Cursor 后端,Cursor 无法直接连接只在你内网的模型服务。如果需要完全本地或内网部署,可以考虑 Cline、Continue、OpenCode 等支持任意 OpenAI 兼容接口的开源智能体。