# Cline 接入 NezhaGate：用 DeepSeek、Kimi、GLM、Qwen 写代码

在 VS Code 的 Cline 插件里用 OpenAI 兼容方式接入 NezhaGate，一个 Key 切换 DeepSeek、Kimi、GLM、Qwen、Claude 写代码，附省钱搭配和常见报错。零基础可照做。

> https://nezhagate.com/docs/integrations/cline

## 开始前你需要

- 已安装的 **VS Code**（Windows、macOS、Linux 都可以）。

- 一个 NezhaGate 账号和 API Key（第 1 步教你拿）。

- 大约 10 分钟。Cline 的界面是英文的，下文会写出每个按钮的原文。

## 第 1 步：注册 NezhaGate，创建 API Key

1. 打开 [nezhagate.com](https://nezhagate.com/)，点右上角「免费注册」。可以用邮箱注册，也可以用 Google / GitHub 一键登录。

2. 登录后进入「控制台」→「API Keys」。在「创建 API Key」里给 Key 起个名字（比如 `cline`）。Cline 会自动连续调用模型，建议在「单 Key 限额」里填一个金额（比如 5），防止任务跑飞多花钱。然后点「创建 Key」。

3. 页面会显示一串以 `sk-` 开头的 Key，**马上点复制**，它只显示这一次。

余额在「账单」页查看和充值。按实际用量计费，请求失败不扣费。各模型价格见 [定价页](https://nezhagate.com/pricing)。

## 第 2 步：在 VS Code 里安装 Cline

1. 打开 VS Code，按 `Ctrl+Shift+X`（macOS 是 `Cmd+Shift+X`）打开扩展面板。

2. 搜索 **Cline**，认准发布者 saoudrizwan 的那个，点 **Install**。

3. 安装完成后，点左侧活动栏里新出现的 Cline 图标，打开 Cline 面板。

习惯命令行的话，也可以直接运行：

```
code --install-extension saoudrizwan.claude-dev
```

## 第 3 步：把 Cline 接到 NezhaGate

1. 第一次打开 Cline 会问 **How will you use Cline?**，选 **Bring my own API key**，点 **Continue**，进入服务商配置。（以后要改配置：点 Cline 面板右上角的齿轮 → **API Configuration**。）

2. **API Provider**：在搜索框里输入并选择 **OpenAI Compatible**。

3. **Base URL**：填下面的地址。

```
https://nezhagate.com/v1
```

1. **OpenAI Compatible API Key**：粘贴第 1 步复制的 Key。

2. **Model ID**：模型列表会自动加载，选 `deepseek-v4.1-flash`。列表里没有想要的，选 **Use custom model ID…** 手动填模型 ID。

3. 展开 **MODEL CONFIGURATION**：

   - **Supports Images**：DeepSeek、GLM、Kimi、Qwen 请**取消勾选**（它们不看图）；用 Claude 时保持勾选。

   - **Context Window Size**：保持默认 128000。

   - **Input Price / 1M tokens**、**Output Price / 1M tokens**：可以照 [定价页](https://nezhagate.com/pricing) 填上（美元 / 百万 token）。只影响 Cline 里显示的花费，不影响实际扣费；不填的话 Cline 会一直显示 $0。

4. 点 **Continue**（或关闭设置页）保存。

地址只填到 `/v1`，不要加 `/chat/completions`。

## 第 4 步：跑第一个任务

1. 在 VS Code 里打开一个文件夹（可以是空文件夹）。

2. 在 Cline 底部的输入框（Type your task here...）旁边选模式：**Plan** 先出方案、和你商量；**Act** 直接动手改代码。第一次建议用 Act。

3. 输入：`创建一个 hello.py，运行后打印 Hello, NezhaGate`，回车。

4. Cline 每次要写文件或运行命令，都会先请你确认，看一眼内容再点同意。完成后文件夹里就有了 `hello.py`。

## 推荐模型

Cline 依赖**工具调用**（function calling）来读写文件、运行命令，下面这些模型都支持：

| 模型 ID | 适合 | 说明 |
| --- | --- | --- |
| `deepseek-v4.1-flash` | 日常写代码，最省钱 | 默认先思考再动手；价格低，适合大多数任务。 |
| `glm-5.3` | 编程、Agent 任务 | GLM-5 系列旗舰，为编程和 Agent 工作流打造，总是先思考。 |
| `kimi-k3` | 大项目、长上下文 | 长文本理解和工具调用都很强，支持提示缓存。 |
| `qwen3.7-max` | 复杂推理和编程 | 中英文都稳，支持提示缓存。 |
| `claude-opus-5` | 最难的工程任务 | 复杂工程和 Agent 最稳，价格更高。 |

省钱搭配：勾选 **Use different models for Plan and Act modes**，Plan 用 `kimi-k3` 或 `glm-5.3` 想方案，Act 用 `deepseek-v4.1-flash` 干活。

## 关于花费

- Cline 每一步都会把当前任务的上下文重新发给模型，长任务的 token 用量涨得很快。任务做完就开新任务，不要在一个任务里一直聊。

- Kimi K3、Qwen3.7 Max、GLM-5.3 支持提示缓存：重复的长前缀按缓存价结算，比正常输入便宜得多。

- 在第 1 步给 Key 设限额，是最简单的「防跑飞」办法：超过限额后请求返回 402，不会继续扣费。

## 常见问题和报错

| 现象 | 怎么办 |
| --- | --- |
| Model ID 列表加载失败，出现 Enter Model ID... 输入框和错误信息 | 检查 Base URL 和 Key；也可以直接在输入框里填模型 ID，比如 `deepseek-v4.1-flash`。 |
| 401 | Key 错误或已删除。回控制台重新创建并复制。 |
| 402 | 余额不足，或 Key 达到了你设的限额。到「账单」充值，或在控制台调高限额。 |
| 404 | Base URL 末尾多写了 `/chat/completions`，改成 `https://nezhagate.com/v1`。 |
| 400，提到图片或 image | 当前模型不支持图片：在 MODEL CONFIGURATION 里取消勾选 Supports Images。 |
| Cline 反复出错、工具调用失败 | 换上面推荐的模型之一；生图、生视频模型不能用在 Cline 里。 |
| 花费一直显示 $0 | 正常，那是因为没填价格；实际花费以 NezhaGate 控制台为准。 |

还有问题？看 [接入文档](https://nezhagate.com/docs-guide) 或 [常见问题](https://nezhagate.com/faq)。