Cursor 里怎么选新模型：verride OpenAI Base URL 配置步骤
一句话版本：配置本身只有五步，难点在模型 ID。Cursor 按模型名和几个开关决定请求去哪，不按你点的下拉项。重名、claude- 开头、Override 是全局开关，是三个最常见的失败原因。
更新于 2026-11-03。灵眸团队撰写。下文的 Cursor 侧机制对任何 OpenAI 兼容中转服务都成立。Cursor 侧的行为我们没有实测，依据是 Cursor 官方文档和论坛里 Cursor 员工的公开回复（均标了日期和帖子），核验于 2026-11-03。Cursor 官方文档没有记载 Override OpenAI Base URL，员工在论坛称它是"officially supported setup"（帖 147219，2026-09-02）。
先判断：你要加的模型会走哪条路
| 你要用的模型 | 实际走向 | 依据 |
|---|---|---|
名字以 claude- 开头的自定义模型 | 用 Anthropic Key 槽位，不用 OpenAI Key 和 Override；只存了 OpenAI Key 会报 Model name is not valid | 员工，帖 173253，2026-09-28 |
与内置模型同名（如 kimi-k3） | Override 不生效，请求到不了你的地址；Add Model 可能提示 already available as ...；选内置版会 404，上游日志为空 | 员工，帖 175557，2026-10-23 |
不重名、不以 claude- 开头（如 deepseek-v4-pro） | OpenAI Key 加 Override，请求发往你的地址 | 由上面两条推出 |
| 内置的 GPT 等非 Claude、非 Gemini 模型，Override 开着时 | 也被送往你的地址 | 员工，帖 169088，2026-08-21 |
| Composer、Grok，OpenAI Key 开着时 | 被拒，This model does not support custom API keys | 员工，帖 172795，2026-09-23 |
| Tab 补全 | 不走自带 Key | Cursor 官方文档 |
"This isn't something wrong with your setup. This is expected behavior in the current implementation."
— Cursor 员工 deanrie，Cursor 论坛，2026-08-21（回应"开启 Override 后内置 GPT 也被送往自定义地址"）
灵眸的模型 ID 对照
对照灵眸模型广场与 Cursor 模型与价格页的模型名。Cursor 内置模型的内部 ID 看不到，"同名"按显示名推断，论坛里 claude-sonnet-5-5、kimi-k3、gpt-5.6-luna 都是这样一一对应的。最终以 Add Model 时 Cursor 的提示为准。
| 灵眸模型 ID | 与 Cursor 目录 | 建议 |
|---|---|---|
kimi-k3、kimi-k2.7-code | 同名，员工已确认不生效 | 避免 |
claude-opus-5、claude-sonnet-5、claude-fable-5-1、claude-haiku-4-5 | 同名项较多，且以 claude- 开头 | 不适合这条路，见下文替代方案 |
gpt-5.6-sol、gpt-5.6-luna、gpt-5.6-terra、gpt-5.5、glm-5.2、glm-5.3 | 同名；是否拒绝添加未见报告 | 先试，再用后台用量验证 |
qwen3.8-max、deepseek-v4-pro、MiniMax-M3、mimo-v2.5-pro | 目录里未见同名项 | 优先选用 |
灵眸的 Cursor 接入页示例用了 claude-opus-5、kimi-k3 等 ID，与员工回复有出入，以你自己的实测为准。
重名时想用内置那一份，员工的办法是关掉 OpenAI Key 开关，此时用的是 Cursor 套餐额度，不是你自己的 Key。
配置五步
- 确认前提。 套餐是 Premium 及以上（Plus 不含自带 Key）；团队账号要确认管理员没有限制个人 Key，且单独放开了 OpenAI 一项。在灵眸后台创建
sk-密钥，并在「可用模型」页确认目标模型在你的分组里。 - 填 Key 和地址。 打开 Cursor Settings > Models（灵眸文档给的快捷键：Windows、Linux 用
Ctrl + Shift + J，macOS 用Cmd + Shift + J）。在 OpenAI API Key 区域粘贴sk-密钥，打开 Use OpenAI API Key 和 Override OpenAI Base URL，地址填https://api.lmuai.com/v1。必须带/v1，Cursor 自动拼接/chat/completions，漏掉会 404。 - Add Model。 填按上表挑好的模型 ID，每个模型单独添加一次，不会自动出现。
- 重启 Cursor，新开对话，再选模型。 这是员工多次给出的建议。
先用 curl 确认灵眸侧通。 返回内容说明密钥、地址、模型都正常，之后的故障在 Cursor 侧（命令本文未实测，端点见接入协议）。
curl https://api.lmuai.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"你要添加的模型ID","messages":[{"role":"user","content":"ping"}]}'
灵眸文档提到"先加 gpt-4 过 Verify"。Cursor 官方资料没有 Verify 的说明，这一条以你的界面为准。判断配置对不对，只看一件事：发一条消息，灵眸后台用量里有没有这条请求。 有，说明请求到了网关；没有，说明它走了别的路。
来回切换内置模型和自己的模型
Override 没有分流，也不能按模型或提供商配置不同的地址（员工，帖 147219，2026-11-01）。三种做法：
- 用 Cursor 托管的 GPT、Composer、Grok、内置 Kimi：关掉 OpenAI Key 开关。
- 来回切：命令面板里的
Toggle OpenAI key，员工给的快捷键是Ctrl + Shift + 0（macOSCmd + Shift + 0）。它同时开关 OpenAI Key 和 Override，保留已存的 Key 和地址，切换后新开对话。 - 要 Claude：Claude 和 Gemini 不受 OpenAI Key 影响，只用各自的 Anthropic、Google Key。想走灵眸，可在 Cursor 里装 Claude Code 插件（Anthropic 协议）或 Codex 插件（OpenAI 协议），它们的配置独立于 Models 页。灵眸文档称 Composer、Apply、Inline Edit 也锁在 Cursor 后端，Cursor 官方文档只明确了 Tab。
出错了对号入座
| 现象 | 常见原因 | 处理 |
|---|---|---|
Add Model 提示 already available as "Xxx" | ID 与内置名重名 | 换 ID，或关 OpenAI Key 用内置版 |
Provider Error、404，灵眸后台没有记录 | 选中了 Cursor 托管的同名内置模型 | 同上 |
| 404，灵眸后台有记录 | Base URL 漏了 /v1 | 改为 https://api.lmuai.com/v1 |
Model name is not valid | claude- 开头走了 Anthropic Key 槽位；或团队没放开 OpenAI 个人 Key | 换不以 claude- 开头的名字；问管理员 |
This model does not support custom API keys | 选了 Composer、Grok，OpenAI Key 是开着的 | 关 OpenAI Key |
| 找不到 API Keys 区域 | 管理员开启了 Restrict Personal API Keys | 联系团队管理员 |
灵眸侧 401 等错误码含义见错误码速查。
Cursor 官方文档里的前提、费用和数据
来源：Bring your own API key、Models & Pricing。
- 支持的提供商是 OpenAI、Anthropic、Google、Azure OpenAI、AWS Bedrock；自带 Key 只对聊天模型生效，Tab 补全仍用内置模型。
- 个人档由提供商直接计费，不占套餐额度。Teams、Enterprise 对部分第三方模型另收每百万 token 0.25 美元的 Cursor Token Rate，自带 Key 也算，这笔由 Cursor 收取，团队版里还会占成员月度上限（员工，帖 173253）。
- 自带 Key 时 Cursor 的零数据留存策略不适用，Key 随每次请求发到 Cursor 后端。灵眸侧的数据处理见数据与隐私。
常见问题
Cursor 新模型怎么添加？
自定义模型不会自动出现在下拉里，要在 Models 页手动 Add Model。 先在灵眸「可用模型」页确认 ID，再检查是否与 Cursor 内置名重名，改完设置后重启并新开对话。
Cursor 提示 already available 怎么办？
说明 ID 与内置模型重名。 换一个不重名的 ID，或关闭 OpenAI Key 开关改用内置版，后者消耗的是 Cursor 套餐额度，不是你自己的 Key。
开了 Override 内置模型会受影响吗？
会。 Override 对所有非 Claude、非 Gemini 的模型生效，内置 GPT 会被送往你的地址，Composer 和 Grok 会报错。用内置模型前先关掉，或用 Toggle OpenAI key 命令切换。
Cursor 自定义模型为什么报 404？
常见原因有三个： Base URL 漏了 /v1；选中的是同名内置模型，请求没到网关；密钥或模型 ID 写错。到灵眸后台看有没有这条请求，能快速判断是哪一种。
Tab 补全能用自己的 Key 吗？
不能。 Cursor 官方文档写明，自带 Key 只对聊天模型生效，Tab 补全仍使用 Cursor 内置模型。
用自己的 Key 会扣 Cursor 额度吗？
个人档不会，提供商直接向你计费。Teams 和 Enterprise 对部分第三方模型另收每百万 token 0.25 美元的 Cursor Token Rate，自带 Key 也算。
哪些没有实测
Cursor 侧的全部行为（路由、重名、claude- 前缀、全局开关、Toggle OpenAI key）和模型重名对照都未实测，curl 命令也未实测。Cursor 的界面和路由逻辑会随版本变化，越早的论坛回复越可能过时。你照着配置五步跑一遍，再看后台用量，比看这篇文章可靠。
来源：Cursor 官方文档、Cursor 论坛员工回复（见正文各处链接和日期）、灵眸文档 docs.lmuai.com，核验于 2026-11-03。
