Cursor 接入指南

在 Cursor 的模型设置中添加 OpenAI Compatible 服务，将 Base URL、API Key 和模型名指向 PotatoAI.cc。

配置目标

无需退出 Cursor 账号，只需要把 PotatoAI.cc 添加为自定义 OpenAI 兼容服务，并用一条短请求完成测试。

• 准备信息
• 配置步骤
  • 1. 打开模型设置
  • 2. 添加兼容服务
  • 3. 填写地址和密钥
  • 4. 添加模型
  • 5. 启用并测试
• 账号、内置模型与切换
• 常见问题
• 建议

准备信息

配置项	填写内容
Provider	OpenAI Compatible
Base URL	https://www.potatoai.cc/v1
API Key	控制台创建的 API Key
Model	控制台显示的完整模型 ID

配置步骤

1. 打开模型设置

进入 Cursor Settings，找到 Models、API Keys 或自定义模型供应商区域。不同版本的菜单名称可能略有差异。

2. 添加兼容服务

选择 OpenAI Compatible。如果版本只提供 OpenAI 配置，则使用允许覆盖 Base URL 的入口。

3. 填写地址和密钥

Base URL 填写 https://www.potatoai.cc/v1，API Key 填写在 PotatoAI.cc 控制台创建的密钥。

4. 添加模型

从控制台复制完整模型 ID。不要自行删减版本号、短横线或大小写。

模型 ID 必须完全一致

只要模型 ID 和 PotatoAI.cc 控制台展示的不一致，Cursor 就可能无法正常调用模型。

5. 启用并测试

保存并启用模型，在 Chat 或 Agent 中发送一条短请求，确认模型能够正常返回。

账号、内置模型与切换

主题	说明
Cursor 账号	不需要退出 Cursor 账号。Cursor 登录负责编辑器、同步和 Cursor 自带功能，PotatoAI.cc API Key 只负责对应模型请求。
内置功能	并非所有功能都经过 PotatoAI.cc。Tab Completion 等依赖 Cursor 专用模型的功能仍可能使用 Cursor 自带服务。
切回官方模型	如果启用了全局 Override OpenAI Base URL，使用官方模型前先关闭该开关；再次使用 PotatoAI.cc 时重新开启。
免费版限制	Cursor 对自带 API Key、Agent 和 Edit 的可用范围可能受当前套餐限制，具体以 Cursor 客户端提示为准。

常见问题

现象	处理方式
没有 Verify 按钮	部分新版本保存后自动生效。直接选择已添加模型发送短消息，并到 PotatoAI.cc 用量日志确认请求。
model not found	从控制台重新复制完整模型 ID，并确认当前账户分组拥有该模型权限。
官方模型也开始报错	关闭 Override OpenAI Base URL 后重试；该设置在部分版本中会影响其他 OpenAI 模型。
Network error / TLS 错误	确认地址为 https://www.potatoai.cc/v1；再到 Network 设置将 HTTP Compatibility Mode 切到 HTTP/1.1 测试。
配置成功但 Tab 仍未走 PotatoAI.cc	这是 Cursor 的产品机制；自定义 API Key 主要用于支持的聊天模型，Tab Completion 可能继续使用内置模型。

建议

单独创建 Cursor 密钥

为 Cursor 单独创建一个 API Key，便于按客户端查看用量、轮换密钥或单独停用。