How to install and use Cline in VS Code: API setup, Plan and Act modes, first codebase task
Install Cline, wire an API provider, ask a read-only Plan question, then approve your first small Act edit.
To run your first Cline job in VS Code, install the Marketplace extension, configure an API Provider, explore in Plan mode, then switch to Act for a small approved change.
Facts follow docs.cline.bot setup and provider pages plus Marketplace Cline (saoudrizwan.claude-dev, formerly Claude Dev). Queries: Cline VS Code install, Cline Plan Act mode. For a short huddle see sitdraw and create and join a room.
Plan vs Act
Plan
Read the repo, search, and strategize—no file edits or terminal commands.
Act
Keeps planning context; can edit files and run commands in a visible terminal with your Approve on each step.
| Goal | Entry | First-hour check |
|---|---|---|
| Wire a model | Cline ⚙️ → API Provider | Provider + model selected; chat sends |
| Plan pass | Plan + read-only prompt | Answers cite real paths; no unapproved diffs |
| Act pass | Act + small task | Review diff → Approve → run local tests |
| Split models | Use different models for Plan and Act | Strong planner, faster actor (optional) |
Install, API, Plan/Act, first repo task
- 01Install Cline
Extensions → search
Cline(publisher Cline, idsaoudrizwan.claude-dev) → Install. Quick Open:ext install saoudrizwan.claude-dev. Open a folder workspace, not a loose file. - 02Configure API Provider
Open Cline → ⚙️ → pick Anthropic, OpenAI, OpenRouter, Gemini, etc., paste keys per
docs.cline.bot(or sign in to Cline Provider where documented). Choose a Model; optionally set separate Plan/Act models. - 03Plan: first read-only task
Stay in Plan. Ask how a feature flows through modules; add
@folderor@filecontext. Confirm no file edits are waiting for approval. - 04Act: first small change
Switch to Act—e.g. add a docstring without behavior changes. Approve each diff and terminal command; run existing tests. Never paste secrets.
# First hour · Cline · VS Code · 2026-09
# ext install saoudrizwan.claude-dev · folder workspace
# ⚙️ API Provider + Model · Plan read-only · Act small edit
# docs.cline.bot/core-workflows/plan-and-act
# marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev- Which extension if I search Claude Dev?
- Install publisher Cline, id
saoudrizwan.claude-dev. - It tries to edit in Plan?
- Switch to Plan mode; complex work may use official
/deep-planningper docs.cline.bot. - Compare Codeium or Qodo?
- Cline is a multi-step agent with terminal access; see our Codeium guide and Qodo guide.
- Whiteboard?
- No—open sitdraw for diagrams.
Plan before Act
Keep the first Act task to one module and review every command before approval.