Cursor 接入指南
适用角色：开发者、主用户、子用户 更新日期：2026-08-06
Cursor 对自定义 Base URL 的支持会随版本和账户能力变化。配置前先打开模型设置，确认当前界面同时提供 API Key 和 Base URL 输入项。
以控制台「API Key」页展示的接口地址为准。
当前版本提供 Base URL 时
- 打开 Cursor Settings，进入 Models；
- 找到 OpenAI API Key 配置；
- 展开 Override OpenAI Base URL；
- API Key 填本平台 Key；
- Base URL 填
https://<接口地址>； - 添加控制台「调用指南」中的模型调用名；
- 保存后在 Chat 面板选择该模型。
如果 Verify 没有通过，但 Chat 能正常返回且控制台出现使用记录，以实际请求结果为准。某些 Cursor 版本的 Verify 只识别内置模型，不代表自定义模型一定不可用。
当前版本没有 Base URL 时
不要把本平台 Key 填进只能连接官方服务的 Key 输入框。可以在 Cursor 中安装支持 OpenAI Compatible 的 Cline、Roo Code 或 Continue，再按对应教程配置。
接入后还要检查什么
Cursor 的聊天、自定义模型和 Tab 补全可能走不同服务。完成配置后应分别确认实际需要的功能；Chat 使用本平台，并不表示所有内置功能都会使用同一个 Base URL。
请求返回 404 时，重点查看 Cursor 最终请求地址是否出现重复 /v1。模型找不到时，从调用指南重新复制模型名，不要使用模型展示名称代替调用名。