Cline接入国产大模型完整教程（以DeepSeek为例）

一、背景

Cline 是 VSCode 上最火的开源 AI 编程插件之一，能在编辑器里直接读项目、改代码、跑命令，体验不输 Cursor。但 Cline 默认对接 Claude / OpenAI 等海外模型，需要海外信用卡且按 token 计费成本高。很多国内开发者希望用国产大模型，成本低、中文理解好、无需翻墙。

本文以 DeepSeek 为例，手把手教你让 Cline 无缝接入国产大模型。相比 Codex CLI 需要额外网关做协议翻译，Cline 原生支持 OpenAI 兼容协议，配置更简单，几分钟即可跑通。

二、为什么 Cline 接 DeepSeek 更省心

Cline 和 Codex CLI 都是终端/编辑器内的 AI 编程助手，但对接国产模型的难度截然不同：

核心原因：DeepSeek 等国产模型几乎都提供 OpenAI 兼容的 Chat Completions 接口，而 Cline 内置了 “OpenAI Compatible” 选项，两者协议天然匹配，一个 Base URL + 一个 API Key 就能通。

Cline 插件 ──POST /chat/completions──▶ DeepSeek API
        (原生兼容，无需翻译层)
        ```
## 三、安装 VSCode 与 Cline 插件

### 3.1 环境要求

- VSCode 1.85 及以上
- - Windows / macOS / Linux
### 3.2 安装 Cline

1. 打开 VSCode，进入扩展商店（`Ctrl+Shift+X`）
2. 2. 搜索 `Cline`，点击安装
3. 3. 安装完成后侧边栏会出现 Cline 图标
安装完成后验证：点击侧边栏 Cline 图标，能看到对话框即安装成功。

### 3.3 首次启动

首次打开 Cline 会弹出欢迎页和模型选择界面。**先不要急着选模型**，后面会手动配置自定义 API。

## 四、获取 DeepSeek API Key

### 4.1 注册账号

访问 [DeepSeek 开放平台](https://platform.deepseek.com/)，注册账号并完成实名认证。新用户通常赠送 500 万 token 免费额度。

### 4.2 创建 API Key

1. 进入「API Keys」页面
2. 2. 点击「创建 API Key」
3. 3. 复制生成的密钥（形如 `sk-xxxxxxxxxxxxxxxx`），**只显示一次，务必保存好**
### 4.3 确认接口地址

DeepSeek 的 OpenAI 兼容接口地址固定为：

https://api.deepseek.com

支持的模型：

| 模型名 | 说明 |
|---|---|
| `deepseek-chat` | 通用对话模型（V3 系列），性价比最高 |
| `deepseek-reasoner` | 推理模型（R1 系列），思考能力强、稍慢 |

日常编程推荐 `deepseek-chat`，复杂算法/架构设计可用 `deepseek-reasoner`。

## 五、配置 Cline 接入 DeepSeek

这是全文核心，一共四步。

### 5.1 打开 Cline 设置

点击侧边栏 Cline 图标 → 顶部齿轮图标（Settings）。

### 5.2 选择 API Provider

在「API Provider」下拉框中选择 **OpenAI Compatible**。

### 5.3 填写配置

按下表填写三项关键配置：

| 配置项 | 值 | 说明 |
|---|---|---|
| Base URL | `https://api.deepseek.com` | DeepSeek 接口地址（注意不带 `/v1`，Cline 会自动补） |
| API Key | `sk-你的密钥` | 第 4.2 步获取的 Key |
| Model | `deepseek-chat` | 模型名，必须和 DeepSeek 文档一致 |

### 5.4 高级参数（可选）

展开「Configuration」可设置：

| 参数 | 推荐值 | 说明 |
|---|---|---|
| Context Window | `64000` | 上下文窗口，deepseek-chat 最大 64K（新版支持 128K） |
| Max Tokens | `8192` | 单次最大输出 token |
| Temperature | `0` | 编程场景建议 0，输出更稳定 |
| Top P | `1` | 默认即可 |

### 5.5 保存并测试

点击「Let's go!」或直接在对话框输入测试消息。若返回正常回复，说明对接成功。Cline 底部会显示当前模型名和 token 消耗。

## 六、实战测试

### 6.1 简单对话

在 Cline 对话框输入：

你好，请介绍一下你自己

正常返回中文回复即说明链路通。

### 6.2 代码生成

试试让它写个真实任务：

在当前项目里新建一个 main.py，实现一个快速排序函数，并写好测试用例

Cline 会自动创建文件、写入代码，并在终端运行测试。整个过程无需手动操作。

### 6.3 验证请求链路

如果想确认请求确实打到 DeepSeek，可在 DeepSeek 控制台「用量」页面查看 token 消耗记录，每次对话都会实时累计。

## 七、进阶：Act 模式与 Plan 模式

Cline 有两种工作模式，接入 DeepSeek 后都能正常使用：

| 模式 | 作用 | 适用场景 |
|---|---|---|
| **Act 模式** | 直接执行：改文件、跑命令 | 明确的小任务、bug 修复 |
| **Plan 模式** | 只规划不执行，输出方案 | 复杂重构、架构设计 |

切换方式：对话框顶部模式开关。建议复杂任务先 Plan 看方案，确认后再切 Act 执行，避免误操作。

## 八、常见问题

### Q1：报错 `401 Unauthorized`？

API Key 填错或过期。到 DeepSeek 控制台重新生成，注意复制时不要带空格。

### Q2：报错 `model not supported`？

模型名写错了。DeepSeek 支持的是 `deepseek-chat` 和 `deepseek-reasoner`，**不要写 `deepseek-v3`、`deepseek-coder` 等旧名**。

### Q3：Base URL 要不要带 `/v1`？

Cline 的 OpenAI Compatible 模式会自动补 `/v1/chat/completions`，所以 Base URL 只填 `https://api.deepseek.com` 即可。如果填了 `https://api.deepseek.com/v1` 会变成 `/v1/v1/chat/completions` 报 404。

### Q4：回复很慢或经常超时？

- 把 Context Window 调小（如 32000）
- - 检查网络，DeepSeek 偶发高峰期拥堵
- - 复杂任务用 `deepseek-chat`，别用 `deepseek-reasoner`（推理模型更慢）
### Q5：能同时配置多个模型吗？

可以。Cline 支持保存多个 API Profile，在设置里点「+」新建配置，填不同的 Base URL / Key / Model，随时切换。比如一个 `deepseek-chat` 日常用，一个 `deepseek-reasoner` 攻坚用。

### Q6：和 Cursor 比怎么样？

Cline + DeepSeek 是开源免费方案，月成本几块钱；Cursor 订阅 20 美元/月。功能上 Cline 的文件操作和终端执行能力很强，但 Cursor 的代码补全体验更顺滑。两者可并存。

## 九、总结

通过本文四步配置，Cline 即可无缝接入 DeepSeek 国产大模型：

- **Cline 插件** — VSCode 内的 AI 编程助手
- - **DeepSeek API** — 国产大模型，OpenAI 兼容协议
- - **原生对接** — 无需网关，填三个字段即通
三者配合，享受和海外模型几乎一致的编程体验，但成本仅为其十分之一，且无需翻墙、无需海外信用卡。如果你的项目偏中文场景、预算敏感，这套组合是目前性价比最高的方案之一。

下一步可以尝试接入更多国产模型（如 GLM、Kimi、Qwen），方式完全一样：换个 Base URL 和 Model 名即可。