适合人群：已经装了 VS Code，想试试让 AI 直接在项目里读代码、改文件、跑命令，但又担心 AI 乱改代码的编程初学者。本文介绍开源编程智能体 Cline 的基本用法：安装、接入模型、用 Plan/Act 模式完成小项目、用检查点回退。
Cline 以 Apache-2.0 协议开源，提供 VS Code 扩展（也支持 Cursor、Windsurf、VSCodium 等）、JetBrains 插件、命令行和桌面应用。它默认每一步都要你批准：创建、修改文件或执行命令前都会先给你看。
本文用一个场景贯穿：小陈想做一个单页的番茄钟网页，用来练习 HTML 和 JavaScript。
一、在 VS Code 中安装 Cline
- 打开 VS Code，按 Ctrl+Shift+X（macOS 为 Cmd+Shift+X）打开扩展面板；
- 搜索 Cline，在 Cline 扩展上点安装；
- 安装后在左侧活动栏找到 Cline 图标，打开 Cline 面板。
Windsurf 和 VSCodium 使用 Open VSX 扩展市场，安装流程相同。命令行版本需要 Node.js 20 及以上，用npm install -g cline安装，本文以编辑器扩展为例。
二、选择模型提供方
Cline 本身不带模型，需要接入一个提供方。官方给出三条常见路线：
- Cline 按量计费：用 Google、GitHub 或邮箱登录，无需管理密钥；
- ClinePass：按月订阅（官方标价每月 9.99 美元）；
- 自带密钥：填写 Anthropic、OpenAI、Gemini、DeepSeek 等的 API Key，或接入本机的 Ollama、LM Studio（无需密钥）。
操作步骤：点 Cline 面板里的齿轮图标进入设置，在 API Provider 下拉框选提供方，按提示登录或粘贴 API Key，再在 Model 下拉框选模型。价格和可选模型变化较快，以官方页面为准。
三、打开项目文件夹，发出第一个任务
先用“文件 → 打开文件夹”打开一个空文件夹，Cline 会把它当作工作区。然后在 Cline 面板底部的输入框里写任务：
用一个 HTML 文件做一个番茄钟网页：25 分钟专注、5 分钟休息， 有开始、暂停、重置按钮，倒计时数字居中显示，样式简洁， JavaScript 和 CSS 都写在同一个文件里。四、先 Plan，再 Act
面板底部有一个 Plan / Act 切换按钮，这是 Cline 最重要的设计：
- Plan 模式：Cline 可以读代码、搜索、和你讨论方案，但不能修改任何文件，也不能执行命令；
- Act 模式：按讨论好的方案改文件、跑命令，并保留 Plan 阶段的对话上下文。
建议先在 Plan 模式里让它说说准备怎么写，你可以追问或修改需求，觉得没问题再切到 Act。官方建议：小修小改直接 Act，涉及多个文件的功能先 Plan 再 Act，大型改动用 /deep-planning 做更细的规划。
五、审批每一次改动
Act 模式下，Cline 准备创建 index.html 时会展示文件路径和代码（新增行标绿），下方有批准和拒绝按钮，点批准才会写入；拒绝后可补充要求。终端命令同理。
写好后用浏览器打开 index.html 测试。想继续改，就在同一个对话里追加，比如“倒计时结束时响一下提示音”，Cline 会读取现有代码并以差异形式给出修改。
六、改坏了就用检查点回退
检查点默认开启。Cline 每次改文件、跑命令后，会在独立的影子 Git 仓库里保存快照，不影响你自己的 Git 历史。对话里每个步骤旁边有两个按钮：
- Compare：打开差异视图，看这一步改了什么；
- Restore：恢复到这一步，可以选择只恢复文件、只恢复对话，或者两者一起恢复。
选项叫法在官方不同页面略有差异，以界面为准。初学者最常用“只恢复文件、保留对话”，然后让 Cline 换一种写法。
七、用规则和斜杠命令减少重复交代
“注释用中文”“不要引入第三方库”这类固定要求，可以写成规则：放在项目根目录 .clinerules 文件夹里的 Markdown 文件，每次对话自动读取，也兼容 AGENTS.md 等文件。输入 /newrule 可让 Cline 引导创建。
几个常用斜杠命令：
| 命令 | 作用 |
|---|---|
| /newtask | 提炼当前进度，开一个新任务 |
| /smol | 压缩对话历史（别名 /compact） |
| /newrule | 创建规则文件 |
| /deep-planning | 先调研代码再出详细计划 |
反复执行的固定流程可以做成 Skill（技能），用斜杠命令触发，写法见官方文档。
常见问题
问：自动批准（Auto Approve）要不要打开？
答：官方建议的默认配置是只开“读取项目文件”，编辑、命令、浏览器和 MCP 先保持关闭；如果开启编辑，配合检查点使用。设置里还有 YOLO 模式，会自动批准所有操作，官方明确提示有风险，初学者不建议开。
问：大仓库里感觉 Cline 变慢了？
答：检查点每一步都会保存快照，仓库很大时可能占空间、拖慢速度，可以在设置的 Feature Settings 里关闭 Enable Checkpoints。
小贴士
- 第一次用建议在一个练习文件夹里操作，熟悉审批流程后再用于正式项目。
- 检查点不能代替 Git，重要节点仍然要自己提交。
- 使用付费模型时留意用量，长任务适时用 /newtask 或 /smol 控制上下文。
参考资料
- Cline 官方文档：安装、授权、Plan & Act、检查点、自动批准、规则与命令等章节 https://docs.cline.bot
- Cline 开源仓库说明（Apache-2.0 协议）
