Cline 接入中转站配置指南

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

> 适用对象：VS Code 的 Cline 扩展（也适用于 Cline 桌面端 / JetBrains 版，界面基本一致）  
> 中转站地址：`https://api.zaimod.com`  
> 目标：用「OpenAI Compatible」提供商接入中转站，让 Cline 能正常读写文件、执行命令  
> 前提：所选**分组必须支持函数调用（Function Calling）**，否则 Cline 只会把代码贴在聊天里，不会真的建文件

---

## 一、开始之前

### 1.1 准备清单

| 项目           | 应该填什么                      | 说明                                         |
| ------------ | -------------------------- | ------------------------------------------ |
| API Provider | **OpenAI Compatible**      | Cline 里专给第三方兼容接口用的选项，不是 OpenAI             |
| Base URL     | `https://api.zaimod.com/v1` | **必须带 `/v1`**，见 1.2                        |
| API Key      | `sk-` 开头的令牌                | 中转站控制台「令牌」页新建                              |
| Model ID     | 控制台模型列表里的完整 ID             | 原文示例 `claude-3-5-sonnet-20241022` 已过时，按实际填 |
| 令牌分组         | 选**支持函数调用**的分组             | 见 1.3，这是 Cline 能不能干活的关键                    |

### 1.2 Base URL 必须带 `/v1`

原文只写了「API地址填写 + 域名」，是纯域名。但 Cline 的 OpenAI Compatible 提供商**不会自动补版本段**，它把 Base URL 原样交给 OpenAI SDK，SDK 只在后面拼 `/chat/completions`。官方文档里 v0 的示例就是 `https://api.v0.dev/v1`。

两种写法实测结果：

| Base URL 填写                  | 实际请求                                        | 结果                                              |
| ---------------------------- | ------------------------------------------- | ----------------------------------------------- |
| `https://api.zaimod.com`      | `https://api.zaimod.com/chat/completions`    | 返回 **200 + HTML 页面**（命中了站点前端），Cline 报解析失败 / 无响应 |
| `https://api.zaimod.com/v1` ✅ | `https://api.zaimod.com/v1/chat/completions` | 返回 **401 Invalid token**，说明路径正确、只差鉴权            |

**记法**：Cline 这一栏的要求和 Dify 一样——填到 `/v1` 为止，不要带 `/chat/completions`。

### 1.3 分组必须支持函数调用（原文唯一的注意事项，也是最容易翻车的地方）

原文那句「只有纯AZ、官转克劳德2、官转克劳德3、直连克劳德分组支持函数调用，才能用这个模型」说的是实话，但用的是**旧平台的分组命名**。在新平台上分组名不同，把握原则即可：

- **必须选支持 Function Calling 的分组。** Cline 是 Agent，它靠工具调用去读写文件、跑命令，不是靠把代码贴在聊天里让人复制。
- **不支持函数调用的分组（如普通/默认/逆向类），现象是**：Cline 回复了完整代码，但**始终不出现「Cline wants to create a new file」**，也不会弹 Save / Reject 按钮，只在聊天里给你一段代码块。
- 这个现象**不会报错**，看起来像"模型有点笨"，实际是分组能力不对。选对分组后立刻恢复。

> 具体哪个分组支持，以控制台「令牌 → 分组」页的实际名称和说明为准；拿不准就用 curl 发一个带 `tools` 的请求试，看返回里有没有 `tool_calls`。

### 1.4 请求是怎么走的

```
Cline（VS Code）
  → POST https://api.zaimod.com/v1/chat/completions
      body 里带 tools / tool_choice（Cline 靠这个干活）
  → 中转站按分组路由到上游
  → 返回 tool_calls → Cline 执行写文件/跑命令 → 弹 Save/Reject
```

---

## 二、操作步骤

### 步骤 1 · 打开 Cline 设置

三种入口任选：

- 点 Cline 面板右上角的 **⚙️ 齿轮图标**；
- VS Code 命令面板（`Ctrl+Shift+P`）搜索 `Cline: Open Settings`；
- 首次使用时会直接弹「Use your own API key」配置向导，点进去就是同一个页面。

### 步骤 2 · API Provider 选 OpenAI Compatible

`API Provider` 下拉里选 **`OpenAI Compatible`**。

![](/uploads/editor/20261031/img_6ae5f827ef4007.43832842.png)

**别选错提供商**

- **OpenAI Compatible**：地址可自定义，接中转站用这个（走 `/v1/chat/completions`）。
- **OpenAI**：地址锁死为官方，填中转站无效。
- **Anthropic**：走 `/v1/messages`，Base URL 反而**不能**带 `/v1`。想走 Claude 原生协议时用这个，见四、常见问题最后一条。

### 步骤 3 · 填三项

| 字段       | 填什么                                         |
| -------- | ------------------------------------------- |
| Base URL | `https://api.zaimod.com/v1`                  |
| API Key  | 你的 `sk-` 令牌（直接粘，不要加 `Bearer ` 前缀）           |
| Model ID | 控制台里的完整模型 ID，如 `claude-sonnet-4-5-20250929` |

截图里 `Model ID` 填的是 `claude-3-5-sonnet-20241022`，这是旧型号，**照抄大概率报模型不存在**，请换成控制台模型列表里实际存在的 ID。

**下方那个复选框**

- **Set Azure API version 不要勾。** 勾了会给请求带上 Azure 专用的 `api-version` 参数，中转站不认，直接 400。
- **Custom Instructions 可留空。** 它是追加到系统提示词末尾的自定义指令，与接入无关。

### 步骤 4 · 保存并确认模型已切过去

点底部 **`Done`**。回到 Cline 面板，输入框上方会显示当前模型名；如果仍显示旧模型，重新点齿轮进去确认三项已保存（Cline 偶发不刷新，切换一次面板即可）。

### 步骤 5 · 验证：让它真的建一个文件

不要只问「你好 / 1+1 等于几」——那只能证明能聊天，证明不了能干活。正确的验证方式是让它**做一件需要工具调用的事**：

在输入框发：

```
写一个 python for 循环我看看
```

预期结果（缺一不可）：

![](/uploads/editor/20261031/img_6ae5f83ea84672.86635531.png)

1. 出现 **「Cline wants to create a new file: xxx.py」** 卡片；
2. 右侧编辑器里自动打出文件内容（灰底 = 待批准的 diff）；
3. 底部出现 **`Save` / `Reject`** 按钮；
4. 点 `Save` 后，左侧资源管理器里真的多出这个文件。

只要第 1 步没出现，就是分组不支持函数调用，回 1.3 换分组，不是配置填错了。

---

## 三、配置速查表

| 字段                    | 值                                               |
| --------------------- | ----------------------------------------------- |
| API Provider          | `OpenAI Compatible`                             |
| Base URL              | `https://api.zaimod.com/v1`                      |
| API Key               | `sk-xxxxxxxx`（不加 `Bearer `）                     |
| Model ID              | 控制台实际模型 ID（示例 `claude-3-5-sonnet-20241022` 已过时） |
| Set Azure API version | 不勾                                              |
| 实际请求                  | `https://api.zaimod.com/v1/chat/completions`     |
| 分组要求                  | 必须支持 Function Calling                           |

---

## 四、常见问题

| 现象                                | 原因                                                | 处理                                                                                      |
| --------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `401 Invalid token`               | Key 错、被删，或分组无该模型权限                                | 重新生成令牌，确认分组含目标模型                                                                        |
| 一直转圈 / 提示请求失败但没细节                 | Base URL 少了 `/v1`，打到了前端页面（返回 HTML）                | 改成 `https://api.zaimod.com/v1`                                                           |
| `404`                             | Base URL 多写了一段版本（`/v1/v1`）或带了 `/chat/completions` | 只写到 `/v1` 为止                                                                            |
| `400`，提示 `api-version` / Azure 相关 | 勾了 Set Azure API version                          | 取消勾选                                                                                    |
| 只回代码，不建文件、不弹 Save                 | **分组不支持函数调用**                                     | 换支持 Function Calling 的分组，见 1.3                                                          |
| 提示 model not found / 模型不存在        | Model ID 拼错，或该模型未在分组内                             | 复制控制台模型 ID 原样粘贴                                                                         |
| 聊两句就触发上下文压缩，或提示超出上限               | Cline 对自定义模型按默认上下文窗口估算                            | 齿轮 → Model Configuration → Context Window 填模型实际值                                        |
| 上传图片报错                            | 该模型不支持视觉，Cline 仍按支持处理                             | 换多模态模型，或在 Model Configuration 里关掉 Image Support                                         |
| 每次写文件都要点 Save，很烦                  | 未开自动批准                                            | 面板底部 `Auto-approve` 里只勾选需要的项（建议别全开）                                                     |
| 想走 Claude 原生协议                    | 当前是 OpenAI 兼容通道                                   | Provider 换成 `Anthropic`，Base URL 改为 `https://api.zaimod.com`（**不带 `/v1`**），模型填 Claude ID |

---

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

原文（`cline 配置教程`）全篇 **231 字符**：一句注意事项 + 一张配置图 + 一张效果图，没有步骤、没有字段说明、没有判断依据。整理时修正/补齐如下：

1. **Base URL 没带 `/v1`**：Cline 不做自动补全，纯域名会请求到 `/chat/completions` 并命中站点前端页面（200 + HTML）。已改为 `https://api.zaimod.com/v1`，并在 1.2 给出实测对比。
2. **地址被写成带星号的文本**：原文是 `***API地址填写  https://api.zaimod.com***`，`***` 在 Markdown 里是加粗斜体标记，这一行渲染会错乱，域名可能被格式标记吞掉。
3. **分组名是旧平台的私有命名**：「纯AZ / 官转克劳德2 / 官转克劳德3 / 直连克劳德」在新平台已对不上号。已改写为能力要求——「选支持 Function Calling 的分组」，并给出判断现象，避免读者拿着旧名字找不到选项。
4. **注意事项的位置错了**：这是全篇最关键的一句，却被写成二级标题且排在最前，视觉上更像"警告横幅"而不是操作前提。已移入 1.3 正文并说明**不满足时会怎样**（不报错，只是不建文件）。
5. **Model ID 已过时**：`claude-3-5-sonnet-20241022` 属旧型号，照抄可能直接报模型不存在。已标注按控制台实际 ID 填。
6. **没有步骤编号**：两张图平铺，读者不知道先点哪里、填哪几栏、哪栏是重点。已拆成 5 个步骤并配图注。
7. **漏了「Set Azure API version 不能勾」**：这个复选框是 Cline 给 Azure 用户准备的，勾上会给所有请求加 Azure 参数，中转站直接 400。原文完全没提。
8. **漏了 Model Configuration**：自定义模型不填 Context Window，Cline 会按默认值估算，表现为频繁自动压缩上下文或提前报超限。
9. **第二张图没有说明在验证什么**：那其实是"能建文件"的证据（出现 Save/Reject 才算通）。原文只摆图，读者容易以为随便聊一句就算成功。已改为明确的四条成功判据。
10. **标题小写、无适用对象**：`cline 配置教程` → 改为《Cline 配置教程（接入中转站）》，并补充适用端与前提条件。

---

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

| 项目                             | 原地址                                            | 现地址                                                    |
| ------------------------------ | ---------------------------------------------- | ------------------------------------------------------ |
| 原文唯一一处 API 地址                  | `https://api.zaimod.com`（写作 `***API地址填写 …***`） | `https://api.zaimod.com/v1`                             |
| 对话接口（OpenAI 兼容通道）              | 未提及                                            | `https://api.zaimod.com/v1/chat/completions`            |
| Claude 原生通道（改用 Anthropic 提供商时） | 未提及                                            | `https://api.zaimod.com`（不带 `/v1`，客户端自拼 `/v1/messages`） |

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

上一篇：Dify 添加自定义模型（接入中转站）教程{else}上一篇：没有了下一篇：aider 中转API配置教程{else}下一篇：没有了