除了使用 Cursor 官方账号提供的模型额度,你也可以绑定自己的第三方 API Key,作为模型调用的备用通道,或用于访问官方未默认集成的特定模型。
适用场景
- 你的团队已有 OpenAI / Anthropic / Azure 的企业协议,希望直接走内部结算;
- Cursor 官方额度耗尽或处于排队状态,想临时切换到自己的密钥保证响应速度;
- 需要调用官方暂未接入的特定模型版本。
配置步骤
- 点击编辑器右上角 头像 → Cursor Settings(或使用快捷键
Ctrl + ,/Cmd + ,),进入设置面板。 - 左侧选择 "Models"(部分旧版本显示为 "OpenAI API Key")。
- 在对应输入框中填入你的 API Key:
- OpenAI:支持标准
sk-开头的 API Key; - Anthropic:支持 Claude 系列的 API Key;
- Azure OpenAI:需同时填写 Endpoint 和 API Key。
- 开启 "Override API Key"(覆盖官方通道)开关。此时,对应模型的请求将直接通过你的密钥发往第三方服务商。
费用与权限说明
启用自有 API Key 后,相关模型的请求费用由你的云厂商账号独立结算,不会消耗 Cursor 官方账号的 fast / slow 额度,也不会经过 Cursor 的服务器中转。但请注意:
- 使用自有 API Key 时,Cursor 的部分深度集成功能(如 Agent 模式的自动批量文件改写、项目级上下文分析)可能仍要求官方订阅权限,此时 API Key 仅作为模型调用的替代通道;
- 如果只是想临时切回官方通道,关闭对应模型的 Override 开关即可,无需删除已保存的 Key。