Cursor
最近更新：2026年8月26日
Cursor 的自定义 OpenAI 地址指向 Amux。附本站实测的模型兼容性说明。
Cursor 允许覆盖 OpenAI 的地址与密钥，指向 Amux 即可。
需要 Cursor Pro 订阅——自定义模型与第三方 API 是 Pro 才有的功能。
一、创建 Amux 密钥
在控制台的密钥页创建一把。创建后仍可在该页面再次查看，无需重新生成。
二、配置
- 打开 Cursor 的 Settings（齿轮），左侧选 Models
- 找到 OpenAI API Key：打开开关，粘贴你的 Amux 密钥
- 找到 Override OpenAI Base URL：打开开关，填
https://gateway.amux.ai/v1 - 点 + Add Custom Model，填模型的规范 ID（例如
anthropic/claude-opus-5），确认开关是打开的（绿色）
三、验证
按 Cmd + L（macOS）或 Ctrl + L（Windows）打开对话，在模型下拉里选中刚添加的模型，并发送一条测试消息。
已知限制
以下两项限制主要来自 Cursor 当前对自定义 OpenAI 地址的实现方式，但会直接影响接入效果，因此在此单独列出。
| 模型 | 表现 | 现状 |
|---|---|---|
| GPT 系 | 报 Parameter messages is required | Cursor 对这一类走 Responses 的请求形状，而自定义地址那一栏走的是 Chat Completions 的路径，两者对不上。目前没有绕开的办法 |
| Claude 系 | 部分模式下因工具定义报错 | Cursor 会把工具定义一并发过来，形状与 Chat Completions 不完全兼容 |
两条都取决于 Cursor 自己何时改。介意的话，Cline 走的是标准 OpenAI 兼容协议，没有这类问题。
选模型
每个要用的模型都得在 Add Custom Model 里加一遍——Cursor 这一栏不拉取模型列表。名字用规范 ID。
要锁定供应商或指定路由策略，把带后缀的完整形式填进去（anthropic/claude-opus-5:@price），见 API 参考。
常见问题
下拉里看不到刚加的模型
回 Models 页确认那一项的开关是绿的。新加的模型默认可能是关着的。
鉴权失败
两个开关都需要打开。如果只填写密钥而未开启 Override OpenAI Base URL，请求仍会发往 OpenAI 官方地址，因此会表现为鉴权失败。
补全（Tab）还是走 Cursor 自己的模型
自定义 OpenAI 地址只作用于对话，代码补全走的是 Cursor 自己的服务。这是它的产品设计，不是配置问题。