Cursor 配置指南前置要求有效的 UniVibe API 密钥注册UniVibe API 密钥点击注册注册即

前置要求

有效的 UniVibe API 密钥

注册UniVibe API 密钥点击注册注册即可获得 6000积分

安装步骤

1. 安装 Cursor

如果您还没有安装 Cursor,请先完成安装:

打开浏览器访问 Cursor 官网
根据您的操作系统选择对应版本下载:
- Windows: 下载 .exe 安装程序
- macOS: 下载 .dmg 安装程序
- Linux: 下载 .AppImage 或 .deb 安装包
下载完成后运行安装程序
按照安装向导完成安装

2. 设置自定义 URL 和 Key

安装完 Cursor 后,需要配置 UniVibe 的 API 端点和密钥。

打开 Cursor Settings

Windows/Linux:

按快捷键 Ctrl + Shift + J 打开 Cursor Settings
或点击菜单文件 → 首选项 → Cursor Settings

macOS:

按快捷键 Cmd + Shift + J 打开 Cursor Settings
或点击菜单 Cursor → 首选项 → Cursor Settings

配置 API Key

在设置界面中,点击左侧导航栏的 Models(模型)
向下滚动找到 API Keys 部分
找到 OpenAI API Key 配置项
在 API Key 输入框中填入您的 UniVibe API 密钥
点击右侧的开关启用 OpenAI API Key
点击开启 Override OpenAI Base URL 开关
在 Base URL 输入框中填入:https://api.univibe.cc/openai/v1

配置 URL 和 Key

💡 提示:请妥善保管您的 API 密钥,不要泄露给他人。

获取 API 密钥

3. 开始使用

配置完成后,您可以在 Cursor 中使用 UniVibe 的模型了。

在 Cursor 编辑器中,点击底部的模型选择器
选择 Claude 系列模型(如 claude-sonnet-4-20250514)
确保处于 非 Agent 模式
即可开始发送消息使用

使用模型

💡 注意:如需使用 Agent 模式,需要订阅 Cursor Pro(见下文"获取 Cursor Pro"部分)。

模型配置

使用说明

经过测试,Claude 系列模型可以直接选择使用,无需额外配置。

如需使用 GPT-5 系列模型或模型别名,需要手动添加映射的模型名称:

打开 Cursor Settings (Ctrl + Shift + J / Cmd + Shift + J)
进入 Models(模型)选项
在顶部 Add or search model 输入框中输入下表中的映射名称
点击右侧的开关启用该模型,即可在使用时选择

模型名称映射表

OpenAI 别名映射

完整别名	实际模型	说明
`OGN5-high`	`gpt-5-high`	GPT-5 高性能版本
`OGN5-low`	`gpt-5-low`	GPT-5 低成本版本
`OGC5-high`	`gpt-5-codex-high`	GPT-5 Codex 高性能版本
`OGC5-low`	`gpt-5-codex-low`	GPT-5 Codex 低成本版本

💡 提示: 直接复制第一列的完整别名添加到模型列表即可使用。

Claude 系列别名映射（一般无需配置）

别名	实际模型	说明
`AH3.5`	`claude-3-5-haiku-20241022`	Haiku 3.5
`AH4.5`	`claude-haiku-4-5-20251001`	Haiku 4.5
`AS3.7`	`claude-3-7-sonnet-20250219`	Sonnet 3.7
`AS4`	`claude-sonnet-4-20250514`	Sonnet 4
`AS4-1M`	`claude-sonnet-4-20250514[1m]`	Sonnet 4 长上下文
`AS4-5`	`claude-sonnet-4-5-20250929`	Sonnet 4.5
`AO4`	`claude-opus-4-20250514`	Opus 4
`AO4.1`	`claude-opus-4-1-20250805`	Opus 4.1

模型列表

获取 Cursor Pro(可选)

为什么需要 Cursor Pro?

Cursor 的 Agent 模式(智能代理模式)需要订阅 Pro/Pro+/Business 版本才能使用。如果您不需要使用 Agent 模式,可以跳过此部分。

获取方式

官方订阅

访问 Cursor 定价页面
最低价格:$20/月

优惠获取方式：万能的闲鱼/淘宝

为什么还需要 UniVibe?

即使订阅了 Cursor Pro,官方提供的用量额度仍然有限,频繁使用容易触发限额。

最佳实践:

订阅 Cursor Pro 仅用于解锁 Agent 模式
通过自定义 API Key 使用 UniVibe 的原版中转模型，畅用Claude/GPT顶尖原版模型
这样既能享受 Agent 模式,又能畅用使用顶尖的 AI 模型

综合建议

适合使用 Cursor + UniVibe 的用户:

已有 Cursor Pro 但用量不够
习惯使用 Cursor 的开发者

更加推荐的方案:

如果您还没有订阅 Cursor Pro,也可以考虑使用 GitHub Copilot + VSCode:

无需购买低价 Pro 账号
只需下载安装官方 VSCode，自带GitHub Copilot，配置key简单
Agent 等各方面体验非常棒,可直接代替甚至超越 Cursor
Microsoft 世界级大厂打磨，顶尖IDE团队，Cursor也只是魔改的VSCode

详见左侧文档中的 GitHub Copilot 安装。

常见问题解决

无法连接到 UniVibe 服务

确保:

Base URL 配置正确:https://api.univibe.cc/openai/v1
API 密钥有效且未过期
网络连接正常,可以访问 UniVibe 服务
已在 Settings → Models → API Keys 中正确开启 Override OpenAI Base URL 开关

模型无响应或返回错误

如果模型没有响应或返回错误:

检查 API 密钥是否有足够的积分
确认选择的模型名称正确
查看 Cursor 的输出面板(View → Output)中的错误信息
尝试切换到其他模型测试

Agent 模式无法使用

如果 Agent 模式无法启用:

确认已订阅 Cursor Pro
检查 Pro 订阅是否有效
重启 Cursor 后重试

GPT-5 系列模型无法使用

如果 GPT-5 系列模型无法使用:

确认已按照"模型配置"部分添加映射名称
检查模型名称是否正确(区分大小写)
确认已勾选添加的模型
重启 Cursor 后重试

Cursor 配置指南