接入软件
Cursor
在 Cursor 里换成我们的 OpenAI 兼容地址,并用别名添加模型。
约 6 分钟适合:用 Cursor 写代码的开发者
开始之前
- 已安装 Cursor,并登录
- 一把 Key,以及从模型广场复制的模型名
- 先读下面的提醒:Cursor 自己的限制比较多
步骤 1 · STEP 0x01
打开 Cursor 设置里的模型页
OpenAI API Key
Override OpenAI Base URL
Base URL
Cursor Settings → Models,往下找到 API Keys 区域里的 OpenAI API Key:粘贴你的 Key,打开 Override OpenAI Base URL 开关,在出现的输入框里填接入地址,点 Verify。
https://api.suanlimao.shop/v1(带 /v1)。如果软件提示 404,先检查有没有多写或少写 /v1,再看下面的常见问题。步骤 2 · STEP 0x02
用别名添加模型
Add model
模型开关
设置了自定义地址后,Cursor 的默认模型列表不再适用,要手动添加你要用的模型名。模型名写成 <模型名>:在模型广场复制的模型名前面加上前缀 ,模型详情里有现成的「复制别名」按钮。
claude-、gemini- 开头的自定义模型名(会报 ERROR_BAD_MODEL_NAME,或者把请求当成它自家模型而不带你的 Key)。带前缀的别名和原模型完全是同一个东西:同一个服务、同一个价格,用量页里按原模型名记。步骤 3 · STEP 0x03
在聊天里试一句
模型选择
输入框
选刚添加的模型,发一句话。正常回答,并且控制台「用量」页出现这次请求,就说明接通了。
✓ 怎么确认成功了
- 聊天里能用你添加的模型得到回答。
- 控制台「用量」页能看到这次请求,模型名显示的是不带前缀的原模型名(说明请求确实走了我们的接口)。
常见问题
找不到 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)。