为什么要给 Cursor 换中转站 key
Cursor 自家订阅有几条上限:
- Pro 月费固定(约 $20),里面的 “fast premium request” 是月配额(500 次),超出就降速或停服
- 切换 Claude Opus 4.5 / GPT-5 这种高价模型,月配额烧得更快
- 偶尔出现的限速 / 排队 / 区域不可用
换上中转站 key 之后:
- 按 token 计费:用多少花多少,不再吃月配额
- 多模型一键切换:Claude Sonnet 4.5、GPT-5、Gemini 2.5 都在同一个 key 后面
- 部分中转站提供 30-70% 折扣,长尾用户单月成本能压到 ¥10 以内
代价:你接管了余额管理(断网就没法干活)。
第一步:挑一家”全模型聚合”型中转站
Cursor 走 OpenAI 兼容协议,所以你要找的中转站必须支持 openai-sdk 客户端。打开 中转站列表 筛选 openai-sdk 标签,重点看这些:
- Crazyrouter:300+ 模型,OpenAI 兼容路径明确
- DMXAPI:200+ 企业模型聚合,单 key 跨 Claude / GPT / Gemini
- SiliconFlow 硅基流动:模型聚合 + OneAPI 协议
注册后在控制台拿到:
- OpenAI 兼容 base URL(一般是
https://xxx.cn/v1或https://xxx.com/api/v1) - API Key(
sk-开头)
一定要拿 “OpenAI 兼容” 的 URL,不是 Anthropic 兼容那个。Cursor 永远把请求发到 OpenAI 协议端点,再由中转站翻译到 Anthropic / Gemini 内部。
第二步:Cursor 里配 OpenAI Base URL
在 Cursor 里:
Cmd/Ctrl + ,打开 Settings- 进 Models 标签
- 找到 OpenAI API Key 区域
- 展开 Custom OpenAI API Endpoint(或类似措辞,版本不同位置略变)
填入:
| 字段 | 值 |
|---|---|
| API Key | 中转站给的 sk-xxx |
| Base URL | 中转站的 OpenAI 兼容地址,结尾通常带 /v1 |
例如
https://api.crazyrouter.com/v1、https://www.dmxapi.cn/v1。如果中转站文档里写的是/v1/chat/completions,那 Base URL 就填到/v1截止。
- 点击 Verify 按钮。出现绿色对勾代表握手成功。
第三步:把模型列表也覆盖掉
Cursor 默认的模型列表是 OpenAI 官方那批(gpt-4o、o1 等)。如果你想用 claude-sonnet-4-5 或 gemini-2.5,需要:
- 在 Models 设置里找 Model Configuration 或 Custom Models
- 添加中转站文档里给的模型 ID。常见命名:
| 你想用的 | 中转站常见模型 ID |
|---|---|
| Claude Sonnet 4.5 | claude-sonnet-4-5、claude-3-5-sonnet-20241022(看具体家) |
| Claude Opus 4.5 | claude-opus-4-5 |
| GPT-5 | gpt-5、gpt-5-chat |
| Gemini 2.5 Pro | gemini-2.5-pro、gemini-pro |
- 添加完后在 Chat 顶部下拉里就能选到这些模型。
第四步:试用
在 Cursor 里:
# 用 ⌘+L 或 ⌘+K 启动 chat / inline
> 这个文件做了什么?
正常会得到回复。检查:
- 切换模型下拉看到了你加的项
- 跑一次 inline 改代码确认延迟可接受
- 进中转站控制台看一下”调用记录”,新请求应该出现
常见错误
| 错误 | 大概率原因 | 解决 |
|---|---|---|
Verify 失败 / Unknown | Base URL 末尾少了 /v1 或多了 /chat/completions | 改成 .../v1 截止 |
401 Unauthorized | key 复制不全 / 复制时带了空格 | 控制台重新生成 key |
403 Forbidden | 中转站要求绑域名 / 实名 | 看对方控制台是否有”白名单”配置 |
model_not_found | 模型 ID 跟中转站不匹配 | 用中转站文档列出的精确 ID |
| 流式响应卡 | Cursor + 远程中转站长链路 | 关 Cursor 里的 verbose、降并发 |
| 突然全部 429 | 中转站当时限速 | 换备用中转站、临时降频 |
OneAPI / NewAPI 兼容
如果你挑的中转站是基于 OneAPI / NewAPI 协议(很多家是):
- Base URL 通常是
https://xxx.cn或https://xxx.cn/v1 - 同一个 key 跨所有它代理的模型生效(不分 OpenAI / Claude key)
- 控制台里能看到”令牌”和”渠道”两级结构 — 你只要管令牌就行
下一步
- 把同一个 key 也给 Claude Code、Codex CLI、Cline 用 — 一份 key 多客户端共享
- 在中转站充值上限设小(比如 ¥50),观察一个月真实开销
接好之后 Cursor 就解除了 fast request 配额束缚,可以放心切高端模型。