Cursor 是目前使用很广的 AI 代码编辑器。它自带模型额度，但也支持填入自己的 API Key 和 Base URL。对于国内团队来说，用自己的网关有三个好处：访问更稳定、账单统一、模型可以随时切换。

本文讲清楚 Cursor 自定义 API 的配置方法、常见坑，以及「订阅」和「自带 Key」怎么选。

Cursor 版本更新较快，设置菜单名称可能变化。本文以 2026 年 10 月常见版本为例，具体以你当前版本的 Settings 为准。

一、先理解 Cursor 的两种用法

1. 用 Cursor 自带额度

开箱即用，按 Cursor 的套餐计费。适合不想折腾、用量不大的个人用户。

2. 用自己的 API Key

在 Cursor 里填入第三方 OpenAI 兼容接口的 Key 和 Base URL，调用费用走你自己的 API 账户。适合：

  • 国内访问官方接口不稳定。
  • 团队希望统一账单和额度。
  • 需要指定模型或切换多家模型。
  • 想把 Cursor 的用量纳入公司成本管理。

注意：即使填了自己的 Key，Cursor 的部分功能仍可能要求有效套餐。以 Cursor 当前版本和套餐规则为准。

二、准备 API Key

  1. 打开 中商起航 AI 网关 并登录。
  2. 进入「API 密钥」，新建一个 Key，名称写 cursor-工作电脑。
  3. 设置额度上限和过期时间。
  4. 复制 Key，保存到密码管理器。
  5. 在钱包充值，确认余额。

Base URL 使用：

https://ai.zhongshangqihang.com/v1

这是 OpenAI 兼容地址。Cursor 的自定义 API 功能通常按 OpenAI 协议调用，所以不要填 Anthropic 的根地址。

三、在 Cursor 里配置

不同版本的菜单路径略有差异，通常在：

Cursor Settings → Models → OpenAI API Key

操作步骤：

  1. 打开 Cursor 设置（快捷键通常是 Cmd/Ctrl + ,）。
  2. 找到 Models 或 OpenAI API Key 区域。
  3. 打开「Override OpenAI Base URL」或类似的开关。
  4. Base URL 填 https://ai.zhongshangqihang.com/v1。
  5. API Key 填 sk-...。
  6. 在模型列表里添加你要用的模型名，例如 gpt-5、claude-sonnet-4-5。
  7. 保存后新建一个对话，选择自定义模型测试。

如果 Cursor 提示「API Key invalid」：

  • 检查 Key 是否完整复制。
  • 检查 Base URL 是否以 /v1 结尾。
  • 检查余额是否充足。
  • 检查模型名是否在当前账号可用。

四、模型怎么选

Cursor 里常见的任务分三类：

任务 建议模型 原因
日常补全、改小 Bug 轻量/快速模型 延迟低、成本低
多文件重构、复杂 Agent Claude Sonnet / GPT 主力模型 代码理解与工具调用更稳
难题推理、架构设计 Opus / 高配模型 能力更强，成本更高

模型名必须以 模型价格 页面为准。Cursor 的模型下拉列表可能只显示它认识的名称；如果自定义模型没有出现，可以手动添加或选择兼容的模型别名。

五、订阅和自带 Key，哪个更省

没有统一答案，取决于用量。可以用下面的方法估算：

  1. 统计你每天大概发多少条请求、每条多少上下文。
  2. 看 Cursor 套餐的价格和额度。
  3. 用 API 价格页估算同样用量的 Token 成本。
  4. 把「稳定性、访问速度、账单管理」也算进去。

经验上：

  • 用量小、只用一个模型：套餐可能更省心。
  • 用量大、模型切换多、团队多人：自带 Key + 网关通常更可控。
  • 需要国内稳定访问：网关的价值往往大于单价差异。

具体价格以 模型价格 和 Cursor 官方套餐页为准。

六、常见问题与排错

现象 可能原因 处理
401 Key 错、过期、Base URL 错 重新复制 Key；确认 /v1
404 Base URL 路径重复 只填到 /v1，不要带 /chat/completions
模型不可用 模型名不对/未开通 从价格页复制模型名
请求超时 网络或代理 检查网络、切直连/代理
余额不足 未充值或额度用完 充值；检查 Key 额度
回复被截断 上下文/输出上限 减少上下文或调大输出上限

七、安全建议

  • 给 Cursor 单独建 Key，不要和线上服务共用。
  • 设置额度上限，避免 IDE 后台请求消耗过多。
  • 不要在共享电脑上长期保存 Key。
  • 离职/换机时删除旧 Key。
  • 团队用统一网关，按成员建 Key，方便审计。

八、适合哪些团队

  • 外包/外包团队：每个项目一个 Key，按项目核算成本。
  • 创业公司：统一入口，模型随时换，不被单一供应商锁定。
  • 企业研发：成员、额度、日志、账单集中管理。
  • 个人开发者：国内访问更稳，支付更方便。

下一步

先 注册中商起航 AI 网关，创建 cursor 专用 Key，按本文填入 Cursor。跑通后，再根据 模型价格 调整主力模型。

相关阅读：