VS Code (Visual Studio Code) download and installation complete walkthrough
Installing VS Code takes just a few minutes

📑Table of Contents
  1. Visit the VS Code Official Website
  2. Download VS Code
  3. Installing on macOS
  4. Installing on Windows
  5. Verify the First Launch
  6. Setting Up the Command Line
  7. FAQ
  8. Related articles
  9. Conclusion

VS Code (Visual Studio Code) is a free, open-source code editor developed by Microsoft. Lightweight yet packed with features and extensions, it’s the most popular editor among developers worldwide. In this guide, we walk you through downloading and installing VS Code on both macOS and Windows, step by step with screenshots.

Visit the VS Code Official Website

Start by visiting the VS Code official website.

Official site: https://code.visualstudio.com/

On the homepage, you’ll see a download button tailored to your operating system right in the center.

VS Code official website homepage showing the Download for macOS button
VS Code official website homepage

Download VS Code

Click the “Download for macOS” button (or “Download for Windows” if you’re on Windows).

The download will start automatically. You should see the message “Your download of Visual Studio Code should start shortly.”

VS Code download started page showing Your download should start shortly message
Download started confirmation page

💡 If the download doesn’t start automatically

Click the “Direct download link” on the page to download manually.

Download Options

The download page offers detailed options for each platform.

VS Code download page showing options for macOS, Windows, and Linux platforms
Platform-specific download options
  • macOS: Intel chip / Apple silicon / Universal — choose “Universal” if unsure, it works on both Mac types
  • Windows: User Installer / System Installer / .zip — “User Installer” is the standard choice for most users

Installing on macOS

VS Code macOS installation steps — extracting zip and moving to Applications folder
macOS installation steps

📝 macOS Installation Steps

  1. Double-click the downloaded .zip file to extract it
  2. Drag Visual Studio Code.app into your Applications folder
  3. Open VS Code from the Applications folder (or Launchpad)
  4. If you see a warning saying the app was “downloaded from the Internet,” click “Open”
  5. (Optional) Right-click the VS Code icon in the Dock → “Options” → “Keep in Dock” for quick access

Installing on Windows

📝 Windows Installation Steps

  1. Double-click the downloaded .exe installer to run it
  2. Accept the license agreement and click “Next”
  3. Confirm the installation folder (the default is fine) and click “Next”
  4. On the “Select Additional Tasks” screen, check the recommended options below:

⚠️ Important: Recommended Additional Tasks

  • ✅ “Add to PATH” — Lets you launch VS Code from the terminal with the code command. Highly recommended
  • ✅ “Add ‘Open with Code’ to file context menu” — Right-click any file to open it in VS Code
  • ✅ “Add ‘Open with Code’ to directory context menu” — Right-click any folder to open it in VS Code
  1. Click “Install” to begin the installation
  2. On the final screen, check “Launch Visual Studio Code” and click “Finish”

Verify the First Launch

After installation, VS Code will open and display the Welcome tab. If you see this, the installation was successful.

💡 Want VS Code in Your Language?

To change the UI language, press Ctrl+Shift+X (or Cmd+Shift+X on macOS) to open the Extensions panel, search for your language pack (e.g., “Japanese Language Pack”), install it, and restart VS Code.

Setting Up the Command Line

Being able to type code . in your terminal to open the current directory in VS Code is incredibly convenient for developers.

macOS

VS Code command line setup — Shell Command Install code command in PATH via Command Palette
Setting up the command line on macOS
  1. Open VS Code
  2. Press Cmd+Shift+P to open the Command Palette
  3. Type and select “Shell Command: Install ‘code’ command in PATH”
  4. Restart your terminal — now code . will open VS Code

Windows

If you checked “Add to PATH” during installation, no additional setup is needed. Open PowerShell or Command Prompt and try code .

💡 Forgot to add to PATH?

The easiest fix is to re-run the VS Code installer and check the “Add to PATH” option on the Additional Tasks screen.

FAQ

Is VS Code completely free?

Yes, VS Code is free and open source (MIT license). Most extensions are also free, though some like GitHub Copilot require a separate subscription.

Is VS Code the same as Visual Studio?

No, they are different products. VS Code is a lightweight code editor, while Visual Studio is a full-featured IDE. VS Code runs on macOS, Windows, and Linux, whereas Visual Studio is primarily for Windows.

What should I set up first after installing?

Install a language pack if needed, choose a theme you like, and set up the code command in your PATH so you can launch VS Code from the terminal.

Do I need to uninstall an old version first?

No, VS Code supports in-place updates. Your settings and extensions will carry over automatically.

Does VS Code support AI-assisted coding?

Yes, via the GitHub Copilot extension. For more advanced AI features, VS Code-based editors like Cursor and Devin Desktop (formerly Windsurf) are also worth considering. See our AI Code Editor Comparison for details.

krona23

Author

krona23

Over 20 years in the IT industry, serving as Division Head and CTO at multiple companies running large-scale web services in Japan. Experienced across Windows, iOS, Android, and web development. Currently focused on AI-native transformation. At DevGENT, sharing practical guides on AI code editors, automation tools, and LLMs in three languages.

DevGENT about →

Conclusion

Installing VS Code in 3 Simple Steps

  1. Download from the official website
  2. macOS: move to Applications. Windows: run the installer (don’t forget to add to PATH)
  3. Launch and see the Welcome screen — you’re ready to code

Want to learn more about what VS Code can do? Check out our detailed guide.
👉 What Is VS Code? Features and Complete Guide
👉 AI Editor Comparison

Leave a Reply

Trending

Discover more from DevGENT

Subscribe now to keep reading and get access to the full archive.

Continue reading