Cursor IDE穿过模型门

Cursor 使用 OpenAI 兼容端点：

https://api.model-gate.com/v1

1. 创建 API 密钥

打开 https://panel.model-gate.com/en/api-keys，创建一个密钥，并立即复制它。

2. 配置光标

1. 打开 光标设置。 2. 打开 型号 或者 API 密钥，取决于安装的光标版本。 3. 在 OpenAI API 密钥字段中输入模型门密钥。 4. 启用 OpenAI 基本 URL 覆盖。 5. 将基本 URL 设置为：

https://api.model-gate.com/v1

6. 使用短模型门别名添加自定义模型。游标可能会拒绝或重写完整的规范模型 ID，因此请使用别名，例如 ch-47 而不是 claude-opus-4.7。 7. 验证配置并开始新的聊天。

Cursor 中的自定义 API 密钥适用于标准聊天模型功能。游标托管的专门功能可能会继续使用游标基础设施。

模型别名

在 Cursor 中指定模型别名，例如 ch-47，而不是原始模型 ID，例如 claude-opus-4.7。由于其内部模型名称限制，光标可以拒绝或重写完整模型名称。因此，Model Gate 支持管理员管理的别名。

下面列出了当前启用的别名：

Alias	Model
ch-46	claude-opus-4-6
ch-46s	claude-sonnet-4-6
ch-47	claude-opus-4-7
ch-48	claude-opus-4-8
ch-g54	gpt-5.4

例子：

Cursor model: ch-47
Resolved model: claude-opus-4.7

Model Gate 之前解析别名：

- 型号可用性检查； - 用户和官方定价； - 使用成本计算； - 异步排队； - 上游交付； - 请求历史存储。

上游响应可以包含规范模型 ID。

验证游标外部

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }'

故障排除

问题	解决
光标拒绝长模型 ID	使用如下所示的启用的短别名 /v1/models。
认证失败	重新输入模型门密钥并使用curl 进行验证。
请求未到达 Model Gate	确认基本 URL 包含 /v1。
找不到型号	别名可能被禁用或映射到禁用的模型。
游标功能忽略自定义 API	测试标准聊天模型；并非每个 Cursor 托管的功能都支持自定义 API 密钥。

当前 Cursor API 密钥文档： https://docs.cursor.com/settings/api-keys。