跳转到内容
悠然 AI 文档

Windows：Cursor

本页介绍 Cursor Windows 客户端的悠然 AI 接入方式。Cursor 的自带 API Key 能力存在客户端限制，请先完成纯文本验证。

在 Windows 上使用 Cursor

Cursor 可以通过 OpenAI API Key 与自定义 Base URL 尝试调用悠然 AI 提供的兼容 GPT 模型。

  1. 安装 Cursor

    从 Cursor 官方下载页面安装最新版 Windows 客户端并完成登录。

    打开 Cursor 官方下载页面

  2. 创建悠然 AI API Key

    前往控制台创建一把独立 Key，不要把它写入项目文件或提交到 Git。

    打开访问密钥页面

  3. 查询可用模型

    运行命令并从返回的 data[].id 中选择 Cursor 能识别的模型 ID。

    PowerShell
    $headers = @{ Authorization = "Bearer <YOURAN_API_KEY>" }
(Invoke-RestMethod -Uri "https://youran-ai.du-fu.com/api/models" -Headers $headers).data |
  Select-Object -ExpandProperty id

  4. 配置 API Key、Base URL 与模型

    进入 Cursor Settings → Models → API Keys，找到 OpenAI 配置并填写：

    OpenAI API Key
    当前悠然 AI API Key
    Override OpenAI Base URL (when using key)
    开启
    OpenAI Base URL
    https://youran-ai.du-fu.com/api
    Model
    /api/models 返回且 Cursor 可识别的模型 ID

  5. 验证并发起第一次请求

    点击 Verify，然后在 Add or search model 中启用对应模型。首次建议使用Ask 模式发送纯文本消息。

  6. 了解 Cursor 的兼容限制

    自定义 API Key 主要用于标准聊天模型。Tab Completion、Background Agent 和部分专用功能仍可能使用 Cursor 内置服务；开启 Base URL 覆盖也会影响其他 OpenAI 系列模型。

    如果出现 missing_required_parameter: messages、请求持续等待或工具调用异常，请先确认 Base URL 后没有追加 /v1，再改用 Claude Code、Codex 或其他兼容客户端。

    查看 Cursor 自带 API Key 官方文档