two ways to run Claude Code: in VS Code (this guide), or in the Claude desktop app with no editor at all. prefer the app? see how to set up Claude Code | Claude app.
install VS Code (your workspace)
VS Code is a free app from Microsoft. think of it as the window Claude Code lives in — you’ll do everything inside it, so you never have to hunt around your computer.
- go to code.visualstudio.com/download.
- download the version for your computer. on a Mac, if you’re unsure which to pick, choose Universal. on Windows, click the blue Windows button.
- on Mac: open the downloaded file, then drag the Visual Studio Code icon into your Applications folder. open it from there.
- on Windows: open the downloaded installer and click through it, the default options are fine. launch VS Code when it’s done.
add the Claude Code extension
the extension is the whole install — Claude Code comes bundled inside it, so there’s nothing to type into a terminal.
- click the Extensions icon in the left bar (four small squares), or press
Cmd+Shift+Xon Mac /Ctrl+Shift+Xon Windows. - in the search box, type
Claude Codeand install the one published by Anthropic. - if VS Code asks, click Reload. a Claude ✱ icon now appears in the left bar.
Windows only — also install Git from git-scm.com/downloads/win (the default options are fine), then restart VS Code. Claude uses it to run commands. most Macs already have it, so Mac users can skip this.
open a project folder
Claude works inside one folder at a time. give it an empty one. click File → Open Folder, then create or pick an empty folder (name it
edgeful). VS Code reopens with that folder.open Claude and sign in
click the Claude ✱ icon in the left bar to open the panel, then click Sign in. your browser opens — log in with your Claude Pro or Max account and you’ll be sent back to VS Code automatically.
being logged into claude.ai in your browser isn’t enough — Claude Code has its own sign-in. you only do this once.
you're ready
Claude Code is now running on your machine. head to set up API with your AI agent and paste the prompt — it connects the edgeful API, installs the dashboard skill, and makes a verified first call.