在 Cursor 里用自定义 API 接入 Claude 与 GPT

Cursor 是很多人主力使用的 AI 代码编辑器，而它对进阶用户最有用的能力，藏在设置里：你可以用自定义 API Key 加自定义 Base URL，在 Cursor 里接入 Claude、GPT-5 或任何你想用的模型，而不必被内置供应商绑死。这篇教程把 Cursor 设置里的每一步都写清楚——照着做，就能把 ApiTopMix 添加为自定义供应商，让 Cursor 跑在 Claude 和 GPT 上，成本完全自己掌控。

为什么要折腾 Cursor 自定义 api（也就是 BYOK，自带 Key）？两个原因。其一是成本可控：按 Token 用自己的账户计费，而不是被打包套餐限量。其二是模型自由：一个 Key 就能覆盖 Claude 全系加 GPT-5 等模型，在 Cursor 的模型下拉里随手切换，不用改任何配置。ApiTopMix 在 https://apitopmix.com/v1 提供 OpenAI 兼容网关，这正是 Cursor 打开 Override OpenAI Base URL 时期望的格式。

你能得到什么

动手之前，先说清楚把 Cursor 接到 ApiTopMix 之后，到底拿到了哪些实际好处。

准备工作

打开 Cursor 设置之前，先确认你手上有这几样东西：

• 装好并更新过的 Cursor——Models 设置面板和 Base URL 覆盖开关都在里面。
• 一个 ApiTopMix 账号和一把以 sk- 开头的 API 密钥（下面第 0 步就去拿）。
• 一个要添加的模型名，例如 claude-sonnet-4-6、claude-opus-4-6 或 gpt-5——只要是 ApiTopMix 上可用的模型都行。

清单就这些。不用本地代理、不用改配置文件，全部在 Cursor 的设置界面里完成，外加粘贴一次密钥。

第 0 步：拿到 ApiTopMix 密钥

这一把 sk- 密钥，就是接下来整套 Cursor 自定义 api key 配置唯一需要的凭证。

在 Cursor 里把 ApiTopMix 添加为自定义供应商

这一段是全文的核心——完整的 Cursor 自定义 api key 配置流程，我会像对着屏幕一样一步步讲。Cursor 各版本的措辞会略有出入，但结构始终一样：一个 Models 面板、一个 OpenAI 一栏、一个 Base URL 覆盖开关、一个密钥输入框，以及一个自定义模型列表。

下面把整套配置整理成可复制的对照表——把这三个值填进 Cursor 的 Models 设置对应字段即可：

# Cursor 设置 → Models → OpenAI API Key
Override OpenAI Base URL:  https://apitopmix.com/v1
OpenAI API Key:           sk-你的ApiTopMix密钥
Custom model(s):          claude-sonnet-4-6   # 也可加 claude-opus-4-6、gpt-5

先用 cURL 验证端点

在把锅甩给 Cursor 之前，先单独确认密钥和 Base URL 本身是通的。用一条 cURL 打一下 OpenAI 兼容端点——只要它能返回正常的对话结果，Cursor 那边也一定能通：

curl https://apitopmix.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的ApiTopMix密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好，帮我确认 Cursor 接入是否成功"}]
  }'

返回一段正常的 JSON 回复，就同时证明了三件事：你的 sk- 密钥有效、https://apitopmix.com/v1 这个 base url 可达、你填的模型 ID 存在。这样一来，下面的 Cursor 排错会快很多，因为密钥、URL 和模型名都已经排除嫌疑了。

Cursor 里推荐用哪些模型

接好 ApiTopMix 后，你可以添加多个自定义模型，在 Cursor 下拉里按任务切换。实用的分法如下：

这些模型都在同一个 ApiTopMix 密钥和同一个 Base URL 之下，所以加一个模型只是在 Cursor 自定义模型列表里多填一行——不用第二个供应商、不用第二把 Key。各模型的实时单价、可用型号见 价格页，准确的模型 ID 和接口细节见 API 文档。特别在意成本？可以看看我们的 便宜的 Claude API 专题。

Cursor 常见报错排查

Cursor 接自定义供应商出问题的情形其实屈指可数。下面这张表把每个现象对应到解决办法：

Cursor 与 Claude Code CLI 的区别

这篇专讲 Cursor。如果你也常泡在终端里，Claude Code CLI 是用自定义端点跑 Claude 的另一条路——但它的配置方式完全不同（走 ANTHROPIC_BASE_URL 环境变量和 Anthropic 原生协议，而不是覆盖 OpenAI Base URL）。两者互补：编辑器里用 Cursor，命令行里用 Claude Code。

• Cursor——OpenAI 兼容：把 Base URL 覆盖为 https://apitopmix.com/v1，添加自定义模型。（你正在看这篇。）
• Claude Code CLI——Anthropic 原生：设置环境变量后运行 claude。具体见我们的 Claude Code 接入教程。

同一把 ApiTopMix 密钥两边通用，接一个、接另一个，或两个都接都行。

常见问题

结语

在 Cursor 里用自己的 API Key 接入 Claude，归根结底就是一个设置：Override OpenAI Base URL。把它指向 https://apitopmix.com/v1，粘贴 ApiTopMix 密钥，添加一个像 claude-sonnet-4-6 或 gpt-5 这样的自定义模型，Cursor 的对话和编辑就跑在你掌控的模型和账单上。记住把 Base URL 填准、只加真实模型 ID，验证卡住时用 cURL 自检，基本就没什么坑了。

配置一次，Cursor 就成了 ApiTopMix 各模型的前端——日常用 Sonnet、难题上 Opus、需要第二意见时切 GPT-5，全在一个 Key 之下。等你转到终端，同一把 Key 还能驱动 Claude Code CLI，让编辑器和命令行保持一致。有任何接口细节，随时回 文档查阅。