Cursor 接入指南

适用角色：开发者更新日期：2026-07-15

Cursor 是一款 AI 原生 IDE，内置了 AI 对话、代码生成、Agent 模式等功能。通过配置 Override OpenAI Base URL，可以让 Cursor 的 AI 功能通过平台 API 调用模型。

前提条件

按 Cmd + ,（macOS）或 Ctrl + ,（Windows/Linux）打开 Cursor 设置，点击左侧 Models 选项卡。

在 Models 页的模型列表中，把你准备由平台替代的内置模型开关关掉（左侧开关置灰）。

如果不关闭，Cursor 可能仍然使用内置模型通道，导致请求没有走你配置的 Base URL，订阅额度也会继续消耗。

在 Models 页面中找到添加模型的入口，手动输入你要使用的模型名称。模型名称必须和平台「调用指南」页中的一致，例如：

在 Models 设置页面中找到以下两个字段：

字段	填什么	示例
OpenAI API Key	平台的 API Key	`sk-xxxxxxxx`
Override OpenAI Base URL	平台的 API 地址	`YOUR_API_BASE_URL/v1`

Base URL 末尾需要带 /v1。Cursor 会在此基础上自动拼接 /chat/completions。如果漏掉 /v1，会出现 404 错误。

点击 Verify 按钮测试连接。

注意：如果你填的模型名不是 OpenAI 官方名称（如 claude-sonnet-4-6），Verify 可能报警告，但这不影响实际使用。

变通做法：先临时添加一个 gpt-4 过 Verify（确认 Base URL 和 Key 联通），再添加你实际要用的模型名。

验证成功后，打开 Cursor 的 Chat 或 Composer 面板，选择你刚添加的模型，发一条测试消息确认能正常回复。

Cursor 的 Override OpenAI Base URL 只影响 Chat 和 Plan 面板。以下功能仍然走 Cursor 官方后端，无法通过第三方 API 接管：

如果你只是想在 Chat 中使用平台模型，这个限制不影响使用。

Cursor 发请求时用的是你在 Settings 中填入的 model 字段值。如果填错模型名，调用会报错。建议从平台控制台「调用指南」页复制准确的模型名称。

Q：免费版能用自定义 Base URL 吗？ A：不能。Override OpenAI Base URL 是 Cursor Pro 及以上订阅的功能。

Q：Verify 时报错怎么办？ A：常见原因：1) Base URL 末尾漏了 /v1；2) API Key 错误；3) 模型名不是 OpenAI 官方名（非 OpenAI 名的警告可以忽略，不影响实际使用）。

Q：配置后还是在扣 Cursor 的订阅额度？ A：检查是否把内置同名模型关掉了。如果内置的 Claude/GPT 模型开关还开着，Cursor 可能优先使用内置通道而不是你的自定义 Base URL。

Q：为什么 Tab 补全不走我的 API？ A：Tab 补全和 Inline Edit 这些功能锁定在 Cursor 官方后端，只有 Chat / Plan 面板支持自定义 Base URL。

Q：模型切换时报 "model not found" 怎么办？ A：确认模型名称和平台实际提供的一致。不同平台对同一模型的命名可能不同（如 claude-3-5-sonnet vs claude-3.5-sonnet）。从控制台复制调用名最稳妥。