Claude Dev 接入API中转站配置教程

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

> **适用对象**：VS Code 扩展 **Claude Dev**（现名 **Cline**）的 `Settings` 面板  
> **中转站地址**：`https://api.zaimod.com`  
> **一句话流程**：`API Provider` 选 `OpenAI Compatible` → `Base URL` 填到 `/v1` → `Model ID` 填控制台里真实存在的 ID → `Done` → 用「建文件」验收  
> **前提**：所选模型/分组必须**支持 tool use（函数调用）**，否则它只会把代码贴在聊天里，不会真的写文件

---

## 〇、先看这条：Claude Dev 已经改名叫 Cline

原文写于扩展还叫 **Claude Dev** 的时期。这个项目后来更名为 **Cline**，原仓库 `github.com/saoudrizwan/claude-dev` 现在会 **301 跳转到 `github.com/cline/cline`**，插件市场上按「Claude Dev」搜到的也基本是改名后的版本。

所以先分清你要走哪条路：

| 你装到的是…            | 面板长什么样                                                     | 建议                              |
| ----------------- | ---------------------------------------------------------- | ------------------------------- |
| 老版 **Claude Dev** | 侧边栏标题就写 `CLAUDE DEV`，下方是 `Settings` + `Done`（就是原文那张图）      | 照本文配置即可，字段与下文完全一致               |
| 新版 **Cline**      | 标题写 `Cline`，设置页字段更多（多出 Model Configuration、Auto-approve 等） | 本文的填法同样适用；更细的差异见同目录《Cline 配置教程》 |

**两者配置项一字不差**：`API Provider` / `Base URL` / `API Key` / `Model ID`。所以不管装到哪个，往下照填就行。

---

## 一、开始之前

### 1.1 准备清单

| 项目           | 应该填什么                      | 说明                                 |
| ------------ | -------------------------- | ---------------------------------- |
| API Provider | **`OpenAI Compatible`**    | 侧边栏里专给第三方兼容接口用的选项，**不是** `OpenAI`  |
| Base URL     | `https://api.zaimod.com/v1` | **必须带 `/v1`**，见 1.2                |
| API Key      | `sk-` 开头的令牌                | 中转站控制台「令牌」页新建，**不要**加 `Bearer ` 前缀 |
| Model ID     | 控制台模型列表里的完整 ID             | 原文给的两个示例都已过期，见 1.3                 |
| 令牌分组         | 选**支持函数调用**的分组             | 决定了它能不能真的动手改代码                     |

### 1.2 Base URL 必须带 `/v1`（原文正文和它自己的截图是矛盾的）

原文正文只有一句：`Base URL` 填中转站域名——纯域名，不带版本段。  
但原文配的那张截图里，`Base URL` 输入框实际填的是 `https://****/v1`，**结尾带 `/v1`**。

**截图是对的，正文漏了一段。** 因为 Claude Dev 的 `OpenAI Compatible` 提供商把 Base URL 原样交给 OpenAI SDK，SDK 只在后面拼 `/chat/completions`，**不会自动补 `/v1`**。

在 `api.zaimod.com` 上的实测对比：

| Base URL 填写                  | 实际请求地址                  | 返回                      | 说明                                 |
| ---------------------------- | ----------------------- | ----------------------- | ---------------------------------- |
| `https://api.zaimod.com`      | `…/chat/completions`    | **200 + 一整页 HTML**      | 请求打到了站点前端页面（SPA 回落），SDK 解析 JSON 失败 |
| `https://api.zaimod.com/v1` ✅ | `…/v1/chat/completions` | **401 `Invalid token`** | 路径正确、只差鉴权，填对令牌就能用                  |

> **记法**：这一栏填到 `/v1` 为止，**不要**带 `/chat/completions`，也别写成 `/v1/v1`。  
> 这一点和 Dify 的「API endpoint URL」、Cline 的 OpenAI Compatible 一致；和 Claude Code、Gemini CLI 相反（那两个只填域名，客户端自己补）。

### 1.3 Model ID 别照抄，两个示例都过期了

原文那句：「如果使用克劳德模型，只需要在 model id 这里添加 `cursor-3-5-sonnet-20240620` 或者 `claude-3-5-sonnet-20240620` 即可」。问题有三：

1. **两个 ID 都是 2024 年 6 月的旧型号**，上游早已下线，照抄基本直接报「模型不存在 / 无可用渠道」。
2. **`cursor-3-5-sonnet-20240620` 是 Cursor 编辑器内部的私有别名**，不是标准模型名，中转站不保证认得——优先用带 `claude-` 前缀的那个。
3. **原文截图里填的又是 `gpt-4o`**，跟正文说的「克劳德模型」完全不是一回事。三处信息互相打架，唯一可靠的做法是：**打开中转站控制台的模型列表，复制一个真实存在、且你分组有权限的 ID 原样粘进去**。

### 1.4 模型必须支持 tool use

原文正文没写，但截图里那行小字说得很清楚：

> *You can use any OpenAI compatible API with models that support tool use. (Note: Claude Dev uses complex prompts and works best with Claude models. Less capable models may not work as expected.)*  
> （任何支持 tool use 的 OpenAI 兼容接口都能用。注意：Claude Dev 的提示词很复杂，配 Claude 系列效果最好，能力弱的模型可能达不到预期。）

这句是大实话，也是最多人踩的坑：

- **不支持工具调用的模型**（很多小参数模型、部分逆向渠道）现象是：它回复了一整段代码，但**始终不弹「Claude Dev wants to create a new file」卡片**，也没有 `Save` / `Reject` 按钮，只在聊天框里给你看代码。
- 这个现象**不会报错**，看着像"模型有点笨"，其实是能力不匹配。换成支持 tool use 的模型后立刻正常。

### 1.5 请求是怎么走的

```
Claude Dev（VS Code 侧边栏）
  → POST https://api.zaimod.com/v1/chat/completions
      body 里带 tools（它靠这个读写文件、跑命令）
  → 中转站按令牌分组路由到上游
  → 返回 tool_calls
  → 扩展弹出「wants to create a new file」+ Save / Reject
```

---

## 二、操作步骤

### 步骤 1 · 装好并打开扩展

VS Code 扩展面板搜 `Claude Dev`（或 `Cline`）安装。装完左侧活动栏会多一个图标，点开就是对话面板。

> 如果搜「Claude Dev」出来的是别的同名插件，认准发布者 `saoudrizwan`——这个 ID 一直沿用至今。

### 步骤 2 · 进入 Settings

点侧边栏顶部那排图标里的**齿轮**（⚙️），页面切到 `Settings`，右上角出现蓝色 `Done` 按钮，就是这里了。

面板顶部四个图标从左到右依次是：`+` 新建任务、折叠/展开、历史记录、**设置**。

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

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

![](/uploads/editor/20261031/img_6ae604251cf513.41391829.png)

*Claude Dev 的 Settings 面板（英文界面）：API Provider = OpenAI Compatible、Base URL、API Key、Model ID、Custom Instructions、Always allow read-only operations*

三个容易混的选项：

| 选项                    | 地址   | 走哪个接口                  | 适不适合中转站                     |
| --------------------- | ---- | ---------------------- | --------------------------- |
| **OpenAI Compatible** | 可自定义 | `/v1/chat/completions` | ✅ 用这个                       |
| OpenAI                | 锁死官方 | 官方域名                   | ❌ 填中转站无效                    |
| Anthropic             | 可自定义 | `/v1/messages`         | 可选，但 Base URL **不能**带 `/v1` |

### 步骤 4 · 填 Base URL

在 `Base URL` 里填：

```
https://api.zaimod.com/v1
```

注意是 `https://`，不是 `http://`（`http` 会 301 跳到 https，POST 请求可能被改写）。

### 步骤 5 · 填 API Key 和 Model ID

| 字段         | 填什么            | 注意                                                   |
| ---------- | -------------- | ---------------------------------------------------- |
| `API Key`  | 你的 `sk-` 令牌    | 直接粘，**不要**加 `Bearer ` 前缀，不要带引号或空格                    |
| `Model ID` | 控制台模型列表里的完整 ID | 例如 `claude-sonnet-4-5-20250929`；原文的 `…-20240620` 已过期 |

`Model ID` 是**自由输入框**，不是下拉框——填错不会拦住你，只会在发请求时失败，所以务必从控制台复制。

### 步骤 6 · 点 Done，然后真的让它建一个文件

点右上角 **`Done`** 保存，回到对话面板，输入框上方会显示当前模型名。

**验收别只问「你好」**——那只能证明能聊天，证明不了能干活。发一句需要动手的：

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

**成功判据（四条都满足才算通）**：

- [ ] 出现 **「Claude Dev wants to create a new file: xxx.py」** 卡片；
- [ ] 右侧编辑器自动打开该文件（灰底 = 待批准的 diff）；
- [ ] 卡片上有 **`Save`** / **`Reject`** 按钮；
- [ ] 点 `Save` 后，左侧资源管理器里真的多出这个文件。

第一条没出现，就是模型/分组不支持 tool use，回 1.4 换模型，**不是地址填错了**。

---

## 三、面板上其余两项（可留空，但值得知道）

| 字段                                  | 作用                                                                        | 建议                                   |
| ----------------------------------- | ------------------------------------------------------------------------- | ------------------------------------ |
| `Custom Instructions`               | 追加到每次请求系统提示词末尾的固定指令，例如 *"Run unit tests at the end"*、*"Speak in Spanish"* | 接入阶段**留空**，避免干扰排错；跑顺了再按习惯加           |
| `Always allow read-only operations` | 勾上后，读文件、列目录不再逐个弹 `Allow` 确认                                               | 新手建议**先不勾**，先看清它每一步想干什么；熟悉后再勾，能省很多点击 |

---

## 四、配置速查表

| 字段                                | 值                                           |
| --------------------------------- | ------------------------------------------- |
| API Provider                      | `OpenAI Compatible`                         |
| Base URL                          | `https://api.zaimod.com/v1`                  |
| API Key                           | `sk-xxxxxxxx`（不加 `Bearer `）                 |
| Model ID                          | 控制台实际模型 ID（原文 `…-20240620` 已过期）             |
| Custom Instructions               | 留空                                          |
| Always allow read-only operations | 先不勾                                         |
| 实际请求地址                            | `https://api.zaimod.com/v1/chat/completions` |

---

## 五、常见问题

| 现象                                          | 原因                                            | 处理                                                    |
| ------------------------------------------- | --------------------------------------------- | ----------------------------------------------------- |
| `401 Invalid token`                         | 令牌错、已删除，或分组无该模型权限                             | 控制台重新生成令牌，确认分组含目标模型                                   |
| 报 JSON 解析错误（如 `Unexpected token '<'`）/ 一直转圈 | Base URL 少了 `/v1`，请求打到了站点前端页面，返回的是 HTML       | 改成 `https://api.zaimod.com/v1`                         |
| `404`                                       | Base URL 多写了 `/chat/completions`，或出现 `/v1/v1` | 只写到 `/v1` 为止                                          |
| 报「模型不存在 / 无可用渠道」                            | Model ID 用了原文的旧 ID，或拼错                        | 从控制台模型列表复制                                            |
| 只回代码，**不建文件、不弹 Save**                       | 模型或分组不支持 tool use                             | 换支持函数调用的模型，见 1.4                                      |
| 聊两句就提示上下文超限                                 | 扩展按默认上下文窗口估算                                  | 新版 Cline 可在 `Model Configuration` 里填实际 Context Window |
| 上传图片报错                                      | 该模型不支持视觉，扩展仍按支持处理                             | 换多模态模型                                                |
| 每次读文件都要点 Allow                              | 没勾 `Always allow read-only operations`        | 需要时勾上（只放开只读操作）                                        |
| 装完找不到 `CLAUDE DEV` 字样                       | 已改名为 Cline                                    | 见第〇节，配置项完全一致                                          |

---

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

原文全篇 **215 字符**：一句提示 + 一张图 + 一句地址，没有步骤、没有字段说明、没有验证方法。逐条列出改动：

1. **正文的 Base URL 漏了 `/v1`**：正文写 `https://api.openlux.ai`，但它自己的截图里填的是 `https://****/v1`。已按截图更正为 `https://api.zaimod.com/v1`，并在 1.2 给出 200-HTML / 401-JSON 的实测对比。
2. **地址又被 `***` 包住了**：原文是 `***Base URL填写  https://api.openlux.ai***`，`***` 在 Markdown 里是加粗斜体标记，渲染后这行会错乱，域名有被格式标记吞掉的风险（本批教程里已出现多次，属同一模板问题）。
3. **两个 Model ID 示例都已过期**：`cursor-3-5-sonnet-20240620` / `claude-3-5-sonnet-20240620` 均为 2024 年 6 月型号；前者还是 Cursor 的内部私有别名。已改为「从控制台模型列表复制真实 ID」。
4. **正文说克劳德、截图填 `gpt-4o`**：两处示例自相矛盾，读者照哪边都可能踩坑。已明确「以你的分组里实际可用的模型为准」。
5. **没提「模型必须支持 tool use」**：这句只存在于截图的英文小字里，正文一字未提。已提炼为 1.4 节，并给出**不满足时的具体现象**（不报错、不建文件）。
6. **没提扩展已改名 Cline**：读者按「Claude Dev」去插件市场搜，容易装到别的同类插件。已在第〇节说明并给出两条路径。
7. **没提 API Key 不加 `Bearer ` 前缀**：粘贴带前缀的 key 会直接 401，这是新手最常见的错。
8. **没有步骤编号**：全篇只有一张图，读者不知道该先点哪里、哪几栏必填、哪栏是重点。已拆成 6 个步骤，每步写了点哪里、填什么、成功长什么样。
9. **没有验收方法**：原文没有说明什么算"配置成功"。已补「让它建文件」的四条成功判据，并说明为什么不能只问「你好」。
10. **标题全大写、无适用对象**：`CLAUDE DEV 配置教程` → 改为《Claude Dev 配置教程（接入中转站）》，补充适用端与前提。
11. **截图里的域名被打码**：原图 `Base URL` 是 `https://****/v1`，读者看不到该填什么。已在步骤 4 用代码块给出完整地址。

---

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

| 项目                                | 原地址                                               | 现地址                                                        |
| --------------------------------- | ------------------------------------------------- | ---------------------------------------------------------- |
| 正文唯一一处 API 地址                     | `https://api.openlux.ai`（写作 `***Base URL填写 …***`） | `https://api.zaimod.com/v1`                                 |
| 截图里的 Base URL                     | `https://****/v1`（域名打码）                           | `https://api.zaimod.com/v1`                                 |
| 对话接口（OpenAI 兼容通道）                 | 未提及                                               | `https://api.zaimod.com/v1/chat/completions`                |
| Claude 原生通道（Provider 改 Anthropic） | 未提及                                               | `https://api.zaimod.com`（**不带** `/v1`，客户端自拼 `/v1/messages`） |

**迁移提示**

- 令牌要在 `api.zaimod.com` 重新生成，原平台令牌在新域名下返回 `401 Invalid token`。
- 换完地址如果仍报错，重开一次 VS Code 窗口，避免扩展读到缓存的旧配置。

---

*接口地址：`https://api.zaimod.com`*

上一篇：Zotero GPT 插件接入中转站教程{else}上一篇：没有了下一篇：沉浸式翻译接入 GPT 翻译（中转站）{else}下一篇：没有了