<!-- title: Cline这8个开关，多数人只当补全器 -->
<!-- domain: tips-tricks -->

帮朋友搭AI编程环境时问他用什么，他说VS Code里装了个Cline，拿来"自动补全代码"。我当时就愣住了——这好比买了台挖掘机回家削苹果。Cline（前身Claude Dev）是VS Code生态里最火的开源AI编程Agent之一，GitHub仓库 `cline/cline` 星标超过4万（截至撰写时，以仓库页面为准），但它和Copilot有本质区别：**Copilot是你写代码它猜下一句，Cline是你给目标它自己拆步骤、改文件、跑命令、看报错、再修正**。国内大量用户只用了它10%的能力。这篇文章把Cline里8个国内教程很少写透的开关全部打开，每一个都可以今天下班前就用上。

## 先泼冷水：为什么你的Cline越用越贵、越用越笨

大部分人装完Cline的动作是：填个API Key → 输入"帮我写个登录页" → 盯着它跑 → 不满意就重来。结果就是token烧得快、产出不稳定。根源在于三个没配置：没给项目立规矩（它每次都重新猜你的偏好）、没分层授权（每一步都要手点批准，或者反过来全放任）、没做上下文管理（把整个仓库塞给它）。下面8招逐一解决。

## 第1招：@引用上下文，别让它自己翻文件

Cline输入框支持@提及，这是被提及最少但收益最高的功能：

- **`@/path/to/file`**：精确指定文件，避免Agent自己花token去搜；
- **`@problems`**：把VS Code"问题"面板里的编译错误、lint报错直接喂给它——这是最隐藏的一个，修报错时别复制粘贴，直接`@problems`，它会拿到结构化的错误列表；
- **`@url`**：贴一个文档链接（比如某个库的API文档），Cline会用浏览器抓取网页内容转成Markdown再阅读，等于自带一个轻量文档阅读器；
- **`@commit`**：引用某次git提交的内容，适合"照着上次那次修复的方式再处理一个类似bug"。

预期效果：上下文给得准，Agent瞎翻文件浪费的token能省一大截，命中率明显提升。适用场景：修编译错误、对接陌生库、接手祖传代码。

## 第2招：Plan/Act双模式，两个模式用两个模型

Cline默认有Plan和Act两种模式：**Plan只读不动手**，负责和你商量方案；**Act才会真正改文件、执行命令**。两个关键玩法：

1. 养成习惯：**所有非琐碎任务先按Plan，方案确认了再切Act**。只按一个回车就能避免Agent一上来就把你的文件改面目全非。
2. 新版设置里支持**给Plan和Act分别配不同模型**（在API Provider设置里切换Plan mode / Act mode的模型配置，具体入口以docs.cline.bot为准）。社区流行的搭配是：Plan用便宜的思考型模型（比如DeepSeek、Gemini Flash级别）做方案讨论，Act用最强模型执行关键改动。据大量用户反馈，这样搭配能把成本砍掉一大半，方案质量反而不降。

## 第3招：Checkpoints检查点，Agent改崩了秒回滚

Cline每次改动前会用一个shadow git仓库对工作区做快照（不污染你的git历史）。聊天面板里每一步旁边都能"Compare"对比改动、"Restore"回滚到任意检查点。三个使用心法：

- **大重构前必看diff再放行**；
- Agent把好文件改坏时，用Restore回退到改动前的检查点，而不是让它在坏代码上继续补救（越补越烂是Agent的通病）；
- 配合第2招：Act模式跑之前，你永远知道有一条退路。

## 第4招：.clinerules——给项目立一部"宪法"

在项目根目录建一个 `.clinerules` 文件（Markdown纯文本），写清楚技术栈、目录约定、代码风格，例如："本项目用React+TypeScript，组件放src/components，样式用Tailwind，禁止引入新依赖，报错信息保留原文"。Cline每次任务都会自动读取。还可以用全局规则（设置里的Custom Instructions）存放跨项目的个人偏好，比如"回复用中文解释、代码注释用英文"。

这解决的问题只有一个：**每次开新会话不用重复自我介绍**。它和Cursor的`.cursorrules`、Claude Code的`CLAUDE.md`是同一个思想，但国内Cline教程极少强调——而这恰恰是从"玩具"到"生产力"的分水岭。

## 第5招：Auto-approve分级放权，别一刀切

设置里的Auto-approve不是个总开关，而是一组分级开关：读取文件/目录、编辑文件、执行终端命令、使用浏览器、调用MCP工具，可以分别授权，还能设置**单次任务最大自动请求数（Max Requests）**防止失控。推荐配置：

```text
✅ 读取文件/目录     —— 零风险，必开
✅ 编辑文件         —— 开，反正有Checkpoints兜底
⚠️ 执行终端命令     —— 只放行只读命令时再开，或干脆不开
❌ 浏览器/MCP       —— 初期手动批准，跑顺了再放
Max Requests: 建议10-20，防止死循环烧token
```

这一套下来，你从"每步点批准的监工"变成"只审关键决策的领导"，这才是Agent该有的用法。

## 第6招：MCP Marketplace，给它装外挂

Cline内置MCP（Model Context Protocol）市场，一键安装外部工具服务器。几个实用方向：让Agent有持久记忆（Memory类MCP）、直接查数据库、操作GitHub提issue/发PR、抓网页。装好后Agent的能力就从"读写本地文件"扩展到"操作外部世界"。安装入口在侧边栏MCP图标，选一个装上、配置环境变量、在对话里说"用XX工具做XX"即可。自建也行：Cline兼容标准MCP协议，Claude生态里的MCP服务器大多可以直接挂过来——这是它比很多闭源插件灵活的根本原因。

## 第7招：浏览器工具，让它自己看页面自己调

Cline带内置浏览器操作能力：前端任务完成后可以让它启动dev server、打开localhost截图检查、读取console报错、点击交互元素验证。实战用法：任务描述里直接写"改完后启动服务，用浏览器打开页面确认XX按钮点击后无报错"。它会把截图和报错纳入反馈循环自己修。这是它和"补全器"最大的体感差异——**它能看见自己干的活长什么样**。

## 第8招：/newtask拆任务 + History续任务

两个会话管理技巧：

- **`/newtask`**：在对话中把当前任务拆出子任务，新会话会带上你选定的上下文。长任务别一口气塞，拆成"先搭骨架→再填逻辑→最后补测试"三段，每段独立会话，上下文干净、成功率更高；
- **History面板**：历史任务可随时点开续聊（Resume），上周没调完的任务这周接着跑，不用重述背景。新版还有任务进度清单（Focus Chain）让Agent自报进度，长任务中间断开也不慌。

## Mermaid：一条合格的Cline工作流长这样

```text
flowchart TD
    A[新任务开始] --> B[Plan模式: 便宜思考模型做方案]
    B --> C{方案OK?}
    C -- 否 --> B
    C -- 是 --> D[切Act模式: 强模型执行]
    D --> E[Checkpoint自动快照]
    E --> F[Auto-approve放行读+改]
    F --> G{结果验证}
    G -- @problems有报错 --> H[Agent读报错自修]
    H --> G
    G -- 改崩了 --> I[Restore回滚检查点]
    I --> D
    G -- 通过 --> J[/newtask 拆下一阶段]
    J --> B
```

## 信息差总结

| 维度 | 你以为的Cline | 实际的Cline |
|------|--------------|------------|
| 定位 | 代码补全插件 | 自主执行任务的Agent |
| 模型 | 绑一个API | BYOK任意混搭，Plan/Act可各配一个 |
| 改崩了 | 手动Ctrl+Z | Checkpoints一键回滚任意步骤 |
| 项目约定 | 每次口头重复 | .clinerules自动生效 |
| 修报错 | 复制粘贴给它 | `@problems`直接喂结构化错误 |
| 批准 | 每步手点或全放飞 | 分级授权+Max Requests熔断 |
| 能力边界 | 读写文件 | MCP外挂+浏览器自检 |

## 行动指南

1. 今天：项目根目录建 `.clinerules`，写下技术栈和三条红线（10分钟）；
2. 今天：设置里把Auto-approve按上文分级配置，Max Requests设为15（5分钟）；
3. 本周：下次修bug用`@problems`，前端任务加一句"用浏览器自检"；
4. 本周：配置Plan/Act双模型（Plan用低价模型），观察一周token账单变化。

## 参考来源

> 注：本文写作时实时搜索不可用，以下为官方入口，具体功能入口、版本差异、Star数据请以官方页面为准；文中价格与搭配为社区常见实践，非官方报价。

1. Cline官网：https://cline.bot
2. GitHub开源仓库：https://github.com/cline/cline
3. 官方文档（Checkpoints / Rules / MCP / Auto-approve配置说明）：https://docs.cline.bot
4. Cline MCP市场说明：https://github.com/cline/mcp-marketplace

---
> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
