先看结论：Cursor 的 Settings → Models 里只有 OpenAI 那一栏带 "Override OpenAI Base URL" 开关，Anthropic 栏没有。这意味着想在 Cursor 里接第三方渠道跑 Claude，唯一走得通的路径是 OpenAI 兼容协议 /v1/chat/completions，不能在 Anthropic 栏直接填第三方 Key。本文给出完整配置流程、端点验证方法，以及四个官方论坛可查证的机制限制。
一、核心机制：Cursor 的 Anthropic 栏没有 Base URL 覆盖选项
这是整个 Cursor 第三方 API 配置流程里最容易卡住的地方。
在 Cursor 的 Settings → Models 下能看到 OpenAI、Anthropic、Google 等多家的 API Key 输入框，表面看每家都能配自定义模型端点。实测下来存在一个不对称：
| 厂商栏 | 能填 Key | 有 Base URL 覆盖选项 |
|---|---|---|
| OpenAI | ✅ | ✅ "Override OpenAI Base URL" |
| Anthropic | ✅ | ❌ 无 |
结果是：在 Anthropic 栏填入第三方 Key，请求依然会发往官方 api.anthropic.com，不会被重定向到你指定的端点。
这不是配置遗漏，是 Cursor 当前真实缺失的功能。官方论坛有专门的功能请求帖（Request to override Anthropic Base URL），团队回复是该需求已在排期但不在近期路线图前列。另一个帖子（Missing anthropic base url override）里也有 Cursor 团队成员确认了同样的说法。
结论：想在 Cursor 里接第三方 Claude/GPT/国产模型，都只能走 OpenAI 兼容协议这一条路，前提是目标平台确实提供 /v1/chat/completions 端点。
二、Cursor 自定义模型配置流程
2.1 Cursor 里的基本配置步骤
- 打开 Cursor 的
Settings → Models，快捷键Ctrl/Cmd + Shift + J - 找到 OpenAI 那一栏，打开 "OpenAI API Key" 开关
- 打开 "Override OpenAI Base URL"，填入第三方端点地址
- 粘贴 API Key，点 "Verify" 确认连通性
- 在 Cursor 的模型列表里手动添加要用的自定义模型 ID
Base URL 采用标准 OpenAI SDK 写法，域名后要加 /v1：
https://api.lmuai.ai/v1
不加 /v1 通常会返回 404，这是 Cursor 配置阶段最常见的低级错误。
2.2 填进 Cursor 前先验证端点是否真实可用
填进 Cursor 之前，建议先确认目标端点是不是真的 OpenAI 兼容。方法是故意用一个错误的 Key 发请求，看返回格式：
curl https://api.lmuai.ai/v1/chat/completions \
-H "Authorization: Bearer sk-invalid-key-for-test" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"messages": [{"role": "user", "content": "hi"}]
}'
判断标准：
- 返回标准 JSON 格式的鉴权错误（如
INVALID_API_KEY）→ 端点真实存在，可以填进 Cursor - 返回网站首页的 HTML 兜底页面 → 这个路径根本没实现 OpenAI 兼容接口，配置了也用不了
这一步只要一条 curl，能省掉后面在 Cursor 里"Verify 通过但实际用不了"的排查时间。
2.3 Cursor 自定义模型 ID 必须精确
配置流程第 5 步有个容易踩的坑：Cursor 添加自定义模型时要填完整精确的模型 ID，不能随便起名。
填错模型名时 Verify 仍可能通过——因为 Cursor 的验证只检查 Key 和端点连通性，不校验模型是否存在。等到实际发请求才会报模型不存在。稳妥做法是从平台后台的模型列表页复制完整 ID，不要凭记忆手打。
三、Cursor 的四个机制限制（工具自身行为，与接入平台无关）
3.1 Cursor 的 Override 是全局生效，不是按模型生效
打开 "Override OpenAI Base URL" 后，Cursor 里所有 OpenAI 系模型的请求都会走这个端点，不只是新添加的自定义模型。
论坛上有不少相关反馈（The custom override of the OpenAI base URL is unusable）。如果还想用 Cursor 自带的 GPT 系模型，需要手动关掉这个开关，两者不能同时保留。
3.2 Cursor 的 Tab 补全和 Apply 不受 Override 配置影响
这两个功能始终使用 Cursor 自己的模型，配置的 Override 只影响 Chat 和 Agent 模式的对话与执行。
3.3 在 Cursor 里换厂商组需要连 Key 一起换
习惯 Claude Code 的开发者在 Cursor 里容易在这一步有预期偏差：
| 工具 | 换模型方式 |
|---|---|
| Claude Code | /model 一行命令，账号和 Key 都不用动 |
| Cursor | Override 是"一个 Base URL + 一个 Key"的全局配置，换厂商组要改 Key |
原因是不少聚合平台的账户架构是一个 Key 只能接入某一组模型（比如全部国产模型，或某一家海外厂商），不支持跨厂商混用同一个 Key。所以从 Claude 切到国产模型时，要在 Cursor 设置里替换 Key，不是换个模型名就行。工作流需要频繁切换的话，提前知道这点能省不少排查时间。
3.4 Cursor Agent 模式的工具调用建议单独验证
Cursor 的 Agent 需要模型支持稳定的 function calling 才能真正改文件、执行命令。不同第三方端点在"Anthropic 协议转 OpenAI 协议"这一层的实现质量存在差异，部分转换层会丢失原生工具调用能力，表现为 Agent 只在对话里描述要做什么，但文件实际没有被修改。
接入后建议用一个简单任务实测（比如让它改一行代码），确认文件真的发生变更，不要只看聊天窗口的文字回复。
四、给 Cursor 选择接入平台时的一个技术判断维度
跟 Cursor 的 3.4 直接相关的一点是：协议是否为官方转发。
如果接入的是反代其他客户端内部通道的逆向接口，很容易在协议转换层丢失字段，直接影响 Agent 模式的工具调用稳定性。判断方法就是 2.2 那条 curl——能返回标准 JSON 结构化错误的，通常是真实实现了协议；返回 HTML 兜底页的，基本可以排除。
以笔者实际在用的灵眸AI 海外站（2026年9月查证）为样本，它同时提供 Anthropic 官方协议 /v1/messages 和 OpenAI 兼容的 /v1/chat/completions 两条端点，后者正是 Cursor Override 需要的那条。这不是说第三方渠道一定是更优选择——协议是否透明转发、Agent 模式的工具调用是否完整，都需要按本文 2.2 和 3.4 的方法自己核对一遍，是想说清楚"端点是否真实可用"这一项该怎么验证，落到一个真实平台上大概是什么样子。
五、常见问题
Cursor 的 Anthropic 栏填了 Key 为什么连不上第三方端点？
因为 Cursor 的 Anthropic 栏没有 Base URL 覆盖选项，填进去的 Key 只会用于访问官方 api.anthropic.com。想在 Cursor 里走第三方渠道，必须用 OpenAI 栏的 Override 配置，走 /v1/chat/completions 兼容协议。
Cursor 里 Verify 通过了，但实际使用报模型不存在？
Cursor 的 Verify 只校验 Key 和端点连通性，不校验自定义模型 ID 是否有效。检查模型 ID 拼写是否与平台后台列表完全一致。
开了 Override 之后，Cursor 自带的 GPT 用不了了？
正常现象。Cursor 的 Override 配置是全局生效的，所有 OpenAI 系请求都会走自定义端点。想用回 Cursor 自带模型需要手动关闭这个开关。
Cursor Agent 模式原本能改文件，换成第三方端点后不改了？
大概率是协议转换层丢失了 function calling 能力。用一个简单任务测试确认，如果文件确实没被修改，说明该端点的工具调用支持不完整。
Cursor 里 Base URL 填了为什么报 404？
检查是否漏了 /v1 后缀。Cursor 要求填的是 OpenAI SDK 标准格式的 base 地址，不是 /v1/chat/completions 完整路径，也不能只填域名。
本文技术细节参考 Cursor 官方论坛公开讨论帖，数据核实时间 2026 年 9 月。Cursor 产品行为随版本更新可能变化，接入前建议在自己的版本中实测验证。
