Setting up Visual Studio Code

Getting up and running with Visual Studio Code is quick and easy. It is a small download so you can install in a matter of minutes and give VS Code a try.

Cross platform

VS Code is a free code editor which runs on the Mac, Linux and Windows operating systems.

Follow the platform specific guides below:

VS Code is lightweight and should run on most available hardware and platform versions. You can review the System Requirements to check if your computer configuration is supported.

Update cadence

VS Code releases a new version each month with new features and important bug fixes. Most platforms support auto updating and you will be prompted to install the new release when it becomes available. You can also manually check for updates by running Help > Check for Updates....

Note: You can disable auto-update if you prefer to update VS Code on your own schedule.

Insiders nightly build

If you'd like to try our nightly builds to see new features early or verify bug fixes, you can install our Insiders build. The Insiders build installs side-by-side with the monthly Stable build and you can freely work with either on the same machine. The Insiders build is the same one the VS Code development team uses on a daily basic and we really appreciate people trying out new features and providing feedback.

Additional components

VS Code is an editor first and foremost and prides itself on a small footprint. Unlike traditional IDEs with everything but the kitchen sink, you can tune your installation to the development technologies you care about. Be sure to read the Additional Components topic after reading the platform guides to learn about customizing your VS Code installation.

Extensions

VS Code extensions let third parties add support for additional:

Extensions integrate into VS Code's UI, commands, and task running systems so you'll find it easy to work with different technologies through VS Code's shared interface. Check out the VS Code extension Marketplace to see what's available.

Proxy server support

Many enterprises require that their computers run behind a proxy server and don't allow direct access to the Internet. A proxy server intermediary can limit access to the VS Code Extension Marketplace and prevent installing VS Code extensions.

If you work on a machine where Internet traffic needs to go through a proxy server, then configure the proxy server in one of the following ways:

  • Set the operating system environment variables http_proxy and https_proxy
    SET http_proxy=https://10.203.0.1:5187/
  • Configure the http.proxy setting in your user settings (File > Preferences > Settings or Code > Preferences > Settings on Mac):
    "http.proxy": "https://10.203.0.1:5187/"

or for an authenticating proxy

    "http.proxy": "https://userid:password@10.203.0.1:5187/"

Additionally, use "http.proxyStrictSSL": false if your proxy server uses a self-signed certificate.

Note: VS Code supports http and https proxies, but not SOCKS proxies.

Next Steps

Once you have installed and set up VS Code, these topics will help you learn more about VS Code:

If you'd like to getting something running quickly, try the Node.js tutorial walkthrough which will have you debugging a Node.js web application with VS Code in minutes.

Common Questions

Q: What are the system requirements for VS Code?

A: We have a list of System Requirements.

Q: How big is VS Code?

A: VS Code is a small download (< 100 MB) and has a disk footprint of less than 200 MB, so you can quickly install VS Code and try it out.

Q: How do I create and run a new project?

A: VS Code doesn't include a traditional File > New Project dialog or pre-installed project templates. You'll need to add additional components and scaffolders depending on your development interests. With scaffolding tools like Yeoman and the multitude of modules available through the NPM package manager, you're sure to find appropriate templates and tools to create your projects.

Q: How do I know which version I'm running?

A: On Linux and Windows, choose Help > About. On Mac, use Code > About Visual Studio Code.

Q: Why is VS Code saying my installation is corrupt?

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