Get started with Visual Studio Code
'; document.body.appendChild(div.children[0]); }

Get started with Visual Studio Code

Visual Studio Code is a free, open-source code editor for Windows, macOS, and Linux. It brings together multiple ways of working in one tool. Describe a task in natural language and an AI agent plans, edits, and verifies the work. Write code yourself with a powerful editor that has built-in Git, IntelliSense, debugging, and testing tools. Or combine both approaches to get the best of both worlds.

VS Code runs on your desktop or a remote machine, or access it instantly from your browser with VS Code for the Web).

VS Code puts you in control. Choose your language model, whether from your GitHub Copilot subscription or your own API key, and pick the agent that fits the task. Customize VS Code for your technology stack with extensions from the Marketplace, and shape the editor to your workflow with settings, keybindings, and themes.

What you can do with VS Code

VS Code adapts to how you want to work, whether you write every line yourself or hand off tasks to an AI agent. Most workflows combine both.

Get started in three steps

New to VS Code? These three steps take you from a fresh install to building your first app with an AI agent.

  1. Install VS Code. Download the installer for your platform and follow the install steps below.

  2. Enable AI features. Sign in to unlock inline suggestions and AI agents. See Enable AI features.

  3. Take the tutorial. Build an app with the agentic coding tutorial or learn the basics of writing code in VS Code.

Install VS Code

Download the installer for your platform and follow the steps below. VS Code is lightweight and runs on most available hardware. Review the system requirements for details.

VS Code ships weekly Stable releases with auto-update. To preview upcoming features, install the Insiders build, which ships nightly and runs side by side with Stable.

  1. Download the User Setup installer (.exe).
  2. Run the installer and follow the prompts.
  3. VS Code is ready to use. The installer adds code to your PATH so you can open a folder from the terminal with code ..

For System Setup, ZIP archive, or other options, see the full Windows setup guide.

Enable AI features

VS Code has built-in support for AI features like inline suggestions and AI agents that help you with coding tasks. You can get started with AI features by signing in to GitHub and use your GitHub Copilot subscription to get access to a variety of large language models and other AI features in VS Code.

Follow these steps to get started with Copilot in VS Code:

  1. Select Sign In from the VS Code title bar or hover over the Copilot icon in the Status Bar and select Enable AI features.

    Screenshot showing a new VS Code window, highlighting the Copilot icon in the Status Bar and the Sign In button in the VS Code title bar.

  2. Choose a sign-in method and follow the prompts.

    • If you already have a Copilot subscription for your account, VS Code will use that subscription.

    • If you don't have a Copilot subscription yet, you'll be signed up for the Copilot Free plan and get a monthly allowance of inline suggestions and AI credits.

  3. Start using Copilot in VS Code!

Tip

You can also use AI features in VS Code without using a Copilot subscription by bringing your own language model API key. Learn more about using language models in VS Code.

Explore VS Code

Pick a path based on what you want to do next.

Common questions

What are the system requirements for VS Code?

Review the system requirements for supported platforms and hardware.

How big is VS Code?

VS Code is a small download, less than 200 MB, and has a disk footprint of less than 500 MB.

How do I create and run a new project?

VS Code doesn't include a traditional File > New Project dialog or preinstalled project templates. Add additional components and scaffolders based on your development workflow. Scaffolding tools like Yeoman and packages from the npm package manager provide templates and tools to create projects.

How do I know which version I'm running?

On Linux and Windows, choose Help > About. On macOS, use Code > About Visual Studio Code. The About dialog shows the version number and the commit ID. For Insiders builds, multiple builds can share the same version number, so use the commit ID to uniquely identify your build.

Why is VS Code saying my installation is unsupported?

VS Code has detected that some installation files have been modified, perhaps by an extension. Reinstalling VS Code will replace the affected files. See our FAQ topic for more details.

How can I do a 'clean' uninstall of VS Code?

To remove all user data after uninstalling VS Code, delete the user data folders Code and .vscode. This returns VS Code to the state before installation and can reset all settings without uninstalling VS Code.

The folder locations vary depending on your platform:

  • Windows - Delete %APPDATA%\Code and %USERPROFILE%\.vscode.
  • macOS - Delete $HOME/Library/Application Support/Code and ~/.vscode.
  • Linux - Delete $HOME/.config/Code and ~/.vscode.