Cline 教程：VS Code 开源 AI 编程助手接国产模型（2026）
发布于 2026年9月8日
Cline 是目前最受欢迎的开源 AI 编程 agent 之一——它是一个装在 VS Code 里的侧边栏助手，能自己读代码、跨文件改代码、跑终端命令、联网查资料、通过 MCP 接外部工具。它开源免费，而且「自带钥匙」：你用哪家模型、花不花钱由你决定，这也让它成了国内开发者接 DeepSeek、通义千问、Kimi、智谱 GLM 等国产模型的顺手工具。这篇 Cline 教程会带你完成安装、讲清 Plan/Act 双模式，重点讲怎么把国产模型接进去。
Cline 是什么
Cline（读作「克莱恩」）是一个开源（Apache 2.0 协议）的自主编程 agent，主要以 VS Code 扩展的形式运行，安装量已达数百万级。装好后它在编辑器侧边栏开一个对话面板，你用自然语言下达任务，它会读你的代码库、制定计划、逐个文件修改、必要时执行命令，每一步改动都要经过你点确认。除了 VS Code，它也在向 JetBrains 等其他编辑器扩展，并提供了命令行（CLI）预览版。
一句话定位
Cline = 开源免费、装在 VS Code 里的 AI 编程 agent。它自己不锁定模型（BYOK，自带 API Key），支持 30 多家模型提供商，所以既能接 Claude、GPT，也能接 DeepSeek、通义、Kimi、GLM 等国产模型——对想省钱又要能干活的国内开发者很友好。
安装：在 VS Code 里搜插件
Cline 是一个 VS Code 扩展，安装最简单：打开 VS Code 的扩展市场（Extensions），搜索「Cline」，点安装即可；装完侧边栏会多出一个机器人图标，点开就是对话面板。喜欢命令行的也可以用 code 命令一键装。
bash
# 方式一：在 VS Code 扩展市场搜 "Cline" 点安装（推荐，最直观）
# 方式二：命令行安装扩展（扩展 ID 以市场页面为准）
code --install-extension saoudrizwan.claude-dev
# 装好后：VS Code 侧边栏点 Cline 图标 → 打开对话面板第一次打开会让你配置模型提供商和 API Key——这一步是关键，国内用户重点看后面「怎么接国产模型」那节。配好后就能在项目里直接跟它对话了。
核心用法：Plan 模式与 Act 模式
Cline 最有辨识度的设计是把「想」和「做」分成两个模式，你可以在面板里随时切换：
- Plan（规划）模式：Cline 先读相关文件、理解需求，给出一份分步骤的实现方案，但不动代码。你先和它对齐思路，觉得靠谱了再执行。这一步只读不写，也更省 token。
- Act（执行）模式：按对齐好的方案真正动手，每一次文件修改、每一条终端命令都要你点确认，避免「AI 一口气把半个项目改乱」。
- 推荐节奏：复杂任务先用 Plan 聊清楚方案，再切 Act 小步执行、逐步验收。
- 遇到报错别慌，把报错信息原样贴回对话，让它自己定位修复——这是 agent 类工具的标准用法。
重点：Cline 怎么接国产模型
Cline 采用 BYOK（自带 API Key）模式，内置了 30 多个模型提供商。接国产模型有两条路：一是下拉列表里有原生选项的（如 DeepSeek、通义千问 Qwen、Kimi/Moonshot），直接选中、粘贴对应平台申请的 API Key 就行；二是没有原生选项的（如智谱 GLM），选「OpenAI Compatible」这一项，手动填 Base URL、Model ID 和 API Key。
| 模型 | 在 Cline 里怎么接 | 说明 |
|---|---|---|
| DeepSeek | 下拉选原生 "DeepSeek"，粘贴 API Key | 性价比高、代码能力口碑好，常用起点 |
| 通义千问 Qwen | 下拉选原生 "Alibaba Qwen"，填 DashScope 的 Key | 阿里出品，有免费额度可先试 |
| Kimi（Moonshot） | 原生 "Moonshot" 或走 "OpenAI Compatible" | 长上下文见长；注意下方 temperature 兼容提示 |
| 智谱 GLM | 选 "OpenAI Compatible" + 填智谱的 Base URL | 无原生项时统一走兼容模式 |
| 想随时换模型 | 选 "OpenRouter"，一个 Key 通吃数百个模型 | 聚合网关，按量计费，省去逐个配置 |
走「OpenAI Compatible」时，三个字段的填法大同小异，下面以智谱 GLM 为例（其它平台把 Base URL 和 Model ID 换成对应文档里的值即可）：
bash
# 在 Cline 设置里选 "OpenAI Compatible"，填这三项：
# 1) Base URL（各家不同，示例为智谱 GLM 的兼容地址）
Base URL: https://open.bigmodel.cn/api/paas/v4
# 2) Model ID（填服务商当前的模型名，会随版本更新，以官方文档为准）
Model ID: glm-4.6
# 3) API Key（在对应平台的控制台申请）
API Key: 你的_API_密钥两个常见坑
① 模型名和 Base URL 会随版本变。国产模型迭代很快（GLM、Kimi、DeepSeek 的版本号一直在更新），配置前请以对应平台官方文档里的当前模型 ID 和接入地址为准。② 协议兼容差异。Cline 有时会发送某些模型不支持的参数（社区就出现过给 Kimi 传 temperature 导致报错的情况），如果配好后调用失败，优先怀疑模型名写错或参数不兼容，去 Cline 的 issue 区搜一下对应模型。
Cline 和 Claude Code、Cursor 怎么比
三者都能干「AI agent 帮你写代码」的活，但形态和成本不一样，适合搭配着用：
| 工具 | 形态 | 模型 / 费用 | 适合谁 |
|---|---|---|---|
| Cline | VS Code / JetBrains 插件 | 开源免费，自带 Key（BYOK），可接国产模型 | 想留在 VS Code、想自己控成本、想接国产模型的人 |
| Claude Code | 终端命令行工具 | 官方走 Anthropic，也可改 Base URL 接第三方 | 习惯终端、认可 Claude 代码质量的人 |
| Cursor | 独立的 AI 编辑器（VS Code 分支） | 订阅制为主，模型内置 | 想要开箱即用一体化体验、愿意付订阅费的人 |
简单说：Cline 胜在开源、免费、模型自由，尤其适合接国产模型压成本；Claude Code 在终端里、代码质量口碑好；Cursor 是花钱买省心的一体化 IDE。它们不冲突，很多人是几样都装、按任务和当天额度切换。
Cline 免费吗？要花多少钱
Cline 插件本身完全免费、开源，没有订阅费。真正花钱的是你选的那家模型的 API 调用费——用哪家、花多少完全由你控制。如果接 DeepSeek、通义等国产模型，或吃各家的免费额度，日常使用可以压得很低甚至趋近于零；也有官方提供的托管账户（充值额度）可选，图省事不想逐个配 Key 的可以考虑。总体上，「插件白嫖 + 自选模型付费」是 Cline 最大的灵活性所在。
把 Cline 配好、接上一个趁手的模型，只是「用 AI 写代码」的第一步。真正决定你能不能做出可交付产品的，是需求拆解、方案审查和工程落地这些硬功夫——工具会换，方法不会过时。想系统掌握用 AI 工具从想法做到上线的完整路径，欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程