接入 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-6、gpt-5.4等,需与 AutoRouter 控制台中的模型 ID 完全一致)
🚀 配置步骤
1. 安装 Cursor
前往 Cursor 官网 下载并安装对应平台版本。
2. 打开模型设置
在 Cursor 中点击设置图标 → Cursor Settings → Models 页面。
3. 配置 API Key 和 Base URL
- 启用 OpenAI API Key,输入在 AutoRouter 控制台生成的 API Key。
- 启用 Override OpenAI Base URL,输入你的 AutoRouter 地址,例如:
https://autorouter.top/v1
4. 添加模型
在 Add or search model 输入框中输入模型名称,单击 Add Custom Model。
以下模型名称在 Cursor 中需要使用别名:
| 实际模型名 | Cursor 中使用 |
|---|---|
kimi-k2.5 | kimi-k2-5 |
glm-4.7 | glm-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.7、kimi-k2.5与 Cursor 内置模型名冲突,请使用上方表格中的别名。 - 模型 ID 必须与 AutoRouter 控制台中暴露的名称完全一致。