极智时代

Cursor 接入中转 API 教程：自定义 Base URL 配置

在 Cursor 的 Settings → Models 中配置自定义 API Key 与 Base URL，即可用站内密钥调用 Claude / GPT / Gemini 模型。

一、Cursor 是什么

Cursor 是基于 VS Code 构建的 AI 原生代码编辑器，深度集成 AI 对话（Chat）、代码生成（Composer/Chat）与智能补全。它支持 BYOK（Bring Your Own Key），即用自己的 API Key 连接自有的模型端点，适合不想购买官方订阅、或想统一切换到某个模型的场景。

接入中转后，你可以在不购买 Cursor 官方订阅的情况下，用站内 sk- 密钥按 token 计费使用 Claude / GPT / Gemini 模型。

二、准备工作

  1. 登录极智时代控制台，在「API 密钥」中生成专属 sk-xxxxxx 密钥。
  2. 在「模型定价」确认要使用的模型 slug（如 claude-sonnet-5、gpt-5.4、gemini-3.7-flash）。
  3. 确认网关地址：https://www.azztimes.com。

三、在 Cursor 里配置

打开 Cursor → Settings → Models → API Keys（或直接在设置里搜 Models）：

  1. 选择要接的模型供应商（OpenAI 走 Open AI 项，Claude 走 Anthropic 项，Gemini 走 Google Gemini 项）。
  2. 填入 API Key：sk-你的密钥。
  3. 填入 Override Base URL：按所选供应商填对应网关入口。
    • Claude / Anthropic：https://www.azztimes.com
    • GPT / OpenAI：https://www.azztimes.com/v1
    • Gemini：https://www.azztimes.com/v1beta
  4. 在 Models 列表中添加要用的精确模型 ID（从模型广场复制 slug，不要写展示名）。
  5. 点击 Verify 验证连接；再用一次普通 Chat 发送一条短文本，确认返回正常。

四、验收与排错

现象处理
401 / 403密钥无效、未启用或余额不足；确认 sk- 正确并充值。
404 / 模型不可用模型 slug 与平台不一致，或该模型未启用；核对模型 ID。
Verify 通过但 Agent 失败区分 /chat/completions 协议差异，用普通 Chat 先验收基础连通。
Tab 补全不出字Tab Completion 等专用功能仍使用 Cursor 内置模型，这是产品边界，不属于 Base URL 配置问题。

安全建议：密钥不要提交到公开仓库，建议每个项目单独建一个 Key，并留意余额与用量明细。