Cursor 兼容性说明
Cursor 的自带 API Key（BYOK）和 OpenAI Base URL 覆盖能力需要有效的 Cursor Pro 订阅。即使是 Pro 用户，这些设置也只覆盖部分标准聊天请求，并不能把 Cursor 的全部 AI 功能切换到 LAYSO AI。
Cursor 对第三方 API 有明确限制
- 必须订阅 Cursor Pro：免费版无法使用本页的自定义 API Key 和 Base URL 配置；没有 Pro 订阅时请直接使用下方推荐方案。
- Tab 内联补全不会使用自定义 API：该功能继续使用 Cursor 内置模型。
- 自定义 API 主要用于标准聊天模型：推理、Agent、Composer 等能力可能受当前客户端实现限制。
- Cursor 自有模型不会通过 LAYSO AI 调用：选择 Auto、Composer 或 Cursor 管理的模型时，可能回到 Cursor 官方服务或直接报错。
- OpenAI Base URL 是全局覆盖：目前不能为每个自定义模型单独设置不同地址。
- 请求仍会经过 Cursor 后端：即使使用自己的 API Key，Cursor 仍会在其后端完成最终 Prompt 组装。
因此，不建议把 Cursor 的内置 AI 功能作为 LAYSO AI 的主要接入方式。
推荐：使用 VS Code 扩展接入
Cursor 兼容大多数 VS Code 扩展。建议保留 Cursor 的编辑体验，通过扩展接入 LAYSO AI，无需依赖 Cursor 自带的 BYOK 能力。
- 在 Cursor 中打开 Extensions 扩展面板。
- 选择并安装 Cline，或按 GitHub Copilot 教程安装 OAI Compatible Provider for Copilot。
- 按对应教程填写 LAYSO AI Base URL、API Key 和完整模型 ID。
- 重载 Cursor，在扩展的模型选择器中启用 LAYSO AI 模型。
| 扩展方式 | 适合场景 | 教程 |
|---|---|---|
| Cline | 在 Cursor 内使用可自定义 OpenAI 兼容服务的编码 Agent | Cline 配置教程 |
| GitHub Copilot | 在 Chat / Agent 中通过 OAI Compatible Provider 使用 LAYSO AI 模型 | GitHub Copilot 配置教程 |
其他替代方案
需要完整使用 LAYSO AI 模型、工具调用和编码代理能力时，建议选择已经提供独立配置教程的工具：
| 工具 | 推荐原因 | 教程 |
|---|---|---|
| Claude Code | Anthropic 原生兼容，适合终端编码与多文件任务 | 查看 Claude Code 教程 |
| Codex CLI | 使用 OpenAI Responses API，适合代理式编码 | 查看 Codex CLI 教程 |
| Gemini CLI | 适合 Gemini 模型与长上下文任务 | 查看 Gemini CLI 教程 |
| OpenCode | 开源终端编码工具，可配置自定义服务商 | 查看 OpenCode 教程 |
| Zed Editor | 编辑器内置模型服务配置，接入方式更清晰 | 查看 Zed 教程 |
继续使用 Cursor 编辑器
如果你喜欢 Cursor 的编辑体验，可以继续把它当作代码编辑器，同时在 Cursor 内置终端中运行已经配置好 LAYSO AI 的 Claude Code、Codex CLI 或 Gemini CLI。
打开内置终端：
- macOS：按住 Control，再按键盘左上角的反引号键。
- Windows / Linux：按住 Ctrl，再按键盘左上角的反引号键。
然后在项目目录中运行：
# Claude Code
claude "帮我分析当前项目，并给出下一步修改建议"
# Codex CLI
codex "修复当前测试失败的问题"
# Gemini CLI
gemini "总结这个代码库的结构"这些工具会直接读取 Cursor 当前打开的项目目录。你仍然可以在 Cursor 中查看和编辑文件，模型请求则由对应 CLI 按 LAYSO AI 教程中的配置处理。
Pro 用户测试 Cursor 自定义 API
以下步骤仅适用于已经订阅 Cursor Pro 的用户。如果没有有效的 Pro 订阅，自定义 API 配置入口或验证能力将不可用，请改用前面的推荐方案。
如果你是 Pro 用户并且只需要测试标准聊天模型，可以尝试 Cursor 的 OpenAI 兼容入口。此方法不代表 Tab、Auto、Composer、Background Agent 或其他 Cursor 专属能力也能使用 LAYSO AI。
第 1 步：准备 Key 和模型 ID
- 在 LAYSO AI API Key 页面 ↗ 创建 API Key。
- 在 模型与价格页面 ↗ 选择模型并复制完整模型 ID。
第 2 步：打开 Cursor Models 设置
进入 Cursor Settings → Models，找到 OpenAI API Key 和 Override OpenAI Base URL。如果没有这些入口，请先确认当前账号具有有效的 Cursor Pro 订阅；订阅有效但入口仍缺失时，再更新 Cursor 客户端。
第 3 步：填写 OpenAI 兼容配置
| 字段 | 填写内容 |
|---|---|
| OpenAI API Key | 从 LAYSO AI Key 页面复制的密钥 |
| Override OpenAI Base URL | https://api.layso.ai/v1 |
| Custom Model | 从模型与价格页面复制的完整模型 ID |
点击 Verify 验证 API Key，然后在 Custom Models 中手动添加模型 ID。不要选择 Cursor 自有模型、Auto 或 Composer 来测试自定义地址。
第 4 步：使用标准聊天模式验证
在聊天模型选择器中明确选择刚添加的自定义模型，先发送一条简短消息。若 Agent 模式出现工具格式、Responses API 或循环调用错误，请切换到标准 Chat / Ask 模式；这属于 Cursor 当前 BYOK 兼容性边界，不一定是 API Key 或 LAYSO AI 服务异常。
要恢复 Cursor 内置模型，请先关闭 Override OpenAI Base URL。该设置是全局覆盖，保持开启可能导致内置 OpenAI 兼容模型也被发送到自定义地址。
为什么功能不能完全替换
Tab 补全使用专用模型
Cursor 官方说明，自定义 API Key 只适用于标准聊天模型。Tab Completion 等需要专用模型的功能继续使用 Cursor 内置模型，不能通过修改 Base URL 切换到 LAYSO AI。
Agent 与工具调用依赖客户端实现
Cursor 不同版本可能为 Agent 请求使用不同的消息或工具调用格式。即使普通聊天能够连接，自定义模型也可能在工具调用、长任务或 Background Agent 中失败。因此页面只把这种配置定义为兼容性测试，不承诺完整 Agent 能力。
Auto 和 Cursor 自有模型不属于自定义 Provider
Auto 会从 Cursor 管理的模型中进行选择；Composer、Cursor Tab 等也是 Cursor 自有能力。它们不会因为填写了 LAYSO AI Base URL 就自动变成 LAYSO AI 请求。
Base URL 不是按模型隔离
Override OpenAI Base URL 会全局影响 OpenAI 兼容请求。当前不能为不同自定义模型分别保存独立地址和密钥，切换回 Cursor 内置模型时通常需要手动关闭覆盖设置。
请求不会绕过 Cursor 后端
Cursor 官方隐私说明指出，即使使用自己的 API Key，请求仍会经过 Cursor 后端完成最终 Prompt 组装。如果你的要求是让代码和 Prompt 只在本地工具与 LAYSO AI 之间传输，应选择 Claude Code、Codex CLI、Gemini CLI 或 OpenCode 等独立客户端。
常见问题
Verify 验证失败
- 确认当前登录账号具有有效的 Cursor Pro 订阅；免费版不能使用这套配置。
- 重新从 API Key 页面 复制密钥，确认没有空格或换行。
- Base URL 必须是
https://api.layso.ai/v1。 - 确认网络可以访问 LAYSO AI。
- 如果同一 Key 在其他 LAYSO AI 教程中可用，但 Cursor 仍验证失败，优先按客户端兼容性问题处理。
自定义模型提示不可用
确认选择的是手动添加的完整模型 ID，而不是 Cursor 内置模型。模型 ID 以 模型与价格页面 展示为准。
Tab 仍然产生 Cursor 账单
这是预期行为。Tab 不走自定义 API，会继续使用 Cursor 内置模型和 Cursor 自身的计费规则。
LAYSO AI 没有扣费明细
只有请求真正到达 LAYSO AI 且成功完成时才会产生扣费明细。Cursor 在发送前拒绝模型、切换回内置模型或任务失败时，不会产生 LAYSO AI 扣费。
计费与隐私边界
- 通过 LAYSO AI 成功完成的请求，按 当前模型价格 计费并生成独立扣费明细。
- 失败任务不会产生 LAYSO AI 扣费。
- Cursor 内置模型、Tab 和订阅费用属于 Cursor 自身计费，与 LAYSO AI 无关。
- 不要在截图、日志或项目文件中暴露完整 API Key。
- 使用 Cursor BYOK 不代表请求绕过 Cursor 后端；对代码隐私有严格要求时，请先阅读 Cursor 官方隐私说明。