<!-- title: 别把Cline当补全器：八个深水暗格 -->
<!-- domain: tips-tricks -->

你可能在 VS Code 插件市场刷到过 Cline——那个头像是绿色机器人、装机量数百万级的开源 AI 编码插件（装机量据其市场页面显示为百万级，实时数字以官方页面为准）。大多数人对它的认知停留在“免费版 Cursor 平替”，装上、填个 DeepSeek 的 Key、让它改两个文件，然后得出结论：“不过如此。”

这就亏大了。Cline 的真正玩法藏在设置面板、斜杠命令和两个以点开头的隐藏文件里。海外 r/Cline 社区里那些把 Cline 用成“一个人silicon谷小团队”的老手，用的全是你没打开过的功能。今天把八个暗格一次性拆给你。

## 先说清楚它是什么

Cline 原名 Claude Dev，2024 年 7 月更名，Apache 2.0 协议开源在 GitHub（github.com/cline/cline）。它不是补全工具，是 Agent：你给一个任务，它自己列计划、读仓库、改文件、跑终端命令、开浏览器验证，每一步等你审批。

商业模式是 BYOK（Bring Your Own Key）：插件本身免费，模型费用你直接付给 Anthropic、OpenAI、DeepSeek 或 OpenRouter。国内用户最舒服的点在这——挂一个 DeepSeek API，重度用一天也就几块钱人民币（具体牌价以 DeepSeek 官网为准），比任何订阅制都便宜。对比国内同类：字节 Trae 免费、内置模型开箱即用，适合新手；腾讯 CodeBuddy、阿里通义灵码主打国产合规。Cline 的差异点是：开源可审计、不被任何厂商锁定、配置文件能进 Git 全团队共享、还有 MCP 生态——后面细说。

## 暗格一：Plan/Act 双档变速箱，一个 Agent 当两个用

输入框上方有个不起眼的 Plan/Act 切换开关（默认快捷键 Ctrl+.，Mac 是 Cmd+.，记不住就点开关）。这不是装饰——它是 Cline 最省钱的设计：

- **Plan 档**：只读不写。让它读代码、出方案，改方案零成本，反正一行代码没动。
- **Act 档**：真正动手写文件、跑命令。

杀手锏在设置里：**两个档位可以绑不同的模型**。Plan 绑个贵的推理模型（比如 DeepSeek-R1 或 Claude Sonnet）让它想得深，Act 绑个便宜的（DeepSeek-V3 系列）让它干活快。海外社区反复验证过的结论是：这样搭配出来的代码质量，比全程用单一模型又好又便宜——因为“想”和“干”本来就是两种活。

**适用场景**：所有正经开发任务。切档动作建议形成肌肉记忆。

## 暗格二：@problems——报错面板一键直灌

还在手动复制粘贴报错信息喂给 AI？Cline 输入框里打 `@problems`，它会把 VS Code “问题”面板里当前所有诊断信息（编译错误、lint 告警、类型错误）直接拉进上下文，AI 看到的就是编辑器看到的，一个字都不用你搬。

**操作**：跑完代码 → 输入框敲 `@problems` → 回车发送。预期效果是 AI 拿到的是带文件路径和行列号的完整诊断，修复精度远高于你手打的“报错了帮我看看”。配合它自带的终端集成（它跑命令时能直接捕获终端输出），排错闭环不经过你的手。

## 暗格三：@url、@git-changes、@folder——喂料三连

同族还有三个高频暗号：

- **@url**：贴一个网址，Cline 自动抓取网页转成 Markdown 喂给自己。让它们读一篇文档、一个 API 参考页，不用你开浏览器搬运。
- **@git-changes**：把当前工作区的 Git 改动整段注入。最狠的用法是让 Cline **review 你（或别人）刚写的代码**——diff 就在上下文里，让它照着团队规范挑毛病。
- **@folder**：整个文件夹进上下文，适合“重构这一片”的场景。

这组符号的共性是：**上下文的搬运工不是你**。你只负责下指令，喂料由 Cline 自己完成。国内大部分 AI 插件的用法还停留在“选中代码→问 AI”，这一层认知差就是效率差。

## 暗格四：Checkpoints——改崩了一键悔棋

Cline 每执行一个动作前，会用内部快照机制（官方称为 shadow git）给工作区拍一张快照。聊天气泡旁边会出现 Restore 和 Compare 两个小按钮：

- **Compare**：对比“这一步之前 vs 之后”的代码差异，看清它到底干了什么。
- **Restore**：一键回滚到任意检查点。而且分两档——只回滚代码不回滚对话，或代码对话一起回。

这意味着你可以放心开 Auto-approve（见暗格七）让它撒开跑：跑歪了，点一下回到三步前，换个方向重来。老用户的一致评价是：Checkpoints 是他们敢让 AI 大改代码的心理安全垫。

## 暗格五：.clinerules——给 AI 立项目宪法

在项目根目录建一个名为 `.clinerules` 的纯文本文件，里面写你的团队规范：

```
使用 TypeScript + React，禁用 any
组件用函数式写法，样式走 Tailwind
回复用中文，提交信息用英文
改动前先跑 npm run lint
```

每次任务启动它自动加载，AI 从此“生下来”就懂你家规矩。进阶玩法：建 `.clinerules/` 目录拆成多个文件按主题分（架构、命名、测试），这个目录提交进 Git，**全团队共享同一套 AI 行为准则**。另外还有全局版（放在用户目录）管你所有项目——个人偏好放全局，团队规范放项目级，两层叠加。

这是它和 Trae、灵码这类工具的本质区别：规则是文件，可版本化、可评审、可迁移，不锁死在任何一家产品里。

## 暗格六：.clineignore——密钥文件的防盗门

语法和 .gitignore 一模一样，作用相反：被列进 `.clineignore` 的文件，Cline **读都读不到**：

```
.env
.env.*
**/secrets/
*.pem
```

哪怕你在提示词里让它“打开 .env 看看”，它也会被拒之门外。凡是要把 Cline 用在公司项目里的人，这个文件应该是建仓库第一天就提交的——不然你的 API Key、生产配置会随着上下文流向模型服务商。安全这件事，靠自觉不如靠配置。

## 暗格七：Auto-approve 分档放权，长任务自己跑

每个动作都点 Approve 会把人点疯。Cline 的 Auto-approve 设置是**分档位**的，不是一刀切的全自动：

- 读文件：放（无风险）
- 写文件：放（反正有 Checkpoints 兜底）
- 执行命令：**半放**——开启“白名单命令”功能，只预授权 `npm test`、`git status` 这类安全命令，`rm` 之类仍需人工点头
- 浏览器、MCP 调用：按需放
- 再配一个“最大连续请求数”封顶，防止它无限烧 token

这套灰度机制的精髓是：**风险和自动化程度对齐**。海外玩长任务（比如“把这个模块从 Vue2 迁到 Vue3”）的人，标配就是白名单 + 检查点 + 上限三件套，人只在不放心的时候看一眼。

## 暗格八：/newtask 续命术 + MCP 市场彩蛋

长任务跑着跑着上下文快满了，大多数人的做法是开新会话从头再来。Cline 里输入 `/newtask`，它会自动总结当前任务的进度、关键决策和下一步计划，打包成新任务的起点——相当于给 AI 做了一次“交接班”，任务可以无限滚动下去。新版还加了一键压缩（Condense）和 Focus Chain（自动维护任务清单并勾选进度），长任务管理越来越像正规军。

最后一个彩蛋：设置里的 **MCP Marketplace**。MCP（Model Context Protocol）是给 AI 外挂工具的开放协议，Cline 内置了市场，一键装上 GitHub 操作、浏览器控制、数据库查询等能力，你的 Agent 就从“改代码”升级成“能查库、能提 PR、能开网页验证”的全能选手。更野的用法：直接让 Cline 自己给你写一个定制 MCP server——这是它在海外出圈的名场面，工具不够，让它自己造。

## 八个暗格串成一条流水线

```mermaid
flowchart TD
    A["接需求"] --> B["Plan 档<br/>推理模型出方案"]
    B --> C{"方案满意?"}
    C -->|不满意| D["对话里继续掰扯"]
    D --> B
    C -->|满意| E["切 Act 档<br/>换便宜模型干活"]
    E --> F["逐文件落地<br/>检查点自动快照"]
    F --> G{"跑测报错?"}
    G -->|报错| H["@problems 一键喂报错"]
    H --> F
    G -->|通过| I["/newtask 总结交接<br/>开下一轮"]
```

## 信息差总结

| 你以为的 Cline | 实际上的 Cline |
|---|---|
| 一个替代 Copilot 的免费补全插件 | 一个能读仓库、跑命令、开浏览器的自主 Agent |
| 全程盯着点 Approve，比手写还累 | Auto-approve 分档放权 + 命令白名单，长任务自己跑 |
| 上下文一满就前功尽弃 | /newtask 自动交接总结，任务无限滚动 |
| 改崩了只能靠 Git 兜底 | Checkpoints 每步快照，秒级悔棋还能保留对话 |
| 想用好就得交订阅费 | 插件永久免费开源，BYOK 走 DeepSeek 一天几块钱 |
| 换工具就要重新调教 | .clinerules 是文件，进 Git 可带走，不锁厂商 |

## 行动指南

1. VS Code 插件市场搜 "Cline" 安装（免费，无需注册 Cline 账号）。
2. 去 DeepSeek 开放平台申请一个 API Key 填进 Cline 设置，成本约等于零地先跑起来。
3. 在设置里把 Plan 档和 Act 档绑成两个模型——这是今天回报率最高的一分钟。
4. 项目根目录建 `.clinerules`（团队规范）和 `.clineignore`（屏蔽 .env），一起提交进 Git。
5. 打开 Auto-approve 的“读文件”档 + 命令白名单，丢给它一个真实任务（推荐从“给某个老模块补测试”开始），体验一次完整的 Agent 工作流。

注：文中功能细节以 Cline 官方文档（docs.cline.bot）为准；价格、装机量为写作时公开信息，未能逐项实时复核。

## 参考来源

- Cline GitHub 仓库：https://github.com/cline/cline
- Cline 官方文档（Plan/Act、.clinerules、MCP 等均有专页）：https://docs.cline.bot
- VS Code 插件市场页：https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev
- Cline 官网：https://cline.bot
- r/Cline 社区（海外深度玩法集散地）：https://www.reddit.com/r/Cline/

---
> 本文由「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)
