NezhaGateNezhaGate

Cursor 的对话和 Agent 可以改用你自己的 OpenAI 兼容服务。填好 Key 和 Base URL,再手动添加模型名。

按此版本编写:Cursor 3.22

准备

  • Cursor 付费版(Pro 及以上):免费版不能用自己的 Key 运行对话和 Agent。
  • 团队版需要管理员允许成员使用个人 API Key。
  • Cursor 从它自己的服务器发出请求,NezhaGate 的公网地址可以直接使用。

设置步骤

  1. 打开 Cursor Settings(Ctrl/Cmd + Shift + J)→ Models,滚到底部展开 API Keys。
  2. 在 OpenAI API Key 里粘贴你的 NezhaGate Key,并打开 Use OpenAI API Key 开关(这是两步,缺一不可)。
  3. 打开 Override OpenAI Base URL,填入 https://nezhagate.com/v1。
  4. 在模型搜索框里输入完整的模型名(例如下面列表里的一个),点 Add Custom Model。
  5. 重启 Cursor,新开一个对话,在模型菜单里选中刚添加的模型。
Base URLhttps://nezhagate.com/v1

可以添加的模型

NezhaGate 在售、可以在 Cursor 里添加的对话模型:

gpt-5.6-sol · gpt-5.6-terra · gpt-5.6-luna · gpt-6-astra · gpt-6.1-sol · gpt-6-sol · gpt-6-luna · deepseek-v4.1-flash · deepseek-v4-flash-0731 · glm-5.3 · glm-5.3-flash · kimi-k3 · qwen3.7-max · qwen3.8-max · qwen3.8-max-0902 · qwen3.8-flash · doubao-seed-2-1-pro · doubao-seed-2-1-turbo · grok-4.7

  • 名字以 claude- 开头的模型,Cursor 会改用它的 Anthropic Key 发出,而 Anthropic 这一栏不能改地址,所以 NezhaGate 的 Claude 模型无法在 Cursor 里使用;gemini- 开头的名字同样不保证走自定义地址,上面的列表里也没有放。Claude 请用 Claude Code。
  • 和 Cursor 自带模型同名的(例如 gpt-5.5)加不进去,换一个型号即可。
  • 要发图片,请选支持图片输入的模型(见各模型的 API 文档)。

需要知道的限制

  • Tab 自动补全不使用自己的 Key,只有对话和 Agent 会走 NezhaGate。
  • 这个设置对所有 OpenAI 系列模型生效:打开期间,Cursor 自带的部分模型会提示不支持自定义 Key。要用回它们,关掉 Use OpenAI API Key。
  • Cursor 没有验证自定义 Key 的按钮,Key 输入框保存后也不再显示内容,发一条消息就是最好的测试。

测试

新开对话,选中添加的模型,发一句 Reply with exactly: ok。收到回答后,在控制台的调用日志里能看到这条请求。

常见问题

Model name is not valid / AI Model Not Found

没有打开 Use OpenAI API Key(请求没有带上 Key),或者模型名以 claude- 开头。

This model does not support custom API keys

选中的是 Cursor 自带的模型。换成你添加的模型,或者关掉 Use OpenAI API Key 再使用自带模型。

Invalid API key / Unauthorized User API key

Key 不对:重新粘贴完整的 Key(输入框不显示旧值,直接覆盖即可)。

一直停在 Planning next moves,最后提示限流或服务不可用

通常是免费版不支持自己的 Key,或者 Base URL 填错了。确认是付费版、地址是 https://nezhagate.com/v1。

更多集成