Cursor

这篇教你在 Cursor 编辑器里接入 OpenAI Hub 的 API，让你用一个 Key 在 Cursor 里调用 Claude、GPT、Gemini 等所有主流模型。

你需要准备什么

• Cursor Pro 或以上订阅 —— 免费版不支持自定义 Base URL，这一步不满足后面全白搭
• OpenAI Hub 的 API Key —— 去 openai-hub.com 注册后获取

第一步：打开 Cursor 模型设置

点击 Cursor 右上角的 齿轮图标，进入设置界面，选择 Models 选项卡。

第二步：填写 API Key 和 Base URL

在 Models 页面往下找到 API Keys 区域：

1. 在 OpenAI API Key 输入框填入你的 Key：

sk-your-api-key

2. 在 Override OpenAI Base URL 输入框填入：

https://api.openai-hub.com/v1

3. 同时打开两个开关：勾选 Override OpenAI Base URL 和 OpenAI API Key 的启用开关

注意：这里容易出问题 —— 很多人只开了 Override URL 的开关，没开 API Key 的开关。结果请求还是走 Cursor 自带的额度，根本没用到你的 Key。两个开关都打开后，你应该能看到一个黄色警告标识，这才说明自定义 URL 真正生效了。

第三步：添加你想用的模型

在模型列表底部找到 Add Model 按钮，输入你要用的模型名称，比如：

• claude-sonnet-4-20250514
• gpt-4o
• gemini-2.5-pro
• deepseek-r1

注意：模型名必须和 OpenAI Hub 支持的模型 ID 完全一致，多一个字少一个字都不行。具体支持哪些模型，去 OpenAI Hub 文档 查。

添加完成后，把你不需要的模型前面的勾去掉，只保留你要用的。

第四步：验证配置是否生效

点击模型旁边的 Verify 按钮。如果没有报错，说明连接成功。

然后打开 Cursor 的聊天窗口（右上角对话图标），选择你刚添加的模型，随便问个问题试试。

配置没生效？按这个顺序排查

现象	大概率原因
Verify 报 401	API Key 填错了，或者没开启 API Key 开关
Verify 报 404	模型名拼错了，对照 OpenAI Hub 文档检查
没有黄色警告标识	两个开关没全开，请求还在走 Cursor 默认通道
能聊天但补全没反应	在 Models 设置里确认你添加的模型被勾选用于 code completion

在终端里快速验证 API 是否通的

不确定是 Cursor 的问题还是 API 的问题时，先用 curl 排除一下：

curl https://api.openai-hub.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "说一个程序员笑话"}]
  }'

如果 curl 能正常返回结果，说明 API 没问题，回 Cursor 里检查配置。如果 curl 也报错，那就是 Key 或网络的问题。

不想买 Cursor Pro？还有一条路

如果你用的是 Cursor 免费版，没法改 Base URL，但又想用 OpenAI Hub 的模型——可以在 Cursor 的内置终端里直接用 Python 调：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.openai-hub.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "用 Python 写一个快速排序"}]
)

print(response.choices[0].message.content)

虽然没有 Cursor 原生的补全和 Composer 体验，但至少模型能用上。