在 Cursor 中接入 CaMeL Hub:一个 API Key 用尽 GPT、Claude、Gemini、DeepSeek

Cursor 是一款基于 VS Code 打造的 AI 代码编辑器,自带对话、跨文件编辑(Composer)以及可以自主执行终端命令、读取代码库的 Agent 模式。默认情况下这些功能都走 Cursor 自己的订阅额度。把 Cursor 指向 CaMeL Hub 的 OpenAI 兼容端点后,你可以改用 CaMeL Hub 账户里的余额按量付费,并且能自由选用 GPT-5.5、Claude Sonnet 5、Gemini 3.1 Pro、DeepSeek V4 等几十个模型——全部共用你可能已经在其他工具里用着的同一把 API Key。

Cursor ↗

  1. 拿到你的 CaMeL Hub API Key

    登录 CaMeL Hub 控制台,打开「令牌」页面,新建一个令牌(或直接复用已有的),复制形如 sk-... 的 Key。动手改 Cursor 设置之前,建议先在终端里自测一下这把 Key 能不能用:
    curl https://api.camel-hub.com/v1/chat/completions \
      -H "Authorization: Bearer sk-your-camel-hub-key" \
      -H "Content-Type: application/json" \
      -d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"ping"}]}'
  2. 打开 Cursor 的模型设置

    在 Cursor 里点击右上角的齿轮图标进入 Settings,切换到 Models 标签页。这里就是 Cursor 允许你自带 API Key、并自定义请求地址(Base URL)的地方。
  3. 把 OpenAI 供应商指向 CaMeL Hub

    把 CaMeL Hub 的 Key 粘贴进标注为 OpenAI API Key 的输入框,再打开「覆盖请求地址」的开关——通常是一个叫 Override OpenAI Base URL 或类似名字的 Base URL 字段,填入下面这个地址。此后 Cursor 发出的 OpenAI 格式请求会转发到 CaMeL Hub,而不是直连 OpenAI。
    https://api.camel-hub.com/v1
  4. 把你要用的模型逐个加进去

    Cursor 默认自带的模型开关(比如列表里现成的 gpt-4o、claude-3.5-sonnet 这些)背后接的是 Cursor 自己的后端,不一定会走你设置的自定义地址。要稳定用到 CaMeL Hub 的模型,得在模型列表附近找到「添加模型」或「+」之类的入口,手动输入 CaMeL Hub 对应的模型名(大小写需完全一致):
    gpt-5.5
    gpt-5.4-mini
    claude-sonnet-5
    claude-opus-4-8
    gemini-3.1-pro
    deepseek-v4-flash
  5. 点击 Verify 验证

    在 OpenAI API Key 字段旁点击 Verify(或 Save)。Cursor 会通过你填的地址发一个测试请求,出现绿色对勾就说明 Key 和地址都连通正常。验证失败的排查方法见下方 FAQ。
  6. 在 Chat / Composer / Agent 里选择模型

    在对话、Composer 或 Agent 面板里打开模型选择下拉框(通常会显示当前模型名),选中你刚才添加的自定义模型。之后这个模型产生的每一次请求都会从你的 CaMeL Hub 余额里扣费,而不占用 Cursor 订阅额度。

常见问题

模型选择器里看不到我加的 CaMeL Hub 模型。

大概率是只配置了 OpenAI Key 和 Base URL,但没有把模型当作自定义条目手动添加——Cursor 自带的开关列表不会自动包含 gpt-5.5、claude-sonnet-5 这类 CaMeL Hub 上较新的模型名。回到 Models 标签页,按第 4 步逐个把模型名精确添加进去。

curl 能测通,但 Cursor 里点 Verify 就是失败。

先检查 Base URL 有没有多打斜杠或漏掉 /v1(必须完全是 https://api.camel-hub.com/v1)、粘贴 Key 时有没有带上多余空格或换行,再去 CaMeL Hub 控制台确认这把令牌没被禁用、额度也没耗尽。如果所在网络的代理或防火墙拦截了 Cursor 的出站请求,即便终端直接 curl 能通,Verify 也可能照样失败。

大型重构和日常小改动应该分别用什么模型?

跨文件的 Composer/Agent 任务、需要深度推理的场景,建议选 claude-sonnet-5 或 claude-opus-4-8 这类更强的模型;日常小改动和快速内联编辑,用 gpt-5.4-mini 或 deepseek-v4-flash 这类更轻量的模型响应会更快。Cursor 里可以按对话随时切换模型,不用全局一刀切。

这样配置会影响 Cursor 的 Tab 自动补全吗?

不会。Tab 的行内代码补全跑在 Cursor 自己的专有模型上,不受 OpenAI Key / Base URL 覆盖设置的影响——这套接入方式只对 Chat、Composer 和 Agent 的请求生效。