跳到正文
funcoding.ai
← Cursor

Cursor · 自定义模型

Cursor 配置自定义模型:使用自己的 API Key

在 Cursor 里填入 OpenAI、Anthropic、Google、Azure、AWS Bedrock 的 API Key,覆盖 OpenAI Base URL 接入兼容服务,以及需要注意的限制。

2 分钟读完

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 角色

配置步骤

  1. 打开 Cursor 设置,进入 Models 页面
  2. 在 API Keys 区域找到对应的提供方,填入 Key 并启用
  3. 回到 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 兼容接口的开源智能体。