算力猫
← 返回教程列表

接入软件

Cursor

在 Cursor 里换成我们的 OpenAI 兼容地址,并用别名添加模型。

约 6 分钟适合:用 Cursor 写代码的开发者

开始之前

  • 已安装 Cursor,并登录
  • 一把 Key,以及从模型广场复制的模型名
  • 先读下面的提醒:Cursor 自己的限制比较多

步骤 1 · STEP 0x01

打开 Cursor 设置里的模型页

Cursor Settings → Models → API Keys
1

OpenAI API Key

<你的 Key>
2

Override OpenAI Base URL

开
3

Base URL

https://api.suanlimao.shop/v1
4
Verify
示意图,以软件当前版本界面为准

Cursor Settings → Models,往下找到 API Keys 区域里的 OpenAI API Key:粘贴你的 Key,打开 Override OpenAI Base URL 开关,在出现的输入框里填接入地址,点 Verify。

接入地址写 https://api.suanlimao.shop/v1(带 /v1)。如果软件提示 404,先检查有没有多写或少写 /v1,再看下面的常见问题。
Cursor 的所有请求都先发到 Cursor 自己的服务器,再由它转发到接入地址,所以来源 IP 不是你的电脑。接入地址必须是公网能访问的,不要填 localhost 或内网地址;Key 上如果设了 IP 限制也要按这个来理解。

去创建 Key →

步骤 2 · STEP 0x02

用别名添加模型

Cursor Settings → Models
1

Add model

<模型名>
2
Add model
3

模型开关

开
示意图,以软件当前版本界面为准

设置了自定义地址后,Cursor 的默认模型列表不再适用,要手动添加你要用的模型名。模型名写成 <模型名>:在模型广场复制的模型名前面加上前缀 ,模型详情里有现成的「复制别名」按钮。

Cursor 不接受 claude-、gemini- 开头的自定义模型名(会报 ERROR_BAD_MODEL_NAME,或者把请求当成它自家模型而不带你的 Key)。带前缀的别名和原模型完全是同一个东西:同一个服务、同一个价格,用量页里按原模型名记。

打开模型广场 →

步骤 3 · STEP 0x03

在聊天里试一句

Cursor Chat
1

模型选择

<模型名>
2

输入框

你好
3
发送
示意图,以软件当前版本界面为准

选刚添加的模型,发一句话。正常回答,并且控制台「用量」页出现这次请求,就说明接通了。

不同版本表现不一致:有的版本只对聊天生效,Agent 模式、Tab 补全仍用 Cursor 自己的模型;也有版本打开开关后 Cursor 自带模型暂时不可用。以你手里的版本为准。

✓ 怎么确认成功了

  • 聊天里能用你添加的模型得到回答。
  • 控制台「用量」页能看到这次请求,模型名显示的是不带前缀的原模型名(说明请求确实走了我们的接口)。

常见问题

找不到 Override OpenAI Base URL?

它在 Models 页的 API Keys 区域、OpenAI API Key 下面,有的版本要先填 Key 才显示。实在没有,可以改用 Cline 或 Continue 这类 VS Code 插件,设置方式见对应教程。

提示 ERROR_BAD_MODEL_NAME?

你填的是不带前缀的原模型名。改成 <模型名> 再加一次。

提示连接失败 / 无法访问地址?

请求是从 Cursor 的服务器发出的,所以接入地址必须公网可达。不要填 localhost 或内网地址;公司网络里能打开的内网网关也不行。

提示模型不存在?

前缀后面的部分要和模型广场的模型名一模一样。重新复制,注意不要带多余的空格。

想让 Agent 模式也用我们的模型?

取决于你的 Cursor 版本和套餐,官方文档对此没有明确说明。能用就用;不能用,可以改用 Cline 或 Claude Code。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。