简短答案
在 Cursor 中配置自定义 OpenAI-compatible API，核心是三项：API Key、Base URL、Model ID。 API Key 用于鉴权，Base URL 决定请求发往哪个 provider，Model ID 决定使用哪个模型。三者必须来自同一个 provider 或兼容网关。什么时候需要它
- 你想在 Cursor 中使用第三方 OpenAI-compatible provider
- 你需要填写 Override OpenAI Base URL
- 你要添加 custom model
- 你遇到模型不存在或认证失败
- 你想让 Cursor、Codex 等工具共用同一个模型出口
字段说明
推荐做法
- 在 provider 后台创建 API Key。
- 在 Cursor 的模型设置中填写 API Key。
- 在 Override OpenAI Base URL 中填写 provider 的 Base URL。
- 添加或选择当前 provider 支持的 Model ID。
- 保存后用一个简单请求验证。
常见误区
- API Key 来自 A provider，Base URL 却填 B provider。
- 把 Claude 模型名填进 OpenAI-compatible 配置。
- 使用网页展示名，而不是 API model ID。
- 以为 Cursor Rules 会影响 API 鉴权。
- 全局 override 后忘记其他 OpenAI 模型也会受影响。
关于 BetterToken
Cursor 这类外部工具通常走 OpenAI-compatible 接入。BetterToken 的 Base URL 是https://www.bettertoken.ai/v1，模型 ID 从模型广场的 GPT 分组复制。
不要把 Claude Code 使用的 https://www.bettertoken.ai 填进 Cursor 的 OpenAI-compatible 配置。
Related docs
- Cursor Rules、AGENTS.md 和 .cursorignore 是什么？
- Cursor 如何配置 MCP？
- OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？
- Codex CLI 中 model_provider、base_url 和 wire_api 是什么？