# Cursor 集成

> 把 Cursor 的 Custom OpenAI Base URL 指向本网关,在 Cursor Chat 里使用 103 个文本模型

来源：https://zhonkemodel.dflop.top/docs/integrations/cursor

> Cursor 在 Settings → Models 中支持 Custom OpenAI API。

## 配置

1. 打开 Cursor → ⚙️ **Settings** → **Models**
2. 滚到底部 → **OpenAI API Key** section
3. 勾选 **Override OpenAI Base URL**
4. 填:
   - Base URL: `https://zhonkezhonkeapi.dflop.top/v1`
   - API Key: `sk-gpushare-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`(`sk-gpushare-` + 64 位十六进制字符,总长 76 字符)
5. 在上面的模型列表里 **Add Model**: 填入想用的 model ID,如:
   - `claude-sonnet-4-6`
   - `gpt-5.5`
   - `glm-5.1`
   - `gemini-2.5-pro`
   - 完整列表见 [模型列表](../reference/models.md)
6. **取消勾选 Cursor 内置的 OpenAI 模型**(`gpt-4o` / `gpt-4o-mini` 等)——它们不在模型目录里,留着会导致下一步 Verify 失败
7. 点 **Verify** 确认连通

> **为什么 Add Model 要在 Verify 之前?** Cursor 的 Verify 会用模型列表里当前启用的模型发测试请求。如果还勾着内置的 `gpt-4o` 等模型,网关会返回 `model_not_found`——即使 Base URL 和 Key 全对,Verify 也会 fail。

## 行为

Cursor 走 **OpenAI Chat 协议**,可用模型 = `GET /v1/models` 返回的全部文本模型(101 个,随目录变动),详见 [兼容矩阵](../reference/compatibility-matrix.md) 与 [模型列表](../reference/models.md)。图像 / 视频 / embedding 模型走独立端点,不经此协议,见 [图像 / 视频 / 音乐 API](../reference/media-apis.md)。

## 注意事项

### Composer / Agent / Tab autocomplete 走 Cursor 私有服务

- **Cursor Chat 聊天框** —— ✅ 走你配置的 Custom Base URL (本平台)
- **Composer (Cmd+I)** —— ❌ 走 Cursor 自家服务,不经过本网关
- **Tab autocomplete** —— ❌ 同上
- **Agent (Cmd+Shift+I)** —— ❌ 同上

如果你希望整个 Cursor 全走本网关,目前**没有官方支持**。Cursor 把上述功能跟订阅绑定。

### 推荐用法

| 场景 | 选择 |
|---|---|
| 长对话 / 复杂任务 | Cursor Chat (走本网关,模型选 Claude / GPT-5.x) |
| 短补全 / inline edit | 用 Cursor 原生 (订阅内) |
| 完整 AI Coding 走本网关 | 用 [FlopCode](./flopcode.md) 或 [Cline](./cline.md) |

## 常见问题

| 现象 | 排查 |
|---|---|
| Verify fail,但 URL 和 Key 都正确 | Cursor 默认启用的内置 OpenAI 模型(`gpt-4o` 等)不在模型目录 → 网关返回 `model_not_found`。关闭内置模型,仅启用已 Add 的 model ID 后再 Verify |
| Verify fail,连接不通 | Base URL 拼写;`/v1` 不能少 |
| 模型不在 dropdown | 必须先 **Add Model** 手动添加 model ID |
| `401`(`invalid_api_key`) | Key 无效 / 已吊销 / 已过期。检查是否复制完整(`sk-gpushare-` + 64 位十六进制);完整 Key 可随时在 [控制台 Key 详情页](https://zhonkezhonkemodel.dflop.top/dashboard/keys) 重新查看 |
| `400`(`model_not_allowed`) | 这把 Key 设置了模型白名单(allowed_models),不含当前模型 → 去 [控制台](https://zhonkezhonkemodel.dflop.top/dashboard/keys) 编辑白名单或换一把无限制的 Key |
| `402`(`insufficient_quota`,code `quota_exceeded`) | 账户余额耗尽。所有 Key 共享同一余额,新建 Key 不能解决 → 去 dflop.top/dashboard/billing 充值(Stripe,最低 $1) |

错误码完整说明见 [错误处理](../reference/errors.md)。

## 其他客户端

- [Claude Code](./claude-code.md) — 命令行 AI 编程
- [Cline (VS Code)](./cline.md) — 完整走 Custom Base URL
- [Continue.dev](./continue.md) — VS Code / JetBrains
- [Open WebUI](./open-webui.md) — 自托管 ChatGPT 界面
- [FlopCode](./flopcode.md) — 本平台官方 fork