Cursor 可以通过 OpenAI-compatible 自定义模型接入云信大模型 API 平台（简称 AIHub）。接入后，Cursor 的聊天和代码编辑请求将使用 AIHub 访问令牌和模型名称。

安装 Cursor

前往 Cursor 官网 下载适合当前操作系统的安装包并完成安装。首次启动后登录 Cursor 账号，打开需要使用的项目。

安装完成后，进入 Cursor Settings > Models。如果后续配置项不显示，请确认：

• Cursor 已完成登录。
• 当前版本支持自定义 OpenAI API Key 和 Override OpenAI Base URL。

配置接入凭证

在 Cursor Settings 的 Models 页面中，开启 OpenAI API Key 和 Override OpenAI Base URL 选项，然后填写以下配置：

配置项	说明
OpenAI API Key	AIHUB_TOKEN，，即 AIHub API 密钥/访问令牌
Override OpenAI Base URL	$AIHUB_BASE_URL/v1，例如 https://ai.yunxinapi.com/hub/v1
Model Name	AIHub 模型名称

配置示例：

textOpenAI API Key: sk-...
Override OpenAI Base URL: https://ai.yunxinapi.com/hub/v1
Model Name: your-logical-model

::: note 如果 Cursor 的 Auto 模式优先选择内置模型，请关闭 Auto 模式，手动选择刚添加的 AIHub 模型。 ::

验证配置

在 Cursor 聊天窗口中选择 AIHub 模型，发送：

text只回复 OK

如果控制台请求日志中出现 /v1/chat/completions 请求，说明 Cursor 已成功通过 AIHub 调用模型。

使用前检查

在配置前，建议先使用 curl 验证当前令牌可用的模型列表：

bashcurl "$AIHUB_BASE_URL/v1/models" \
  -H "Authorization: Bearer $AIHUB_TOKEN"

响应中的 data[].id 即为可作为 Cursor Model Name 的可用模型名称。

常见问题

现象	排查方向
找不到添加的模型	关闭 Auto 模式，手动选择自定义模型；确认模型名没有拼写错误。
Unauthorized User API key	API Key 应填写 AIHub 访问令牌（AIHUB_TOKEN），而非上游供应商密钥。
连接模型供应商失败	检查 Override OpenAI Base URL 是否为 $AIHUB_BASE_URL/v1，不要写成完整的 /chat/completions 路径。
模型返回不支持某参数	Cursor 可能传入了工具或扩展参数，可换用兼容模型或在控制台检查渠道能力。