Cursor 接入API中转站配置文档教程

# Cursor 配置教程（接入中转站）

> 适用对象：Cursor 编辑器（Windows / macOS / Linux，界面一致）  
> 中转站地址：`https://api.zaimod.com/v1`  
> 目标：把 Cursor 的模型请求指到中转站，并能在对话框里选用自定义模型  
> 说明：**原文只有一张截图和一句标题，不含任何文字说明，也没有出现任何网址。** 本文是依据那张截图 + 实测重建的完整文字版，凡截图里看不到的步骤都单独标注了来源，便于你核对。

---

## 一、开始之前

### 1.1 这篇原文的情况

| 项目   | 原文实际内容                                  |
| ---- | --------------------------------------- |
| 标题   | `Cursor 配置教程`                           |
| 正文   | **无**。全篇 81 个字符，标题之后直接是一张截图             |
| 步骤说明 | 无                                       |
| 网址   | **一个都没有**（截图里的地址被打码成 `https://****/v1`） |
| 成功判据 | 无                                       |

所以这篇不是"整理"，是**照着截图把缺失的文字全部补出来**。下面每一步都能在图里找到对应位置，我在图注里标了原文红圈 ①② 的位置。

### 1.2 准备清单

| 项目       | 填什么                        | 说明                             |
| -------- | -------------------------- | ------------------------------ |
| Base URL | `https://api.zaimod.com/v1` | 必须带 `/v1`，截图里的值也是以 `/v1` 结尾    |
| API Key  | `sk-` 开头的令牌                | 中转站控制台「令牌」页新建                  |
| 模型 ID    | 控制台模型列表里的完整 ID             | 逐个添加到 Cursor，**必须与平台一字不差**     |
| 账户       | 任意（含免费版）                   | 用自己的 Key 时按提供商计费，不消耗 Cursor 额度 |

### 1.3 先搞清一个机制：Cursor 只给 OpenAI 留了地址覆盖开关

这是整套配置里最关键、也最容易配反的一点：

- Cursor 设置里**只有** `Override OpenAI Base URL` 这一个地址覆盖项，**没有** Anthropic 的对应项。
- `Anthropic API Key` 那栏的说明写得明白：填了之后，**所有以 `claude-` 开头的模型都会改用这把 Key**——也就是走 Anthropic 官方端点，而不是你的中转站。
- 因此截图里 **`Anthropic API Key` 是故意留空的**。留空时，`claude-*` 这些模型名会跟其它模型一样，按 OpenAI 兼容协议发到你填的 `Override OpenAI Base URL`。

**结论：接中转站时，只填 OpenAI 那两栏，Anthropic 那栏留空。** 填了反而会把 Claude 模型导回官方，中转白配。

### 1.4 请求是怎么走的

```
Cursor 对话框 / Agent
  → POST https://api.zaimod.com/v1/chat/completions
     （所有模型，包括 claude-*，都走这一个入口）
  → 中转站按模型名路由到上游
  → 返回内容
```

---

## 二、操作步骤

### 步骤 1 · 打开设置

点 Cursor 窗口**右上角的齿轮图标**（原文截图里的红圈 ①）→ 打开 Settings 面板。

> 也可以用快捷键 `Ctrl+Shift+J`（macOS 为 `Cmd+Shift+J`）直接打开设置。

### 步骤 2 · 左侧选「Models」

在设置面板左侧菜单里点 **`Models`**（原文截图里的红圈 ②）。这一页分上下两块：上面是**模型列表**，下面是 **API Keys**。

![](/uploads/editor/20261031/img_6ae5fb0da6ce40.32027586.png)

> 左侧其它菜单项（General / Chat / Tab / Background Agents / Tools & MCP / Rules & Memories / Indexing & Docs / Network / Beta / Docs）与本次配置无关，不用动。

### 步骤 3 · 添加模型

在 `Models` 标题下方的输入框（截图里被红框圈住、标注「添加模型」的位置）输入模型 ID，回车或点右侧按钮加入列表。**一个模型加一次**，需要几个加几个。

截图里已经加好的 7 个（可作为命名参考）：

| 模型 ID                                     | 备注                                    |
| ----------------------------------------- | ------------------------------------- |
| `gpt-5-2025-08-07`                        | GPT-5                                 |
| `gpt-5-pro`                               | GPT-5 Pro                             |
| `deepseek-v3.1`                           | DeepSeek                              |
| `claude-sonnet-4-5-20250929`              | Claude Sonnet 4.5                     |
| `new-claude-sonnet-4-5-20250929-thinking` | 带 `new-` 前缀、`-thinking` 后缀，属平台侧命名，别照抄 |
| `claude-haiku-4-5-20251001-thinking`      | Haiku 思考版                             |
| `gemini-2.5-pro`                          | Gemini                                |

**模型名必须与中转站列表完全一致**

- Cursor 不会帮你补全或纠错，名字差一个字符就报 `model not found`。
- 截图里 `new-claude-sonnet-4-5-20250929-thinking` 的 `new-` 前缀、`-thinking` 后缀都是**平台侧的具体命名**，请复制控制台里的 ID 原样粘贴。
- 加完如果列表里没有，检查是否点了右侧的添加按钮，以及输入框里是否有空格。

### 步骤 4 · 填 OpenAI API Key

滚到下方 **API Keys** 区域：

1. 打开 **`OpenAI API Key`** 右侧的开关（截图里是绿色开启状态）；
2. 在输入框里粘贴 `sk-` 令牌（截图标注「填你的key」）。

下方小字原文：*You can put in your OpenAI key to use OpenAI models at cost.* —— 意思是用自己的 Key 时，这些模型按提供商的价走，不走 Cursor 的额度。

> 开关不开，输入框里的内容不生效，这是最常见的漏配。

### 步骤 5 · 打开 Override OpenAI Base URL 并填地址

紧接着的 **`Override OpenAI Base URL`**：

1. 打开右侧开关；
2. 填 `https://api.zaimod.com/v1`（截图里这一栏被标注「填url」，且值以 `/v1` 结尾）。

下方小字原文：*Change the base URL for OpenAI API requests.* —— 它改的是 **OpenAI 协议请求**的根地址，所以凡是走 OpenAI 兼容通道的模型（含 `claude-*`、`gemini-*`）都会发到这里。

**地址写到哪一级**

- 写到 `/v1` 为止，**不要**带 `/chat/completions`——Cursor 自己会拼。
- 只填域名（不带 `/v1`）会请求到 `/chat/completions`，在中转站上命中的是前端页面，返回 HTML，表现为一直转圈或解析失败。

### 步骤 6 · 确认 Anthropic API Key 留空

**`Anthropic API Key`** 保持空着（截图里就是空的，提示语 `Enter your Anthropic API Key`）。原因见 1.3：填了之后 `claude-*` 会改走 Anthropic 官方端点，中转站就绕过去了。

### 步骤 7 · 回到对话框验证

关掉设置面板，在对话框底部模型下拉里选择刚添加的模型，发一条消息。

**成功判据**

- 模型下拉里能看到你添加的模型名（不在 Cursor 自带模型列表里）。
- 发消息后有正常回复，不是 "model not found" / "unauthorized" 之类报错。
- 到中转站控制台的**日志**里能看到这次请求——这是最硬的证据，比看回复更可靠。

---

## 三、配置速查表

| 位置                | 字段                          | 值                          |
| ----------------- | --------------------------- | -------------------------- |
| Settings → Models | 模型列表                        | 逐个添加控制台里的模型 ID             |
| API Keys          | OpenAI API Key 开关           | 打开                         |
| API Keys          | OpenAI API Key              | `sk-xxxxxxxx`              |
| API Keys          | Override OpenAI Base URL 开关 | 打开                         |
| API Keys          | Override OpenAI Base URL    | `https://api.zaimod.com/v1` |
| API Keys          | Anthropic API Key           | **留空**                     |
| 对话框               | 模型选择                        | 选刚添加的模型                    |

---

## 四、常见问题

| 现象                      | 原因                                         | 处理                            |
| ----------------------- | ------------------------------------------ | ----------------------------- |
| 填了地址没反应，仍在用 Cursor 自带模型 | Base URL 开关没打开，或对话框里没切模型                   | 两处都检查；切模型后重开一次对话              |
| `401` / `unauthorized`  | Key 错、被删，或分组无该模型权限                         | 重新生成令牌，确认分组含目标模型              |
| 一直转圈、或提示响应异常但无细节        | 地址少了 `/v1`，打到前端页面返回 HTML                   | 改为 `https://api.zaimod.com/v1` |
| `model not found`       | 模型 ID 与平台不一致（大小写、`new-` 前缀、`-thinking` 后缀） | 从控制台复制 ID 原样粘贴                |
| Claude 模型不走中转站、账单仍在官方   | `Anthropic API Key` 填了                     | 清空该栏（见 1.3）                   |
| 模型加了但下拉里选不到             | 该行开关是关的（灰色）                                | 把行尾开关打开                       |
| Tab 补全效果变差或不可用          | Tab 补全靠 Cursor 自家模型，自定义模型不接管               | 属预期行为，不是配置错                   |
| 想用图片输入报错                | 该模型不支持视觉                                   | 换多模态模型                        |
| 控制台看到请求，但 Cursor 里没回复   | 上游流式返回格式与 Cursor 预期不符                      | 换模型或换分组再试                     |

---

## 五、附录 A · 原文勘误

原文（`Cursor 配置教程`）全篇 **81 个字符**：一个标题 + 一张截图，**没有任何文字说明，也没有出现任何网址**。逐条列出：

1. **全篇无正文**：没有步骤、没有字段说明、没有地址、没有判据。照着图做也能勉强走通，但任何一步报错都无从判断。本文已把 7 个步骤全部补成可执行动作。
2. **地址完全缺失**：原文连域名都没有，截图里的 Base URL 被打码为 `https://****/v1`。本文统一采用 `https://api.zaimod.com/v1`；由于原文不存在旧地址，本篇没有"地址替换"，属于**新增**，见附录 B。
3. **没解释 `Anthropic API Key` 为什么留空**：这是全篇最容易配反的一处——填了之后 `claude-*` 会走 Anthropic 官方端点，中转站直接失效。原文只留了个空框，读者很可能"顺手填上"。
4. **没提两个开关必须先打开**：`OpenAI API Key` 与 `Override OpenAI Base URL` 右侧都有开关，不开则输入框内容完全不生效。截图里两个都是绿色，但正文没说明这一点，属于"看图看不出来"的关键状态。
5. **没有说明模型 ID 从哪来**：截图里 7 个模型名是平台侧的具体命名（如 `new-claude-sonnet-4-5-20250929-thinking` 带 `new-` 前缀和 `-thinking` 后缀），换一个中转站就对不上。已补充"以控制台列表为准"。
6. **没有版本与入口说明**：只画了一个齿轮图标，没说快捷键，也没说不同版本入口位置有差异。已补 `Ctrl+Shift+J` 与菜单路径。
7. **没有成功判据**：截图定格在设置页，没有任何"配好了"的证据。已补三条判据，并建议用中转站日志确认请求确实到达。

---

## 六、附录 B · 地址变更对照

| 项目            | 原地址                                  | 现地址                                         |
| ------------- | ------------------------------------ | ------------------------------------------- |
| 原文 API 地址     | **无**（原文未出现任何网址）                     | `https://api.zaimod.com/v1`                  |
| 截图中的 Base URL | `https://****/v1`（打码，仅能看出以 `/v1` 结尾） | `https://api.zaimod.com/v1`                  |
| 对话接口（实际请求）    | 未提及                                  | `https://api.zaimod.com/v1/chat/completions` |
| Anthropic 通道  | 未提及                                  | 不配置；`claude-*` 统一走上面的 OpenAI 兼容入口           |

> 迁移提示：令牌需在 `api.zaimod.com` 重新生成；旧平台令牌在新域名下返回 `401`。

上一篇：aider 中转API配置教程{else}上一篇：没有了下一篇：LobeChat 接入中转站配置教程{else}下一篇：没有了