配置 Cursor
本章节将指导您如何配置 Cursor 连接 AwesomeAPI 服务。
Warning: Cursor 对
claude开头的模型名称做了限制（套甲验证），即使通过 AwesomeAPI 也无法直接使用 Claude 模型。推荐使用gemini-pro-high等其他模型。
获取 API Key
- 访问 AwesomeAPI 并登录账号
- 进入个人中心或 API 管理页面
- 创建新的 API Key 并复制保存
Warning: 请妥善保管您的 API Key，不要泄露给他人或提交到公开仓库。
配置步骤
Cursor 仅支持通过 OpenAI 兼容模式 接入 AwesomeAPI。
1. 打开 Cursor Settings
- 按
Ctrl+Shift+J（Windows/Linux）或Cmd+Shift+J（macOS） - 或者点击右上角齿轮图标 → Cursor Settings
- 在设置页面中切换到 Models 选项卡
2. 配置 OpenAI API
- 在 Models 页面中，找到 OpenAI 区域
- 在 OpenAI API Key 字段中粘贴您的 API Key
- 勾选 Override Base URL
- 在 Base URL 字段中填入：
http://8.130.53.188:3000/v1 - 点击 Verify 按钮验证连接
3. 添加模型
- 在模型列表上方，点击 + Add model
- 输入模型名称（示例：
gpt-5.2或gpt-5.3-codex或gemini-pro-high），按回车确认 - 确保该模型处于启用状态（开关为开）
Note: 点击 Verify 后如果显示绿色对勾，说明连接成功。
关于模型选择
Warning: Cursor 内置了对
claude开头模型名称的限制，会强制走 Cursor 官方验证，导致无法通过第三方 API 使用。因此请不要添加任何以claude开头的模型。
推荐模型：
| 模型名称 | 适用场景 |
|---|---|
gpt-5.2 |
推荐 - 通用开发、长输出、复杂推理 |
gpt-5.3-codex |
推荐 - 代码任务（重构/修复/生成） |
gemini-pro-high |
推荐 - 日常开发、代码生成、复杂任务 |
更多可用模型请到 AwesomeAPI 模型广场 查看。添加模型时请避免使用 claude 开头的名称。
配置选项说明
| 配置项 | 描述 | 示例值 |
|---|---|---|
| API Provider | 模型提供商 | OpenAI |
| API Key | API 认证密钥 | sk-xxx... |
| Override Base URL | 启用自定义 API 端点 | 勾选 |
| Base URL | API 服务端点地址 | http://8.130.53.188:3000/v1 |
| Model | 使用的模型名称 | gemini-pro-high |
Warning: 必须勾选 Override Base URL 并填入 AwesomeAPI 地址，否则 Cursor 会连接官方 API。
验证配置
配置完成后，按 Ctrl+L / Cmd+L 打开 Chat 面板，选择 gemini-pro-high 模型，输入：
你好，请介绍一下自己
如果能正常收到回复，说明配置成功。
常见问题
Verify 按钮显示红色叉号
如果验证失败，请检查：
- API Key 是否正确粘贴（无多余空格）
- 是否勾选了 Override Base URL
- Base URL 是否正确填写为
http://8.130.53.188:3000/v1 - 网络是否正常
连接超时
如果遇到连接超时，请检查：
- 网络是否正常
- API 地址是否正确
- 防火墙是否阻止了连接
API Key 无效
如果提示 API Key 无效：
- 确认 Key 是否正确复制（无多余空格）
- 确认账户是否有足够额度
- 尝试重新生成 API Key
添加的模型不可用
如果添加的模型无法使用：
- 确认模型名称拼写正确
- 不要使用
claude开头的模型名称（Cursor 会拦截） - 确认账户有权限访问该模型
- 推荐使用
gemini-pro-high
连接到了官方 API
如果发现连接的是官方 API 而非 AwesomeAPI：
- 确认已勾选 Override Base URL
- 确认 Base URL 填写为
http://8.130.53.188:3000/v1 - 修改后点击 Verify 重新验证