Cursor 是很多开发者日常写代码时会打开的 AI IDE。它本身可以使用官方模型服务，也可以在部分配置里接入自定义 OpenAI 兼容 API。对国内用户、小团队或需要多模型切换的人来说，把 Cursor 接到第三方 API，往往比每个模型平台单独折腾一遍更省事。

这篇文章会按新手能跟着操作的方式，讲清楚 Cursor 接入第三方 API 时要填哪些东西、为什么要这样填，以及出错时怎么判断是 Key、Base URL 还是模型名的问题。

本文以 147AI 的 API接口文档 的接入逻辑为例：先在控制台创建令牌，再从模型广场复制模型名，最后在 Cursor 里填写 API Key、Base URL 和模型。

---

开始前准备

在打开 Cursor 配置前，先准备好这几项：

• Cursor 已安装并能正常启动
• 第三方 API 账户余额大于 0
• 已在「密钥管理」创建 API Key
• 已在模型广场选好一个 OpenAI 兼容模型
• 网络能访问 https://147ai.com

如果你还没有 Key，先看系列第一篇 第三方 API 从 0 到 1：账号、令牌与调用原理 。Cursor 这里不会替你创建 Key，它只负责使用你已经准备好的 API 配置。

---

Cursor 里要填哪三项

不同版本 Cursor 的设置入口可能略有变化，但核心字段基本就是三个：

Cursor 里的常见字段	应该填什么	从哪里拿
API Key	sk-... 格式的令牌	控制台「密钥管理」
Base URL / Override OpenAI Base URL	常见为 https://147ai.com/v1	模型详情页 API 端点
Model / 模型	模型广场里的完整模型名	模型广场复制

记住一个原则：不要手写模型名，不要猜 Base URL，不要把 Key 贴进模型输入框。

---

第一步：创建并复制 API Key

进入第三方 API 平台控制台，在「密钥管理」里添加令牌。以 147API 文档为例，创建令牌时需要选择模型对应分组，并设置额度或有效期。

复制 Key 后，建议先临时放在本地安全位置，等 Cursor 配置完成后再删除明文记录。不要把 Key 存到公开笔记、聊天记录或代码仓库里。

---

第二步：复制模型名

打开模型广场，选择你准备在 Cursor 中使用的模型。点进模型详情页后，复制完整模型名。

这里不要用“看起来差不多”的名称。比如模型展示名、模型分组名、模型 ID 可能不是一回事。Cursor 最后发请求时，用的是你填入的 model 字段，模型名不匹配就会报错。
新手建议先选一个轻量模型测试。如果一开始就选高成本模型，配置没跑通时不仅难排查，也可能产生不必要消耗。

---

第三步：填写 Base URL

进入 Cursor 设置页，找到 OpenAI 或模型提供商相关配置。常见字段叫：

• Override OpenAI Base URL
• OpenAI Base URL
• API Base
• Custom API URL

常见填写方式是：

https://147ai.com/v1

在 Cursor 的 Base URL / Override OpenAI Base URL 中优先填写 https://147ai.com/v1 。不要在 Cursor 的 Base URL 输入框里填写 /v1/chat/completions 这种完整接口路径，除非某个客户端明确要求完整 endpoint。

---

第四步：填写 API Key 和模型

在 Cursor 设置页中：

1. 把 sk-... 粘贴到 API Key 输入框。
2. 把 Base URL 填到自定义 API 地址输入框。
3. 把模型广场复制的模型名填入模型配置。
4. 保存设置。
5. 关闭并重启 Cursor，避免旧配置缓存影响测试。

如果 Cursor 有“测试连接”按钮，可以先点击测试；没有的话，就进入 Chat 里发一句短问题。

---

第五步：做最小验证

如果 Cursor 当前版本提供 Verify/测试按钮，先点击测试；如果没有，就用短问题测试返回，并到 147API 控制台查看调用记录、余额变化或日志确认。

---

推荐的使用习惯

先让 Cursor 只读项目

刚接好第三方 API 后，先不要让它直接改文件。可以让它：

• 解释项目目录
• 阅读某个文件并总结
• 给出修改计划
• 列出可能影响的文件

确认模型输出稳定后，再让它动手改代码。

小步使用，方便判断效果

一次只让 Cursor 做一件事，比如：

只修复这个函数里的空值判断，不要改其他文件。

这样你更容易看出第三方 API 的模型是否适合代码任务，也方便比较不同模型的效果。

保留 Git 检查点

Cursor 会改文件，所以执行真实任务前建议先运行：

git status

如果当前工作区已经有很多未提交改动，先确认哪些是你自己的改动，避免 AI 修改和人工修改混在一起。

---

常见问题与排查

Q1：401 或 403

这类问题通常和认证有关。检查：

1. API Key 是否复制完整。
2. Key 是否仍然有效。
3. 令牌分组是否支持当前模型。
4. 账户余额是否大于 0。
5. Cursor 是否真的使用了自定义 Key，而不是旧的官方 Key。

Q2：404 或接口不存在

重点检查 Base URL：

• 尝试 https://147ai.com/v1
• 如果仍失败，看模型详情页是否要求完整路径
• 不要在 Base URL 输入框里重复填写 /v1/chat/completions

不同客户端会自动拼接路径，重复填写路径就可能变成错误地址。

Q3：模型不可用或 model not found

去模型广场重新复制模型名，并确认令牌分组支持该模型。不要只复制文章里的示例名。

Q4：Chat 能走第三方 API，但某些 Cursor 功能仍像是内置模型

检查设置里是否启用了自定义 Base URL。有些版本需要打开开关，或者在特定 Provider 下配置。保存后重启 Cursor 再测。
如果 Chat 已经能通过第三方 API 返回，但某些补全、后台智能功能仍像是走 Cursor 内置模型，这不一定是配置错误。Cursor 的自定义 API Key 通常只覆盖部分标准聊天模型能力，Tab Completion 等专用功能可能仍由 Cursor 自身服务提供。

Q5：回答很慢或经常超时

可能原因有：

• 模型本身较慢
• 当前分组资源繁忙
• 网络代理不稳定
• 上下文太长

先用短问题和轻量模型测试。如果短问题都慢，再考虑换分组或检查网络。

---

总结

Cursor 接入第三方 API，本质上还是三件事：Base URL 发到正确网关，API Key 用来鉴权，模型名指定真正调用的模型。

第一次配置时，不要急着跑复杂代码任务。先用短问题验证连通性，再让 Cursor 只读项目，最后再进入真实修改。这样出问题时，你能更快判断是配置问题、模型问题，还是项目任务本身太复杂。