千木DEV
← 返回工具集成指南

Cursor

AI 代码编辑器（VS Code fork），原生支持 OpenAI 协议的自定义端点，通过 GUI 配置。

GUI 配置OpenAI

安装

从 cursor.com 下载安装。

配置步骤

  1. 1

    安装 Cursor

    从官网下载对应平台的安装包并安装。

    terminal
    # macOS (Homebrew)
brew install --cask cursor

# 或从官网下载
# https://cursor.com
  2. 2

    打开模型设置

    在 Cursor 中打开设置面板，导航到 Models → API Keys 页面。

    Cursor 设置
    # 方式一：菜单栏
Settings → Models → API Keys

# 方式二：快捷键
macOS: Cmd + ,
Windows: Ctrl + ,
  3. 3

    配置自定义端点

    在 Models → API Keys 页面中开启 Override OpenAI Base URL，填入网关地址和 API Key。

    Cursor 设置
    操作步骤：
1. 打开 Settings → Models → API Keys
2. 打开 "Override OpenAI Base URL" 开关
3. Base URL 填入：https://api.example.com/v1
4. OpenAI API Key 填入：sk-your-api-key
5. 在 Model 下拉框中选择或输入模型名（如 deepseek-v3.2）

    Base URL 开关可能随 API Key 输入自动开启（已知行为），如遇 HTTP/2 连接错误，在 Settings → Network → HTTP Compatibility Mode 中切换为 HTTP/1.1。

  4. 4

    使用模型

    配置完成后，在 Chat 或 Composer 中选择自定义模型即可使用。

    Cursor
    # 在 Cursor 中使用
# 1. 打开 Chat 面板（Cmd+L / Ctrl+L）
# 2. 点击模型选择器
# 3. 选择你配置的模型（如 deepseek-v3.2）
# 4. 开始对话

注意事项

  • 仅支持 GUI 配置，无配置文件或 CLI 方式
  • 推理模型（o1/o3）可能不兼容自定义端点
  • Base URL 开关可能随 API Key 输入自动开启（已知行为）
← 返回文档