如何使用 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 项 Clinesaoudrizwan.claude-dev,前身 Claude Dev)。检索词 Cline VS Code 安装Cline Plan Act 模式。这是 Cline 产品,不是本站会议工具。短会见 sitdraw,步骤见 如何创建与加入房间

装扩展APIPlan → Act

Plan 与 Act 各做什么

Plan 模式

可读仓库、搜索、讨论方案,不会改文件、不跑终端命令。适合先问「这段逻辑在哪被调用」或梳理改动范围。

Act 模式

保留 Plan 对话上下文,可编辑文件、在可见终端里跑命令;每一步 diff 与命令需你点批准,Human-in-the-loop。

Plan只读探索
Act执行改动
@file注入上下文
目标入口第一次怎么验收
配置模型Cline 面板 ⚙️ → API Provider选好 Provider 与 Model,状态栏能发起对话
Plan 摸底切换到 Plan,描述只读问题收到文件引用与步骤说明,无未批准 diff
Act 实现Act,给可执行指令审阅 proposed edit → Approve → 本地跑测试
分模式用不同模型设置里 Use different models for Plan and ActPlan 用强推理模型、Act 用更快模型(可选)

安装、API、Plan/Act 与首个仓库任务

  1. 01
    安装 Cline 扩展

    扩展视图 Cmd+Shift+X 搜索 Cline,选发布者 Cline、ID saoudrizwan.claude-dev → Install。Quick Open:ext install saoudrizwan.claude-dev。用 File → Open Folder 打开整个仓库,不要只开单文件。

  2. 02
    配置 API Provider

    活动栏打开 Cline,点 ⚙️。在 API Provider 下拉选 Anthropic、OpenAI、OpenRouter、Google Gemini 等,填入对应 API Key(或按 docs 使用 Cline Provider / OAuth)。选 Model,可先留默认;需要时在设置里为 Plan/Act 分别指定模型。

  3. 03
    Plan 模式:第一个只读任务

    确认当前为 Plan。输入例如:「用 @folder src 说明用户登录流程经过哪些模块,不要改代码。」必要时用 @file 点名文件。核对回答是否引用真实路径;此阶段不应出现待批准的文件编辑。

  4. 04
    Act 模式:第一个可合并的小改动

    切到 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;批准命令前看清工作目录与脚本内容。

开始画