使用指南
返回主页

外观

Cursor 配置 ​

Cursor 是一款 AI 编程编辑器。这里通过 OpenAI API Key 和自定义 Base URL（API 请求的基础地址）连接 custom，并使用 Cursor 的 Auto 聊天模型入口完成验证。

接入协议OpenAI Compatible / Chat Completions
打开安装说明

配置步骤

  1. 1

    打开 Cursor，点击窗口左下角账户旁的设置齿轮。

  2. 2

    在设置左侧点击 Models；向下滚动到页面底部，再点击 API Keys 展开配置区。

  3. 3

    在 OpenAI API Key 输入框粘贴自己的完整 API Key，并确认右侧 Secret saved 开关已开启。

  4. 4

    开启 Override OpenAI Base URL，在下方输入框粘贴页面复制区显示的 /v1 地址，再点击 Enable OpenAI API Key 确认启用。

  5. 5

    点击设置页左上角的 Back 回到聊天页。

  6. 6

    点击输入框底部的当前模型名称，开启模型菜单顶部的 Auto。

  7. 7

    确认当前模型显示为 Auto，在输入框键入一条简单消息，然后点击右侧发送按钮。

  8. 8

    确认 Cursor 正常显示模型回复。

复制配置

Cursor → Models → API Keys

OpenAI API Key: sk-your-api-key
Secret saved: 开启
Override OpenAI Base URL: 开启
Base URL: 
聊天模型: Auto
看图操作

Cursor 配置流程图

按照 8 张 Cursor macOS 英文界面截图，从左下角设置进入 Models，填写 OpenAI API Key 和自定义 Base URL，启用 Auto 后发送消息验证。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化
  1. 第 1 步

    点击左下角的设置齿轮

    1. 1

      点击左下角账户旁的设置齿轮。

    打开 Cursor，点击窗口左下角账户信息右侧的设置齿轮。截图中的账户邮箱已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  2. 第 2 步

    进入 Models 设置

    1. 1

      点击左侧的“Models”。

    在设置左侧导航中找到并点击“Models”。截图中的账户邮箱已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  3. 第 3 步

    展开 API Keys 配置区

    1. 1

      点击“API Keys”这一行展开配置区。

    向下滚动到 Models 页面底部，点击“API Keys”这一行将配置区展开。截图中的账户邮箱已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  4. 第 4 步

    填写 API Key 和自定义 Base URL

    1. 1

      在 OpenAI API Key 输入框粘贴自己的完整密钥。

    2. 2

      开启“Override OpenAI Base URL”。

    3. 3

      在下方输入框粘贴页面复制区显示的 /v1 地址。

    4. 4

      开启“Secret saved”开关。

    5. 5

      检查无误后点击“Enable OpenAI API Key”确认启用。

    粘贴自己的完整 OpenAI API Key 并开启“Secret saved”；再开启“Override OpenAI Base URL”，粘贴页面复制区显示的 /v1 地址，最后在弹窗中点击“Enable OpenAI API Key”。API Key 在原图中已隐藏，账户邮箱和固定地址已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  5. 第 5 步

    返回聊天页面

    1. 1

      点击左上角的“Back”返回聊天页。

    确认“Secret saved”和“Override OpenAI Base URL”均已开启，然后点击设置页左上角的“Back”返回聊天页。账户邮箱和固定地址已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  6. 第 6 步

    打开模型菜单并启用 Auto

    1. 1

      点击输入框底部的当前模型名称展开菜单。

    2. 2

      开启模型菜单顶部的“Auto”。

    点击输入框底部当前模型名称展开菜单，再开启菜单顶部的“Auto”。不要照抄截图中的其他模型名称。账户邮箱已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  7. 第 7 步

    使用 Auto 发送测试消息

    1. 1

      发送前确认当前模型显示为“Auto”。

    2. 2

      在输入框键入一条简单测试消息。

    3. 3

      点击输入框右侧的发送按钮。

    确认输入框底部显示“Auto”，输入一条简单消息，再点击输入框右侧的发送按钮。截图中的账户邮箱已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）
  8. 第 8 步

    确认收到正常回复

    1. 1

      收到正常回复即表示聊天连接已经成功。

    Cursor 能够显示正常回复，且底部模型仍为“Auto”，就表示 API Key 和自定义 Base URL 已正确配置。截图中的账户邮箱已遮盖。

    自行采集Cursor 3.18.9（macOS 英文界面）

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

保持聊天模型为 Auto，发送“介绍一下你自己”；能够正常返回内容，即表示 API Key 和自定义 Base URL 已生效。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

常见错误 ​

  • 显示 This model does not support custom API keys：切换到 Auto，或选择 Cursor 明确支持自定义 API Key 的标准聊天模型。
  • 返回 404：Override OpenAI Base URL 应以 /v1 结尾，不要追加 /chat/completions，也不要重复成 /v1/v1。
  • 返回 401：重新粘贴完整 API Key，不要带首尾空格，并确认 Secret saved 已开启。
  • 配置没有生效：确认 Override OpenAI Base URL 已开启，再完全退出并重新打开 Cursor。
  • Tab 或部分 Agent 功能仍未使用自定义 Key：这是 Cursor 的功能限制；自定义 API Key 主要用于受支持的聊天模型。
  • 网络无法连接：确认 Cursor 所在电脑能够访问页面复制区显示的 API 地址，并检查 DNS、防火墙和代理。

更多通用错误处理见常见问题。