Cline AI：含九个实用示例的指南

如果用几句话概括 Cline，那就是：

• 开源
• AI 合作伙伴——而非 AI 代理
• 企业级安全
• 出色的规划与执行模式
• 类 Git 的检查点管理

这些是 Cline IDE 在常见 AI IDE 功能（如 MCP 支持、代码库对话、终端命令执行与文件编辑）之上的优势。

在本教程中，我将深入探讨 Cline 及其上述特性，并与 Cursor 进行对比。我会通过实用示例演示它如何作为一位 AI 合作伙伴发挥作用，而不仅仅是开发流程中的又一个工具。

我们通过每周五发送的免费通讯 The Median，解读本周 AI 关键动态，持续为读者带来最新资讯。订阅即可每周用几分钟保持敏锐：

什么是 Cline？

Cline 是一款开源的 AI 编码助手，以VS Code 扩展（及任何 VS Code 分支）形式工作。它区别于典型自动补全工具之处在于其“开发伙伴”角色——它能创建与编辑文件、运行终端命令、浏览网站并处理多步任务。其“人类在环”方式意味着每一步操作都需您的批准，从而让您对工作区改动拥有完全掌控。

该工具通过分析文件结构、运行检索并阅读文档来理解大型代码库，而不至于压垮上下文窗口。它支持多家 AI 提供商，包括 Anthropic、OpenAI、Google Gemini、AWS Bedrock，以及通过 Ollama 或 LM Studio 的本地模型。

除了基础文件操作，Cline 还包含用于网页测试的浏览器自动化、MCP 协议以支持自定义集成，以及适用于复杂项目的智能上下文管理。

Cline 的独到之处：

• 记忆库系统：维护结构化文档文件（projectbrief.md、activeContext.md、progress.md），以便在多次会话中重建项目理解

• 检查点管理：在每一步和每次工具调用时创建快照，便于比较改动、恢复先前状态或无风险试验

• 可切换规则：在不同的指令集（.clinerules）之间切换，以适配多种开发语境

• 规划与执行模式：将战略规划与实现分离，以提升任务管理

持久记忆、版本控制与灵活指令管理的组合，使 Cline 从一个简单助手转变为可协作的开发环境，能够记住您的工作习惯，并与项目共同成长。

如何安装并设置 Cline

可通过 VS Code 扩展市场安装 Cline：

安装完成后，重启您的 VS Code（或 Cursor、Windsurf），Cline 扩展应出现在左侧边栏。打开它并按照“Get started”的指引完成账户与基础设置。随后，您将看到如下界面：

接下来，您需要在设置中选择模型提供商，因为 Cline 是开源的，不附带付费额度。如下图所示，我选择了 Anthropic 作为 API 提供商，并选定了Claude Sonnet 4 模型：

Cline 支持几乎所有主流与小众厂商。虽然我只使用 Claude 系列模型，您也可以选择第三方路由商，如 OpenRouter、Requesty，或用于企业的 Google Vertex 与 AWS Bedrock。建议选择 OpenRouter——这样您只需设置一个 API 密钥，就能访问 OpenRouter 托管的全部模型。

现在，您已可以开始使用 Cline！

如何使用 Cline：九个实用示例

本节我们将在构建一个 4x4 井字棋游戏的过程中探索 Cline 的核心功能。该项目足够简单，可保持 API 成本较低，同时也足够完整，能展示所有特性。作为参考，整个教程中我们将使用 Claude 4 Sonnet。

让我们开始吧！

规划与执行模式

Cline 最强大的功能之一是其“规划与执行”（Plan & Act）模式系统，将战略思考与具体实现分开。不像Cursor 或 Windsurf 在每次提示后立即执行，Cline 允许您以两种明确的阶段工作：

1. 规划模式：只读探索与架构设计；以及
2. 执行模式：进行实际代码更改。

这种分离解决了传统 AI 编码助手的常见痛点——它们往往在未充分理解范围前就仓促实施，导致多次迭代与次优方案。借助规划与执行模式，您完全掌控“从思考到行动”的切换时机。

规划与执行模式的差异

规划模式完全只读。Cline 可以分析您的代码库、读取文件、提出澄清性问题，并给出详尽的实现策略，而不会触碰任何一行代码。这让您可以安全地探索复杂项目、理解现有架构，并制定完整计划，而无需担心不必要的改动。

执行模式切换为读/写权限，允许 Cline 按计划实施方案。不同之处在于您来掌控这一切换——Cline 不能自动进入执行模式，必须等待您的明确批准。

以井字棋项目演示“规划与执行”

我们在规划模式下打开 Cline，并提交初始请求，开始 4x4 井字棋项目：

I want to build a 4x4 tic-tac-toe game in Python with a clean terminal interface.
The game should support two players taking turns, detect wins in rows, columns,
and diagonals, and handle draws. It should have colored elements, not just black and white, but the color system must be minimalistic.技术支持

Cline 给出了一份全面分析，阅读当前目录结构（目前是空目录），并提出详细架构。响应包含文件组织建议、类结构建议与分步实现计划。重要的是，此阶段不会创建或修改任何文件。您可通过这个 GitHub Gist查看我们首次提示生成的完整回复。

规划响应还涵盖了博弈逻辑架构、用户界面设计、胜利条件算法与错误处理方案。

在审阅计划（如有需要也可补充指导）后，我们准备进入实现。切换到执行模式会立即促使 Cline 实施整个计划，而这个过程包含许多细节。

首先，在计划执行过程中，您会在执行面板顶部看到详细的 Token 使用、缓存与上下文窗口使用日志：

我在 Cline 执行完毕后截的图，显示整个应用消耗了 $0.35，使用 8.7k tokens 与 26.5k 上下文窗口。我很喜欢这些细节，其他付费的 VS Code 分支基本都完全隐藏。

中间还能看到执行时间线中不同颜色的条：

• 灰色条表示“模型思考中”、Shell 输出解析
• 蓝色条表示批准新建文件
• 紫色表示终端命令成功
• 黄色表示读取文件
• 绿色表示任务成功完成

在整个执行过程中，Cline 自动创建脚本与测试文件、运行终端命令并解析其输出，并提供详细日志。最后，Cline 会询问您是否还有要修复、改进或调试的内容。此阶段最终的终端应用如下所示：

为何此方法更优

该“规划与执行”流程能产出更高质量代码，因为在写下第一行前，Cline 已经通盘考虑了项目范围。规划阶段能捕捉潜在问题、澄清需求，并确保实现与您的设想一致。不再是其他 AI 助手常见的“编码 → 测试 → 修复 → 重复”循环，而是“规划 → 评审 → 实施 → 完成”。

这种分离也避免了 AI 助手常见的问题——基于假设修改无关文件。在规划模式中，Cline 能安全地阅读整个代码库以理解上下文，而无需担心任何不必要的更改风险。

自动批准

在我们构建井字棋游戏时，您会注意到 Cline 在每次操作前都会请求许可。它会征求读取文件、创建新文件或运行终端命令的批准。这让您保持掌控，但如果您信任 Cline 的决策，这也可能拖慢节奏。自动批准功能允许您为不同类型的操作设置特定权限。

自动批准菜单包含若干权限级别。您可以允许 Cline 自动读取项目文件，同时对编辑仍需审批。或者，您可仅允许 ls、cat 等“安全命令”，并阻止任何潜在破坏性的操作。maximum requests 设置相当于安全网，在连续自动化操作达到一定数量后，需再次征求您的输入。

对于我们的教程项目，开启全部自动批准设置很合适，因为我们在做演示项目。随着您对 Cline 的工作方式更熟悉，可以逐步微调权限。便捷的“星标”开关可随时开启或关闭自动批准。在重要工作中收紧安全，或在试验时放宽限制，都十分便利。

网页与浏览器使用

与许多现代 AI 助手一样，Cline 也支持网页搜索。例如，在初版应用实现后，我让它：

Browse the internet for innovative ways other people have built tic-tac-toe games. I want more comprehensive features技术支持

它进行了全面的 Google 搜索，将发现总结为 8 类增强方向，并给出三阶段行动计划：

## Recommended Enhancement Plan

__Phase 1: Core Improvements__

1. Add AI opponent with difficulty levels
2. Implement move undo/redo functionality
3. Add game statistics and history
4. Create configurable board sizes

__Phase 2: Advanced Features__

1. Tournament mode with multiple rounds
2. Save/load game functionality
3. Advanced visual effects and animations
4. Sound system integration

__Phase 3: Innovation__

1. Ultimate Tic-Tac-Toe variant
2. Network multiplayer capability
3. Web interface version
4. Mobile-responsive design

Would you like me to focus on any specific category of features, or should I create a comprehensive plan incorporating multiple innovative elements? I can start with the most impactful features like AI opponents and enhanced game modes.技术支持

此时，我可以要求它将第一阶段细化为更小的子任务，然后点击“Act”来完全实施。

Cline 还支持远程浏览器功能。此特性能让 Cline 通过受控的浏览器实例直接与网页内容交互。借助远程浏览器，您可以让 Cline：

• 访问网站并查看其内容
• 测试本地运行的 Web 应用
• 填写表单并与页面元素交互
• 捕获其所见的屏幕截图
• 监控控制台日志与错误

浏览器可通过简单命令使用，如“Use the browser to check the website at https://example.com”或“Click the login button.” 这对 Web 开发测试、UI/UX 评审与内容研究很有用。当完成浏览器任务后，您需要关闭浏览器，Cline 才能使用其他工具，如文件编辑或终端命令。更多细节请查看Cline 文档对该功能的介绍。

任务管理与检查点

Cline 的一大亮点是其检查点管理系统。其他 IDE 往往只允许在整个提示完成后恢复项目状态，而 Cline 会在每次单独的工具调用后创建检查点。

这意味着每一次写文件、运行终端命令或发出网络请求，都会拥有自己的检查点。Cline 通过与您现有仓库并行运行的“影子 Git 仓库”来管理这些内容，细粒度追踪每一处改动。

除检查点外，Cline 还包含全面的任务历史系统，帮助您组织工作。您可以通过侧边栏中的历史按钮访问以往对话，在那里可使用搜索与筛选功能快速定位特定任务。

“收藏”功能允许您为重要对话加星标，便于后续快速访问，被收藏的任务也会受到误删保护。您可以按最新、最旧、成本或 Token 用量排序，轻松找到高成本对话或跟踪 API 支出。

任务管理还支持批量清理操作。您可以选择多项任务删除，同时保留收藏项，或将有价值的对话导出为 Markdown 以供外部参考。细粒度检查点与有序任务历史的结合意味着您可以放心试验，随时回滚到任意先前状态，或迅速找到以往会话中的相关工作。

MCP 服务器集成

Cline 支持MCP（模型上下文协议）服务器，它们是为 AI 助手扩展能力的专用组件。可以把它们看作插件，使 Cline 能抓取网页、处理图像、访问 API 或与特定服务交互。不再局限于文件操作与终端命令，MCP 服务器让您连接外部工具与服务。

通过 Cline 内置的“市场”即可轻松安装 MCP 服务器。点击工具栏的“Extensions”按钮，按类别（网页抓取、文件系统、研究工具等）浏览服务器，并一键安装。

若某个服务器需要 API 密钥，Cline 会引导您安全获取并输入。安装完成后，服务器能力会自动集成到 Cline 中，您只需直接让它“用 Perplexity 搜索网络”或“处理这张图片”，无需指定具体工具。

Cline 还包含用于根据会话上下文自动选择服务器的 MCP 规则。您可以将相关服务器分组并定义触发关键词，这样当您提到“网页抓取”或“股价”时，Cline 会自动知道该用哪些工具。无需手动指定工具，使交互更顺畅，详情见MCP 市场文档。

Cline 规则

Cline 规则提供跨对话持久的系统级指引与偏好。它们让您无需每次重复说明，就能向 Cline 传达项目的编码规范、文档要求或特定工作流。

在我们的井字棋项目中，可以创建关于 Python 格式偏好或终端界面样式的规则，Cline 会在开发过程中始终记住。您可点击“规则”选项卡中的 + 按钮创建规则，或使用 /newrule 斜杠命令。

规则可以是项目根目录下的单个 .clinerules 文本文件，或是 .clinerules/ 目录中的多个 Markdown 文件。单文件方式适合像我们井字棋这样的简单项目；目录方式便于将不同规则集组织到更聚焦的文件中。

Cline v3.13 在聊天输入框下方引入了可切换的弹出层，用于显示当前启用的规则，并允许您一键启用或禁用特定规则文件。这意味着您可以为游戏逻辑规范与 UI 格式化分别设置规则，并根据当前开发的井字棋模块来切换启用。

在大型项目中，基于文件夹的方式尤为有用，您可以组织多份聚焦的规则文件，涵盖编码规范、文档要求或测试实践等具体方面。这些规则作为版本控制的代码库一部分，确保团队一致性。对于本教程项目，我们可以创建关于错误处理模式或输入校验的规则，以在为井字棋添加功能时指引 Cline 的决策，详见 Cline 规则文档。

@提及

Cline 的 @提及 功能让您无需复制粘贴，就能将不同类型的内容直接带入对话。当您在聊天中输入 @ 时，Cline 会显示文件、终端输出、git 变更、URL 等选项。

在井字棋项目中，您可以提及特定文件，如 @game.py 来讨论实现细节，或使用 @git-changes 在提交前审阅当前修改。

• 文件提及：引用特定文件或目录（@/src/game.py）

• 终端提及：在对话中包含终端输出（@terminal）

• Git 提及：显示未提交更改（@git-changes）或特定提交（@a1b2c3d）

• URL 提及：从文档或 GitHub Issue 抓取网页内容（@https://example.com）

• 问题提及：包含 VS Code“问题”面板中的错误与警告

提及系统会自动抓取并格式化内容，让 Cline 精准了解您在处理的对象。无需试图描述错误信息或复制代码片段，您只需提及相关内容，让 Cline 直接分析即可。这种方式能提供更准确的帮助，因为 Cline 能获得完整上下文与正确格式，详见 @提及 概览。

斜杠命令

Cline 众多“易用性小细节”之一是其 斜杠命令：

• /newtask

• /newrule

• /smol

• /reportbug

我尤其喜欢/smol 命令，它可通过生成全面摘要来释放上下文窗口空间。这让上下文工程更轻松：您可以调用 /smol，实时看到上下文窗口缩小，并在不担心细节丢失的情况下继续对话。

Cline 记忆库

针对复杂项目的高级上下文管理，Cline 提供名为“记忆库”的特殊功能。记忆库是项目根目录中的一个文件夹，包含特定的 Markdown 文档：

这些文件协同工作，帮助 Cline 在多次会话中保持上下文，使其从“无状态助手”转变为能随时间“记住”项目细节的持久开发伙伴。

核心文件包括 projectbrief.md（项目基础）、activeContext.md（当前工作重点，更新最频繁）、systemPatterns.md（架构决策）、techContext.md（所用技术）以及 progress.md（已完成与待完成）。就我们的井字棋项目而言，可能包含关于 Python 终端界面方案、游戏逻辑模式与近期增强的信息。

您可以复制文档中的自定义指令，并让 Cline 在项目中“初始化记忆库”来完成设置。在开发过程中，您可以使用“update memory bank”来记录当前状态，并在新会话开始时使用“follow your custom instructions”，让 Cline 从这些文件重建理解。

这种方法尤其适用于需要 Cline 在多次开发会话中记住特定模式、架构决策与项目演进的大型项目，详见 Cline 记忆库文档。

Cline vs. Cursor

Cline 与 Cursor 在 AI 编码上的路径截然不同。

Cline 作为开源 VS Code 扩展运行，您对每个动作都保有控制权——在更改前它都会征求许可。您自备 API 密钥并按用量付费，因此可访问不同 AI 提供商，如 Claude、OpenAI 或 Gemini。此外，还能接入 MCP 生态以连接其他工具。这为您带来更好的成本控制，并能第一时间使用最新模型，但前期设置工作更多。

Cursor 则走相反路线，是为速度而生的独立 IDE。您每月支付 $20，可获得 500 次“快速”请求，超过后会降速。界面打磨精良，开箱即用，适合快速项目。但您受其模型选择所限，可自定义空间较小。归根结底，看您更看重什么——完全掌控与按需付费（Cline），还是流畅体验与固定月费（Cursor）。

结语

Cline 提供了一种侧重协作而非自动化的 AI 编码方法。其“规划与执行”模式、检查点管理与 MCP 集成，让您对 AI 如何辅助开发拥有更多掌控。

与 Cursor 等工具相比，它的前期设置更多，但按次付费与可访问多种 AI 模型的优势，使其成为既要成本可控又要高级功能的开发者的务实选择。