SupaStore

返回博客列表

Cursor 中转 API 怎么配置？Cursor 自定义 API Key 与 Base URL 教程

Cursor 中转 API 怎么配置？本文一步步完成 Cursor 自定义 API Key 与 Override OpenAI Base URL 设置，通过 API中转站在 Cursor 中使用 Claude、DeepSeek 等模型，并附验证命令、模型选择与常见报错排查。

SupaStore 开发者体验组 ·

Cursor 中转 API 怎么配置？Cursor 自定义 API Key 与 Base URL 教程

Cursor 中转 API 的做法很简单：在 Cursor 里填入 API中转站提供的 API Key，再把 OpenAI Base URL 改成中转站地址，就能在 Cursor 中按 Token 用量调用 claude-sonnet-4-6、deepseek-v4-pro 等模型。

本文用 SupaStore 演示完整的 Cursor 中转站配置流程，包括创建专用 Key、Cursor 自定义 API 设置、配置验证、模型选择和常见报错排查。还没选好服务商的话，可以先看《API中转站是什么？AI中转站选型避坑指南》。

Cursor 中转 API 适合谁

  • 想按量付费的人：用多少 Token 付多少钱，不受订阅里固定次数的限制。
  • 想用更多模型的人：一个 Key 就能在 Cursor 中切换 Claude、GPT、DeepSeek、Qwen 等模型。
  • 团队管理成本的人：给每个成员或项目单独发 Key、设置额度，消耗在日志里一目了然。

Cursor 走的是 OpenAI 兼容协议，所以任何提供 OpenAI 兼容接口的 API中转站都可以接入，关键在于 Base URL 和模型 ID 填写正确。

第一步：在 API中转站创建 Cursor 专用 Key

  1. 登录 SupaStore，进入控制台的【令牌管理】，点击【添加令牌】。
  2. 名称填写 cursor，方便在日志里区分来源。
  3. 限制可用模型：只勾选你打算在 Cursor 中使用的模型。
  4. 设置额度上限：Cursor 的 Agent 模式会自动读取大量文件，给 Key 设置上限可以防止意外账单。
  5. 复制生成的 sk- 开头的密钥。

第二步：Cursor 自定义 API Key 与 Base URL 设置

  1. 打开 Cursor，点击右上角齿轮进入 Cursor Settings，选择左侧的 Models。
  2. 找到 OpenAI API Key，填入刚才复制的密钥。
  3. 打开 Override OpenAI Base URL，填写 API中转站地址：
https://api.supastore.cc/v1
  1. 点击 + Add model，添加要使用的模型 ID，例如 claude-sonnet-4-6、deepseek-v4-pro，并确认它们处于开启状态。
  2. 关闭 Using Cursor Subscription 开关，确保请求走你的自定义 Key。

注意：Base URL 必须以 /v1 结尾，末尾不要多加 /。这是 Cursor 中转配置最常见的错误。

带截图的逐步说明见文档《Cursor 编辑器接入》。

第三步：验证 Cursor 中转是否生效

先用 cURL 验证 Key 和模型

在 Cursor 里排查问题比较麻烦，建议先在终端确认 Key 和模型 ID 都可用：

curl https://api.supastore.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-supastore-api-key" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Ping"}]
  }'

返回 JSON 中有 choices 字段即表示中转站可用。

再在 Cursor 中测试

打开任意代码文件，按 Cmd + K（Windows 为 Ctrl + K），选择刚添加的模型并输入一个简单需求。代码能流式生成、没有报错，就说明 Cursor 中转 API 已经生效。回到控制台的使用日志，可以看到这次请求的 Token 数和扣费。

Cursor 中转选什么模型

下面是 2026-10-29 模型广场中适合 Cursor 的几个模型（每百万 Token，USD，默认分组），实时价格以模型广场为准：

场景 模型 ID 输入 缓存输入 输出
复杂编程、重构、Agent 任务 claude-sonnet-4-6 $0.9 $0.09 $4.5
通用编程与问答 gpt-5.6-luna $1 — $6
算法、推理类问题 deepseek-v4-pro $0.348 — $0.696
写注释、改格式、简单补全 deepseek-v4-flash $0.05 $0.01 $0.1

如果你看到的是"倍率"而不是美元单价，可以用《API中转站倍率是什么意思？》里的公式换算成每百万 Token 的价格再比较。

Cursor 使用中转 API 常见报错

现象 常见原因 处理方法
Invalid API Key / 401 密钥多了空格，或 Key 已被删除 重新复制密钥，先用 cURL 验证
保存 Base URL 时报错 地址末尾多了 /，或缺少 /v1 严格填写 https://api.supastore.cc/v1
模型不存在 / 400 模型 ID 拼写错误，或 Key 未勾选该模型 在模型广场核对 ID，检查 Key 的可用模型
余额不足 / 402 钱包余额或 Key 额度用完 充值或调高该 Key 的额度上限
频繁 429 并发过高 减少同时运行的 Agent 任务，稍后重试

更完整的排查步骤见常见问题排查。

用 Cursor 中转 API 如何省钱

  • 用 .cursorignore 排除无关文件：node_modules、dist、日志和数据文件不应进入上下文。
  • 长对话及时新开：对话越长，每轮携带的历史越多，输入 Token 随之增长。
  • 按任务难度切换模型：简单改动用 deepseek-v4-flash，复杂重构再切到 claude-sonnet-4-6。

更多成本优化方法见《2026 主流大模型价格对比与 API 成本优化指南》。

常见问题 (FAQ)

Q: Cursor 中转 API 后，所有功能都走自定义 Key 吗？

答： 不一定。对话和 Cmd + K 这类功能会使用你配置的模型，但 Cursor 的部分内置功能（例如 Tab 自动补全）使用 Cursor 自己的模型，不经过自定义 Key。具体以你使用的 Cursor 版本为准。

Q: 可以把 Base URL 填成本地代理地址吗？

答： 通常不行。Cursor 的请求会经过它自己的服务端再发往 Base URL，所以地址必须能从公网访问，localhost 或内网地址无法使用。

Q: Cursor 和 Claude Code 能共用一个 API中转站吗？

答： 可以，同一个 API中转站同时支持 OpenAI 兼容接口和 Claude 原生接口。建议为两个工具分别创建 Key，方便区分消耗。Claude Code 的配置方法见《Claude API 中转怎么用？Claude Code 中转站配置教程》。