Cline 怎么用？VS Code 插件安装与首个任务实操

Cline 怎么用？最短路径是四步：在扩展市场装好插件，登录并选一种模型接入方式，在对话框里用 @ 引用需要的文件，然后先用 Plan 模式理清思路、再切到 Act 模式让它动手改代码。全程用免费模型也能跑通，想长期用才需要付费。

装之前先确认三件事

1. 用哪个入口。VS Code、Cursor、Windsurf、VSCodium、Antigravity 都从扩展市场装；JetBrains 系列（IntelliJ、PyCharm、WebStorm 等）从插件市场装；不想开编辑器可以装 CLI，需要 Node.js 20 以上，官方推荐 22。四条路径的差异可以对照 Cline 官方安装文档。
2. 有没有账号。免费模型和 ClinePass 都需要一个 Cline 账号，支持 Google、GitHub 或邮箱登录。
3. 走哪条模型路线。如果用自带密钥（BYOK）方案，先准备好对应厂商的 API Key；如果接海外厂商的模型，连通性要自己解决。

第一步：把 Cline 装进编辑器

VS Code 系（含 Cursor、Windsurf、VSCodium、Antigravity）：

1. 按 Ctrl/Cmd + Shift + X 打开扩展面板。
2. 搜索 Cline，点 Install。
3. 在侧边栏找到 Cline 图标并打开面板。
4. 在设置里完成模型接入配置，然后登录。

Windsurf 和 VSCodium 走 Open VSX 市场，安装流程完全一样。

JetBrains 系（IntelliJ IDEA、PyCharm、WebStorm、GoLand 等）：

1. 进入 Settings 里的 Plugins，打开 Marketplace。
2. 搜索 Cline，点 Install，然后重启 IDE。
3. 从 View 菜单进入 Tool Windows，选择 Cline。
4. 同样在设置里完成模型接入并登录。

不想在编辑器里用，可以用 CLI：先装 Node.js 20 以上，执行 npm install -g cline 安装，再执行 cline auth 登录，之后直接敲 cline 进入交互，或者 cline "你的任务" 直接跑一条指令。

第二步：选模型接入方式，这是唯一要花钱的地方

Cline 本体免费，真正决定成本和体验的是模型怎么接。官方给了三条路：

一个实用建议：先用免费模型把流程跑通，再决定要不要付费。免费模型只在 IDE 插件和 CLI 里能用，不支持通过 Cline API 调用，这一点官方免费模型文档写得很明确。

如果你手上已经有别的免费额度，也可以接进来用。站内这两篇分别写过 Ox Alpha 免费模型的 API 接入 和 Google AI Studio 的免费白嫖与 API 教程，照着配好 Key 之后在 Cline 里选 OpenAI Compatible 或 Google Gemini 就能接上。

第三步：用 @ 把上下文喂对

Cline 需要的是对的上下文，不是多的上下文。把相关文件点清楚，比让它自己满仓库翻效率高得多。

其他几种加上下文的方式：

• 点输入框左下角的加号，浏览并选择文件或图片。
• 直接把文件拖进对话框。VS Code 里拖的时候要按住 Shift。
• 多根工作区要写成 @工作区名:/文件路径。
• 在编辑器里选中代码右键，有 Add to Cline、Fix with Cline、Explain with Cline、Improve with Cline 四个命令，Fix with Cline 还会出现在报错的灯泡菜单里。
• 在终端里右键 Add to Cline，可以把构建报错、测试失败直接丢给它。

支持拖入的文件类型除工作区文本文件外，还有图片、PDF、CSV 和 Excel。图片需要多模态模型才能识别，模型选择器里能看到哪些支持。

第四步：Plan 和 Act 两个模式怎么配合

Cline 把思考和动手分成了两个模式，这是它上手后最值得花时间理解的部分。

• Plan 模式：可以读代码、搜索、讨论方案，但不能改文件、不能执行命令。
• Act 模式：可以改文件、跑命令，并且会完整继承 Plan 阶段积累的上下文，不需要你重复说明。

什么场景用哪个模式，官方给了一张对照表：

两个进阶技巧：一是可以为 Plan 和 Act 分别配置模型，用推理强的模型做规划、用快的模型做执行，切换模式时模型自动跟着换；二是复杂任务直接用 /deep-planning 斜杠命令，它会系统性地扫一遍代码库、列出受影响的文件和依赖，再产出详细实施计划。

怎么确认自己已经跑通了

三个信号都能看到，说明配置没问题：

1. 在 Plan 模式下问它这个项目的结构，它能准确说出关键目录和入口文件。
2. 切到 Act 模式，让它改一句文案，对话框里会展示改动 diff，点 Approve 之后文件真的变了。
3. 走 Cline 计费时，对话框上方能看到用量和费用变化。

另外 Cline 会给每一步改动打检查点，改坏了可以回滚代码同时保留对话记录，这是它比很多同类工具让人放心的地方。

进阶：Rules、MCP、CLI 和 Kanban

• Rules：把项目的编码规范、技术栈约定写成规则，Cline 每次都会遵守，适合团队统一风格。
• MCP：按 官方 MCP 文档 的说明，点面板里的 MCP Servers 图标进行配置，本地服务用 command 加 args 的写法，远程服务填 URL，传输类型推荐 streamableHttp。CLI 里跑 cline mcp 有交互式向导，可以增删改和启停。
• CLI：除了 npm install -g cline，官方还支持 cron 定时任务、连接 Telegram 或 Slack 这类外部通道，适合放进 CI 里做自动化。
• Kanban：执行 npx kanban 起一个任务板，让多个 Agent 在各自独立的 git worktree 上并行干活，避免互相覆盖文件。

Cline 的仓库在 GitHub 的 cline/cline 上开源，遇到问题可以直接翻 issue。如果你还在比较同类工具，站内之前写过字节的 Trae SOLO 上手流程 和腾讯的 CodeBuddy 安装到 Agent 模式全流程。Cline 与它们最大的差别是每一步改动都要你点确认，可控性更高，但节奏也更慢。

常见报错速查