# Cursor Cursor 的对话和 Agent 可以改用你自己的 OpenAI 兼容服务。填好 Key 和 Base URL，再手动添加模型名。 > https://nezhagate.com/docs/integrations/cursor 按此版本编写：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 URL`https://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](https://nezhagate.com/docs/integrations/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`。