cursor 怎么配置第三方 API
Cursor 支持覆盖 OpenAI Base URL。说明自定义 key 与订阅额度的区别,以及三步配置和验证方法。
agentapiai.com
2026-11-13
约 3 分钟
Cursor 自带模型额度,也允许填自己的 key 和 Base URL。两者计费方式不同,先确认你要用哪一种。
第一步:打开模型设置
Cmd/Ctrl + Shift + J 打开设置,进入 Models。
第二步:填写 OpenAI 配置
- 打开 OpenAI API Key,填入你的 key。
- 展开 Override OpenAI Base URL,填
https://relay.example.com/v1。 - 在 Add model 里填网关支持的模型名,例如
gpt-5.5。
第三步:验证
新建一个对话,选择刚添加的模型,发一句“reply with OK”。再到 Settings 里确认请求走的是自定义 key。
常见报错
- 404:Base URL 少了
/v1,或模型名不在网关列表。 - 401:key 无效;注意 Cursor 有时会缓存旧 key,改完重启一次。
- 模型不出现在列表:手动 Add model,名字必须与网关完全一致。
- 补全功能不生效:Tab 补全走 Cursor 自己的模型通道,不一定走自定义 key。
注意
- 自定义 key 的用量由网关计费,不占用 Cursor 订阅额度。
- 团队环境不要把 key 写进项目配置;Cursor 的设置是用户级的。
- 版本更新可能调整入口位置,找不到时在设置里搜索 “OpenAI”。