如何使用 Cline 在 VS Code:安装扩展、API Provider、Plan/Act 与首个代码库任务
安装 Cline、配置 API,在 Plan 里问清模块关系,再在 Act 里批准第一个 docstring 或测试级小改动。
要在 VS Code 里用 Cline 做自主编码任务,先完成四步:Marketplace 安装 Cline 扩展、在面板里配置 API Provider、在 Plan 模式摸清范围,再切到 Act 执行首个小改动并逐项批准。
对照 docs.cline.bot 的安装与 Provider 文档,以及 Marketplace 项 Cline(saoudrizwan.claude-dev,前身 Claude Dev)。检索词 Cline VS Code 安装、Cline Plan Act 模式。这是 Cline 产品,不是本站会议工具。短会见 sitdraw,步骤见 如何创建与加入房间。
Plan 与 Act 各做什么
Plan 模式
可读仓库、搜索、讨论方案,不会改文件、不跑终端命令。适合先问「这段逻辑在哪被调用」或梳理改动范围。
Act 模式
保留 Plan 对话上下文,可编辑文件、在可见终端里跑命令;每一步 diff 与命令需你点批准,Human-in-the-loop。
| 目标 | 入口 | 第一次怎么验收 |
|---|---|---|
| 配置模型 | Cline 面板 ⚙️ → API Provider | 选好 Provider 与 Model,状态栏能发起对话 |
| Plan 摸底 | 切换到 Plan,描述只读问题 | 收到文件引用与步骤说明,无未批准 diff |
| Act 实现 | 切 Act,给可执行指令 | 审阅 proposed edit → Approve → 本地跑测试 |
| 分模式用不同模型 | 设置里 Use different models for Plan and Act | Plan 用强推理模型、Act 用更快模型(可选) |
安装、API、Plan/Act 与首个仓库任务
- 01安装 Cline 扩展
扩展视图
Cmd+Shift+X搜索Cline,选发布者 Cline、IDsaoudrizwan.claude-dev→ Install。Quick Open:ext install saoudrizwan.claude-dev。用 File → Open Folder 打开整个仓库,不要只开单文件。 - 02配置 API Provider
活动栏打开 Cline,点 ⚙️。在 API Provider 下拉选 Anthropic、OpenAI、OpenRouter、Google Gemini 等,填入对应 API Key(或按 docs 使用 Cline Provider / OAuth)。选 Model,可先留默认;需要时在设置里为 Plan/Act 分别指定模型。
- 03Plan 模式:第一个只读任务
确认当前为 Plan。输入例如:「用 @folder src 说明用户登录流程经过哪些模块,不要改代码。」必要时用
@file点名文件。核对回答是否引用真实路径;此阶段不应出现待批准的文件编辑。 - 04Act 模式:第一个可合并的小改动
切到 Act,基于 Plan 结论下达小任务,例如「给 auth 模块的入口函数补英文 docstring,不改行为」。逐条 Approve diff 与终端命令;完成后本地跑现有测试或 lint。不要把
.env或密钥贴进对话。
# First hour · Cline · VS Code · 2026-09
# 1. ext install saoudrizwan.claude-dev · Open Folder workspace
# 2. Cline ⚙️ → API Provider + Model (or Cline Provider per docs.cline.bot)
# 3. Plan: read-only codebase question · @file / @folder
# 4. Act: small docstring or test · approve each diff/command
# Docs: docs.cline.bot · Plan & Act: docs.cline.bot/core-workflows/plan-and-act
# Marketplace: marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev- 搜 Claude Dev 装哪个?
- 装发布者为 Cline、ID
saoudrizwan.claude-dev的项;旧名 Claude Dev 已 rebranding 为 Cline。 - Plan 里它想改文件?
- Plan 模式设计上只读;若界面仍在 Act,先切回 Plan。复杂需求可查阅官方
/deep-planning说明(docs.cline.bot)。 - 和 Codeium、Qodo 怎么选?
- Cline 偏多步 Agent + 终端 + 批文件编辑;Codeium 偏补全;Qodo 偏审查与测试生成。可对照 Codeium 教程 与 Qodo 教程。
- 装完能当架构白板吗?
- 不能。要对齐模块图时开 sitdraw。
先 Plan 再 Act
首个任务控制在单模块、可审查的小 diff;批准命令前看清工作目录与脚本内容。