首页/教程/cursor 怎么配置第三方 API
工具配置

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”。