Get started with Visual Studio Code

Visual Studio Code is a free, open-source code editor for Windows, macOS, and Linux. Write code yourself with a powerful editor, or describe a task in natural language and let an AI agent plan, edit, and verify the work. Combine both approaches to fit how you like to work.

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

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.

Get started with VS Code

Complete your first coding task with an AI agent in VS Code.

Prefer to write code yourself first? Start with the editor tutorial instead.

Get started in three steps

New to VS Code? These three steps take you from a fresh install to your first project.

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

  2. Open your code. Open an existing folder, clone a repository from GitHub, or create a new file to start working.

  3. Choose how you want to work. Complete a task with the agents quickstart, or learn the basics of writing code yourself. The agents quickstart walks you through signing in to enable AI features. AI features are optional. You can use VS Code fully as a traditional editor without signing in.

Install VS Code

  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.

Review the system requirements for details.

Enable AI features

VS Code has built-in support for AI features like inline suggestions and AI agents that help you with coding tasks. Sign in with 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.

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. Choose your language model, whether from your GitHub Copilot subscription or your own API key, and pick the agent that fits the task.

Explore VS Code

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

More ways to use VS Code

Common questions

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.

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 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.