Cline (VS Code 插件) 使用指南

Cline（原名 Claude Dev）是一款开源、强大的 VS Code 编程助手插件。它以其能够执行复杂的 Agent 任务（如运行终端命令、读写文件、甚至使用浏览器）而闻名，是目前 Windsurf 和 Cursor 的强力竞争对手。

---

1. 为什么选择 Cline？

• 完全开源：完全免费且开源，不用担心隐私问题，代码透明。
• MCP 支持：支持 Model Context Protocol (MCP)，这意味着你可以轻松连接本地数据库、GitHub、Slack 等外部工具，扩展 AI 的能力。
• 多模型支持：不像 Cursor 绑定特定模型，Cline 允许你自由配置 API（OpenAI, Anthropic, Gemini, DeepSeek, Ollama 等）。
• 自主 Agent：Cline 不仅仅是补全代码，它拥有“执行循环”，可以连续执行：写代码 -> 运行报错 -> 读取报错 -> 修复代码 -> 再次运行，直到成功。

2. 安装与配置

2.1 安装

1. 打开 VS Code 扩展市场。
2. 搜索 Cline (或者搜旧名 Claude Dev).
3. 点击安装。

2.2 配置 API Provider

点击侧边栏的机器人图标，进入设置：

• API Provider: 选择你拥有的 Key。推荐 Anthropic (Claude 3.5 Sonnet)，因为它的编程能力目前最强，且支持 Tool Use 最流畅。
• DeepSeek: 如果追求性价比，选择 OpenAI Compatible，输入 DeepSeek 的 BaseURL 和 Key。
• Ollama: 如果本地显卡够强，可以选择本地模型。

3. 核心功能

3.1 Task (任务模式)

Cline 的交互基于“Task”。你给它一个目标，例如：“帮我创建一个 Python 的爬虫，爬取 Hacker News 首页标题并保存为 CSV。”

Cline 会执行以下步骤（并每一步征求你同意，或设为自动批准）：

1. 分析目录：读取当前文件结构。
2. 创建文件：新建 scraper.py。
3. 写入代码：编写爬虫逻辑。
4. 运行终端：自动帮你执行 python scraper.py。
5. 检查结果：如果报错，它会读取终端输出，自动修改代码，再次运行。

3.2 Add Context (添加上下文)

• @url: 让 Cline 阅读特定网页内容。
• @file / @folder: 引用项目中的文件。
• 截图: 可以直接粘贴截图到对话框，让它照着 UI 图写前端代码。

3.3 MCP 工具集成 (高阶)

通过配置 MCP Server，Cline 可以获得“超能力”。

• 连接 GitHub: 让 Cline 直接提 PR，Review 代码。
• 连接 SQLite: 让 Cline 直接查询本地数据库数据。
• 使用 Brave Search: 让 Cline 具备联网搜索最新文档的能力。

配置方法通常是在 settings/claude_mcp_settings.json 中配置 Server 的启动命令。

4. 最佳实践

• Always Approve (自动批准)：默认情况下，Cline 的每一步文件读写和终端执行都需要人工点击 "Approve"。对于信任的任务，可以勾选 "Auto-approve"，让它极速飞驰。
• Prompts: Cline 允许自定义 System Prompt。你可以在这里设定你的编码规范（如“总是使用 TypeScript，使用 Arrow Functions”）。
• 结合 DeepSeek: 考虑到 Claude 费用较高，可以将 DeepSeek V3 配置为默认模型，在遇到极难问题时再临时切换回 Claude 3.5 Sonnet。

---

最后更新：2025-12