Cursor 接入第三方 API 配置

Cursor 支持通过 Override OpenAI Base URL 把 Chat / Plan 面板的请求指向第三方中转 API。本页说明如何用这一原生方式接入灵眸。

---

配置步骤

第 1 步：打开 Cursor Settings

按 Cmd + Shift + J（macOS）或 Ctrl + Shift + J（Windows / Linux）打开 Settings，左侧栏点 Models。

第 2 步：关闭默认模型（推荐）

Cursor 内置了很多默认模型（GPT-4 / Claude-3.5 等），保留启用会与自定义路由冲突。在 Models 页的模型列表里把它们全部关掉（左侧开关置灰）。

第 3 步：添加自定义模型

点 Add Model，输入你要用的灵眸模型 ID，例如：

• claude-opus-4-8
• claude-sonnet-5
• claude-sonnet-4-6
• gpt-5.5
• gpt-5.4
• glm-5.1
• qwen3.7-max
• deepseek-v4-pro

每个模型都要 Add 一次。完整可用模型见 模型广场。

第 4 步：开启 Override OpenAI Base URL

滚到 Models 页的 OpenAI API Key 区域：

1. 打开 OpenAI API Key 开关
2. 在 API Key 输入框粘贴灵眸后台的密钥（sk- 开头）
3. 打开 Override OpenAI Base URL 开关
4. Base URL 填：

   https://api.lmuai.com/v1

5. 点击 Verify 校验连接

第 5 步：切换模型使用

按 Cmd/Ctrl + L 打开 Chat 面板 → 顶部模型下拉里选择第 3 步添加的自定义模型 → 开始对话，请求即会走灵眸。

---

常用模型 ID

完整清单见 模型广场。

---

常见问题

想让 Composer / Tab 自动补全也走灵眸？

原生 Override OpenAI Base URL 做不到，这些 Cursor 核心功能锁在官方后端。想全部走灵眸，请用：

• Codex 官方插件 —— OpenAI 协议 Agent
• Claude Code for VS Code 插件 —— Anthropic 协议 Agent

Cursor 兼容 VS Code 插件市场，两个插件都可以直接在 Cursor 里安装。

Base URL 要不要带 /v1？

要带。填 https://api.lmuai.com/v1。Cursor 会自动拼 /chat/completions，最终请求 https://api.lmuai.com/v1/chat/completions。漏 /v1 会 404。

开启 Override 后内置 Claude 3.5 突然报错？

这是 Cursor 已知的路由冲突 —— 开启 OpenAI Base URL 覆盖会打断 Anthropic 分支。想在 Chat 面板继续用 Claude，把 Claude 模型 ID（claude-opus-4-8 等）作为自定义模型添加即可，灵眸后端会做 OpenAI ↔ Anthropic 协议转换。

报错 401 / 403？

依次检查：

1. API Key 是不是灵眸后台生成的 sk- 开头密钥（不是 OpenAI 官方 Key）
2. Base URL 是不是 https://api.lmuai.com/v1（必须带 /v1）
3. 模型 ID 是不是灵眸支持的模型（见 模型广场）
4. 当前套餐 / 计费分组是否包含所调用的模型

用 BYOK 会不会影响 Cursor 订阅？

• BYOK 走的量不消耗 Cursor 的月度快速请求配额
• Composer / Tab 自动补全等核心功能仍消耗 Cursor 订阅配额（因为它们没走 BYOK）
• 想彻底不用 Cursor 订阅，见上文改装 Codex / Claude Code 插件的方案