Cursor 部署

本文介绍如何配置 Cursor IDE 并接入 KvioAI 中转站。

重要说明： Cursor 的自定义 API 功能仅支持 AI Chat / Plan 模式（Ctrl + L 快捷键打开的聊天面板）。Cursor 的 Composer（Ctrl + I）、Inline Edit（Ctrl + K）、代码补全（Tab）以及 Coding Agent 功能无法通过自定义 API 路由，这些功能被硬编码为只能使用 Cursor 官方后端。

如果你需要完整的 AI 编程代理体验，建议使用 Claude Code 部署 或 CodeX 部署。

前置条件： 系统已安装 Cursor IDE。

第一步：打开 Cursor 设置

启动 Cursor 后，按以下步骤打开设置面板：

• 快捷键： Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）
• 菜单路径： 点击右上角齿轮图标 → Cursor Settings

第二步：配置 API Key 和 Base URL

在 Cursor Settings 面板中，切换到 Models 选项卡：

1. 找到 OpenAI API Key 输入框，填入你的 KvioAI API Key

   • 从 KvioAI 控制台获取的 Key 是 JSON 数组格式，只需提取 key 字段的值（即 sk-xxxxx）
   • 不要带入外层的 JSON 引号或方括号

2. 启用 Override OpenAI Base URL 选项，填入：

https://kvioai.cloud/v1

第三步：选择模型

在 Cursor 的 Chat 面板中，点击顶部的模型名称，选择你想要使用的模型。KvioAI 支持多种模型，常见的包括：

• gpt-4o - OpenAI GPT-4o
• claude-sonnet-4-20250514 - Claude Sonnet 4
• 其他可用模型请查看 KvioAI 模型广场

第四步：验证连接

配置完成后，打开 Cursor 的 Chat 面板（Ctrl + L 或 Cmd + L），发送一条测试消息：

你好，请介绍一下你自己

如果收到正常回复，说明配置成功。

功能兼容性对照表

功能	是否走 KvioAI 中转站？
AI Chat / Plan 模式（Ctrl + L）	是
Composer（Ctrl + I）	否（锁定 Cursor 官方后端）
Inline Edit（Ctrl + K）	否（锁定 Cursor 官方后端）
代码补全 / Tab	否（锁定 Cursor 官方后端）
Coding Agent	否（锁定 Cursor 官方后端）

常见问题

Cursor 提示 401 Unauthorized？

• 确认 API Key 正确，只复制 key 字段的值，不要带入 JSON 的引号或多余字符
• 确认 Key 未过期且账户余额充足

Cursor 提示连接超时或请求卡住？

• 确认 Base URL 包含了 /v1 后缀
• 部分用户反馈自定义 API 在 Chat 模式下可能出现请求循环或卡住的情况，这是 Cursor 自定义端点的已知问题
• 建议尝试切换不同模型（如 gpt-4o 或 claude-sonnet-4-20250514）

Composer / Inline Edit 不走中转站？

• 这是 Cursor 的设计限制，Composer、Inline Edit、代码补全等功能被硬编码为只能使用 Cursor 官方后端
• 如需完整的 AI 编程代理走中转站，建议使用 Claude Code 部署 或 CodeX 部署

如何切换不同模型？

在 Cursor Chat 面板顶部，点击模型名称下拉菜单，即可切换不同模型。不同模型可能有不同的价格，请参考 KvioAI 模型广场的定价说明。

📱 获取帮助 使用过程中如有问题，请添加微信 vp4wt 获取技术支持。