配置步骤

  1. 打开 Cursor Settings

    进入 Settings → Models,找到 API Keys 或 Bring Your Own Key 区域。

  2. 填写 OpenAI API Key

    粘贴你的 Jerry API Key。这里选择 OpenAI,是因为 Jerry API 提供 OpenAI-compatible 接口。

  3. 覆盖 OpenAI Base URL

    开启 Override OpenAI Base URL,填写 https://www.jerryapi.com/v1。

  4. 添加模型名

    在可添加自定义模型的版本中,先添加 gpt-5.4。也可以继续添加 gpt-5.4-mini 和 gpt-5.5。

  5. 点击 Verify

    验证通过后启用该 API Key,并在聊天模型选择器中选中对应 GPT 模型。

界面名称可能略有变化

Cursor 会持续调整设置页面。核心字段不变:OpenAI API Key、Override OpenAI Base URL、模型 ID。

应填写的值

Cursor 字段填写内容
ProviderOpenAI
API Key你的 Jerry API Key
Override OpenAI Base URLhttps://www.jerryapi.com/v1
Modelgpt-5.4
不要填写完整接口路径

Cursor 的这个字段是 Base URL,不要写成 /v1/chat/completions,Cursor 会自行添加请求路径。

验证是否生效

  1. 新建一个 Chat 会话

    选择刚添加的 gpt-5.4,发送一个简单的代码解释任务。

  2. 查看使用记录

    在 Jerry API 后台按时间核对模型名、Token 和费用。

  3. 再测试 Agent 任务

    如果聊天正常,再尝试需要工具调用的项目任务;不同 Cursor 功能对自有 API Key 的支持范围可能不同。

Cursor 专有能力不一定走自有 Key

Tab Completion 等依赖 Cursor 专用模型的功能仍可能使用 Cursor 内置服务;自有 API Key 主要用于其支持的聊天模型。请以 Jerry API 后台是否出现请求记录为准。

排查

现象处理
Verify 失败先用快速开始中的 curl 测试密钥,再确认 Base URL 只写到 /v1
模型不在列表检查当前 Cursor 版本是否允许添加自定义模型名,并完整填写模型 ID
聊天成功但后台无记录当前会话可能仍在用 Cursor 内置模型,重新选择自定义 GPT 模型
Agent 功能受限这是 Cursor 对自有 API Key 的功能边界;需要完整 GPT Agent 体验时优先使用 Codex 或 OpenCode