Cursor API接入说明：自定义模型配置与代理兼容性

核心配置步骤与原理

在 Cursor 中使用自定义模型，核心是在 Settings → Models 界面添加模型名称，然后在 API Key 栏填入自己的密钥，并将 Override OpenAI Base URL 改为实际 API 地址。这个流程兼容 OpenAI、Anthropic 等主流格式，也支持通过中转服务实现代理兼容性——即使用第三方 API 地址来调用其他模型。下面说明具体接入方法。

自定义模型配置的详细操作

1. 打开 Cursor 设置（快捷键 Cmd/Ctrl + ,），进入 Models 标签页。
2. 点击「Add Model」，输入你要使用的模型名称（例如 gpt-4o、claude-sonnet-4-6）。注意名称需与 API 服务商提供的完全一致。
3. 在「OpenAI API Key」字段填入你的 API 密钥。如果是使用 Anthropic 兼容接口，同样在此处填写。
4. 勾选「Override OpenAI Base URL」，填入你实际调用的 API 端点。例如，使用简易API或自建中转服务时，填入其提供的地址（如 https://api.jeniya.cn/v1）。
5. 点击「Save」后，Cursor 会验证连接。成功即可在 Chat/Tab 中选择该模型使用。

代理兼容性说明

默认情况下 Cursor 只连接官方 OpenAI 端点。要实现代理兼容性——即接入其他服务商或自建网关——核心是修改上面的 Base URL。开源项目如 cursor2api 就通过将 Cursor 免费 API 转换为 OpenAI/Anthropic 兼容格式，允许开发者托管自己的代理服务。第三方平台如简易API也直接提供兼容的地址，支持 Gemini、Deepseek 等模型，无需额外配置。关键在于确认目标服务返回的格式与 OpenAI 一致。

注意事项与常见问题

第一，API 密钥需保管好，不要泄露到公开仓库。第二，如果模型名称填写错误，Cursor 会显示连接失败，此时检查官方文档中的模型 ID。第三，免费额度方面，一些中转服务提供试用（如简易API注册即送美金额度），但具体数额需查阅服务商规则。第四，若使用自建代理，确保服务器能稳定访问外部网络，并且域名已备案或合法接入。

进阶建议

对于团队使用，可统一搭建 API 网关，通过同一个 Base URL 和不同模型名称分发请求。Cursor 的 Override 机制天然支持这种架构。另外，如果想用 Cursor 最新组合模型（如 Agent 模式），需确保代理服务支持流式响应和工具调用。遇到问题可参考 Cursor 官方文档的故障排除指南，或检查网络连接日志。