Cline接入国产大模型完整教程以DeepSeek为例一、背景Cline 是 VSCode 上最火的开源 AI 编程插件之一能在编辑器里直接读项目、改代码、跑命令体验不输 Cursor。但 Cline 默认对接 Claude / OpenAI 等海外模型需要海外信用卡且按 token 计费成本高。很多国内开发者希望用国产大模型成本低、中文理解好、无需翻墙。本文以DeepSeek为例手把手教你让 Cline 无缝接入国产大模型。相比 Codex CLI 需要额外网关做协议翻译Cline 原生支持 OpenAI 兼容协议配置更简单几分钟即可跑通。二、为什么 Cline 接 DeepSeek 更省心Cline 和 Codex CLI 都是终端/编辑器内的 AI 编程助手但对接国产模型的难度截然不同对比项Codex CLICline运行形态终端命令行VSCode 插件API 协议OpenAI Responses API/responsesOpenAI Chat Completions/chat/completions国产模型兼容需 ccx 网关翻译协议原生支持 OpenAI Compatible中间件必须装 ccx ccswitch无需任何中间件配置方式改 config.toml auth.json插件 GUI 直接填上手难度高低核心原因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进入扩展商店CtrlShiftX 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 接口地址注意不带 /v1Cline 会自动补 | | 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 保存并测试 点击「Lets 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 等旧名**。 ### Q3Base 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 名即可。
Cline接入国产大模型完整教程（以DeepSeek为例）
Cline接入国产大模型完整教程以DeepSeek为例一、背景Cline 是 VSCode 上最火的开源 AI 编程插件之一能在编辑器里直接读项目、改代码、跑命令体验不输 Cursor。但 Cline 默认对接 Claude / OpenAI 等海外模型需要海外信用卡且按 token 计费成本高。很多国内开发者希望用国产大模型成本低、中文理解好、无需翻墙。本文以DeepSeek为例手把手教你让 Cline 无缝接入国产大模型。相比 Codex CLI 需要额外网关做协议翻译Cline 原生支持 OpenAI 兼容协议配置更简单几分钟即可跑通。二、为什么 Cline 接 DeepSeek 更省心Cline 和 Codex CLI 都是终端/编辑器内的 AI 编程助手但对接国产模型的难度截然不同对比项Codex CLICline运行形态终端命令行VSCode 插件API 协议OpenAI Responses API/responsesOpenAI Chat Completions/chat/completions国产模型兼容需 ccx 网关翻译协议原生支持 OpenAI Compatible中间件必须装 ccx ccswitch无需任何中间件配置方式改 config.toml auth.json插件 GUI 直接填上手难度高低核心原因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进入扩展商店CtrlShiftX 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 接口地址注意不带 /v1Cline 会自动补 | | 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 保存并测试 点击「Lets 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 等旧名**。 ### Q3Base 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 名即可。
