主题
Cursor 接入与兼容性说明
Cursor 官方支持为 OpenAI、Anthropic、Google、Azure OpenAI 和 AWS Bedrock 填写自有 API Key，但当前官方帮助页没有把任意 OpenAI Compatible Base URL 列为稳定支持能力。
最近核验：2026-10-23。Override OpenAI Base URL 仍是全局开关且存在已知限制，本页仍不把 Cursor 直连 Zivv 描述为官方保证功能。
当前结论
| 能力 | 官方支持状态 | Zivv 建议 |
|---|---|---|
| 填写官方 Provider 的 API Key | 支持 | Zivv Key 不是 OpenAI 官方 Key，不能等同处理 |
| 任意 OpenAI Compatible Base URL | 当前官方帮助页未承诺 | 仅在界面确实提供 Override Base URL 时做兼容性测试 |
| Chat 模型使用自有 Key | 支持 | 基础对话可能可用 |
| Tab Completion | 不使用自有 Key | 继续使用 Cursor 内置模型 |
| Agent、Composer 和后台能力 | 可能依赖 Cursor 服务 | 不保证经自定义接口工作 |
需要稳定接入 Zivv 时，优先使用 Codex CLI、Claude Code 或 OpenAI SDK。
官方 BYOK 配置
Cursor 当前官方流程是：
- 打开 Cursor Settings。
- 进入 Models。
- 在 API Keys 中找到官方列出的 Provider。
- 粘贴该 Provider 签发的 Key，并执行验证。
官方说明还包括：
- 自有 Key 只用于标准 Chat 模型
- Tab Completion 仍使用 Cursor 内置模型
- 请求会经过 Cursor 后端完成最终 Prompt 组装
- 使用自有 Key 时，Cursor 的 Zero Data Retention 政策不适用，数据处理遵循所选 Provider 的政策
实验性：界面出现 Override Base URL 时
目前 Cursor 的 Settings → Models 中仍提供 Override OpenAI Base URL，但它是一个全局开关，官方帮助页也没有把它列为通用兼容能力。它只适合验证基础 Chat，不建议依赖它运行生产或关键 Agent 工作流。
如果当前界面明确提供该选项，可测试：
| 配置项 | 值 |
|---|---|
| OpenAI API Key | Zivv Key |
| Override OpenAI Base URL | https://zivv.pro/v1 |
| Model | 模型广场中的完整模型 ID |
配置后只先测试普通 Chat，并在 用量日志 核对请求。不要假定 Tab、Agent、Composer、索引或后台功能都会切换到 Zivv。
已知限制：
- 全局生效：开启后，选择 Cursor 订阅内的 OpenAI 系模型时请求也可能发往自定义地址；需要使用订阅模型时，先关闭 Override 再切换
- 图片请求：自定义端点下的视觉（图片）请求可能失败，Cursor 已在论坛确认该问题
- Key 按模型名匹配：Cursor 会根据模型名前缀选择发送哪个已保存的 Key，模型名以
claude-开头时可能不走 OpenAI Override - 团队账号：团队管理员可能需要先允许 OpenAI BYOK
升级后可能失效
Cursor 可在版本更新中调整设置入口、验证逻辑或自定义端点行为。每次升级后都要重新验证；如果界面没有 Override Base URL，请不要通过修改内部数据库或非公开配置强行启用。
常见问题
Key 验证失败
Cursor 可能使用官方 Provider 的验证逻辑，拒绝第三方 Key。此时不能据此判断 Zivv Key 无效，先用 cURL 最小请求 验证，再改用受支持客户端。
Chat 可用，但 Agent 不可用
这通常是 Cursor 自定义 Key 的能力边界，而不是 Base URL 拼写问题。Agent 可能需要特定模型、Responses API、工具调用或 Cursor 自有服务。
请求路径出现 /v1/v1
只有在当前版本确实允许 Override Base URL 时，才根据实际请求日志调整。推荐值是 https://zivv.pro/v1；不要填写完整的 /chat/completions 端点。
隐私和密钥
Cursor 官方说明，请求会携带 Key 经过 Cursor 后端。不要把高权限生产 Key 用于 Cursor；应创建独立 Key，设置额度、有效期和模型范围。