Cursor 配置

需要先说明一个非常重要的前置条件：Cursor 的自定义 API 功能（即“自带密钥” BYOK 模式）仅对 Pro 或更高版本的付费订阅用户开放。如果你未订阅，将无法使用下文介绍的配置方法。

步骤 1：下载并安装 CursorCopy Anchor Link

1. 访问 Cursor官网 下载对应你操作系统（Windows/macOS/Linux）的安装包。
2. 运行安装程序，并按照提示完成安装，过程与常规软件无异。

步骤 2：配置 APICopy Anchor Link

1. 打开 Cursor，点击右上角的齿轮图标 ⚙️ 打开“设置”（或使用快捷键 Ctrl/Cmd + ,）。
2. 在左侧导航栏中选择 “Models” 选项卡。
3. 在“Models”页面中，向下滚动找到 “OpenAI API Key” 部分。
   • API Key：在此处粘贴你从服务商处获取的 API 密钥。
   • Override OpenAI Base URL：点击开关启用，并在下方输入框中填写 API 基础地址 https://token.firstpy.com/v1。

步骤 3：添加自定义模型Copy Anchor Link

配置好 API 密钥和地址后，你需要手动告诉 Cursor 你想使用哪些模型。

1. 在“Models”页面，找到 “Add Custom Model” 按钮并点击。
2. 在弹出的窗口中，输入模型的准确名称。这个名称必须与你的 API 服务商提供的模型标识符完全一致（例如 py-cs-4.5）。
3. （可选）为该模型设置一个别名（Alias），方便你在 Cursor 的模型列表中识别。
4. 点击“Add Model”完成添加。

步骤 4：验证配置并开始使用Copy Anchor Link

1. 验证配置：在 Cursor 的聊天（Chat）或编辑器（Composer）面板中，点击底部的模型选择器，你应该能看到刚刚添加的自定义模型。选择它，然后发送一个简单的测试消息（例如“你好”），如果能收到正常回复，说明配置成功。
2. 开始使用：配置完成后，你就可以在 Cursor 的各种功能（如 Chat、Composer、Cmd+K 等）中使用你的第三方模型了。

选：使用 settings.json 配置文件Copy Anchor Link

你也可以直接编辑 Cursor 的配置文件来管理 API 设置。该文件路径为：

• Windows: %APPDATA%\Cursor\User\settings.json
• macOS: ~/Library/Application Support/Cursor/User/settings.json
• Linux: ~/.config/Cursor/User/settings.json

你可以在其中添加如下配置来覆盖 OpenAI 的 Base URL：

{
  "cursor.openAiBaseUrl": "https://token.firstpy.com/v1"
}

保存文件后，重启 Cursor 即可生效。

常见问题Copy Anchor Link

Q: 无法开启 "Override OpenAI Base URL"？
A: 此功能是 Cursor Pro/Business 订阅用户的专属功能，免费版用户无法使用。

Q: 添加模型后，在列表里找不到？
A: 请检查输入的模型名称是否与 API 服务商提供的完全一致。可以尝试重启 Cursor 或刷新模型列表。

Q: 报错 “Connection refused” 或 “404 Not Found”？
A: 请检查你填写的 Base URL 是否正确，特别是末尾是否包含了 /v1 路径。例如，正确的格式应为 https://token.firstpy.com/v1。

Q: 配置成功了，但感觉用的是 Cursor 官方的模型？
A: 请务必在模型列表中关闭 Cursor 内置的、与你添加的自定义模型同名的模型开关，避免请求被错误路由。

Q: 如何获取更详细的错误信息？
A: 你可以通过 Cursor 的菜单 Help -> Toggle Developer Tools 打开开发者工具，在 Console 面板中查看网络请求的详细错误日志。