接入 Agent 工具

Cursor

Cursor 是一款 AI 原生代码编辑器,支持通过 OpenAI 兼容接口接入 AutoRouter

Cursor

Cursor 是一款 AI 原生代码编辑器,基于 VS Code 构建,内置 AI 聊天、代码补全、Agent 模式等功能。通过配置 OpenAI 兼容接口,可将 Cursor 对接到 AutoRouter,使用 AutoRouter 网关分发的各类模型。

仅 Cursor Pro 及以上订阅用户可配置自定义模型,免费版会报错。

📦 接入前准备

准备信息

  • 已安装 Cursor(Pro 或以上订阅)
  • 一个可用的 AutoRouter 地址(必须以 /v1 结尾)
  • 一个可用的 AutoRouter API Key(在控制台生成)
  • 想使用的模型名称(如 claude-sonnet-4-6gpt-5.4 等,需与 AutoRouter 控制台中的模型 ID 完全一致)

🚀 配置步骤

1. 安装 Cursor

前往 Cursor 官网 下载并安装对应平台版本。

2. 打开模型设置

在 Cursor 中点击设置图标 → Cursor SettingsModels 页面。

3. 配置 API Key 和 Base URL

  1. 启用 OpenAI API Key,输入在 AutoRouter 控制台生成的 API Key。
  2. 启用 Override OpenAI Base URL,输入你的 AutoRouter 地址,例如:
    https://autorouter.top/v1

4. 添加模型

Add or search model 输入框中输入模型名称,单击 Add Custom Model

以下模型名称在 Cursor 中需要使用别名:

实际模型名Cursor 中使用
kimi-k2.5kimi-k2-5
glm-4.7glm-4-7
其他模型与 AutoRouter 控制台中的模型 ID 一致

5. 开始使用

在聊天面板选择对应模型即可使用。

如果找不到添加的模型,在聊天面板将 Auto 模式关闭,再从下拉列表中选择。

❓ 常见问题

报错 The model xxx does not work with your current plan or api key.

您当前使用的是 Cursor 免费版,免费版不支持自定义模型。请升级至 Cursor Pro 或以上。

报错 We're having trouble connecting to the model provider.Unauthorized

  • 检查 API Key 是否正确,以及 Base URL 是否以 /v1 结尾。
  • 模型名称冲突:glm-4.7kimi-k2.5 与 Cursor 内置模型名冲突,请使用上方表格中的别名。
  • 模型 ID 必须与 AutoRouter 控制台中暴露的名称完全一致。

目录