Skip to main content

Windows Setup Guide

Complete setup guide for Claude Code, VS Code, and Git/GitHub on Windows

78 minutes
7 min read
Updated September 21, 2026
windows

By the end of this guide, you'll have a professional development environment on Windows—the same setup used by developers at Microsoft, Google, and thousands of startups.

Your Setup Checklist

  • Windows Terminal (modern terminal experience)
  • VS Code installed and working from terminal
  • Git configured with your identity
  • GitHub account with SSH authentication
  • Node.js for development tools
  • Claude Code extension signed in
  • Python or R (optional, for data analysis)
What We're Setting Up
Each tool unlocks the next

Part 1: Windows Terminal — Your Command Center

Forget the old black Command Prompt. Windows Terminal is modern, tabbed, and beautiful. You'll use it constantly.

  1. 1

    Install from Microsoft Store

    1. Open Microsoft Store (search for it in Start)
    2. Search for Windows Terminal
    3. Click Get or Install
    4. Pin it to your taskbar (right-click → Pin to taskbar)

Part 2: VS Code — Your Code Editor

VS Code is where you'll spend most of your time. It's free, fast, and the most popular editor in the world.

  1. 1

    Download and Install

    1. Go to code.visualstudio.com
    2. Click Download for Windows
    3. Run the installer (.exe file)
    4. Critical: Check these boxes during installation:
    • ✅ Add "Open with Code" to file context menu
    • ✅ Add "Open with Code" to folder context menu
    • ✅ Add to PATH (most important!)
  2. 2

    Verify Installation

    Open Windows Terminal and run:

    powershell
    code --version

    You should see a version number like 1.85.0.


Part 3: Git — Never Lose Your Work Again

Git tracks every change you make. Made a mistake? Go back. Want to experiment? Create a branch. Collaborating? Merge your changes.

Why Git Matters
Your code is always safe
  1. 1

    Download Git for Windows

    1. Go to git-scm.com/download/win
    2. Download should start automatically
    3. Run the installer
  2. 2

    Installation Options

    Most defaults are fine, but watch for these:

    OptionChoose
    Default editorUse Visual Studio Code
    PATH environmentGit from command line and 3rd-party software
    HTTPS transportUse the OpenSSL library
    Line endingCheckout Windows-style, commit Unix-style
    TerminalUse Windows' default console window
    Credential helperGit Credential Manager
  3. 3

    Configure Your Identity

    Open Windows Terminal and set your name and email:

    powershell
    git config --global user.name "Your Name"
    git config --global user.email "your.email@example.com"
  4. 4

    Set Sensible Defaults

    powershell
    # Use VS Code for commit messages
    git config --global core.editor "code --wait"
    # Default branch name (GitHub standard)
    git config --global init.defaultBranch main
    # Handle Windows line endings correctly
    git config --global core.autocrlf true
    # Handy shortcuts
    git config --global alias.st status
    git config --global alias.co checkout
    git config --global alias.br branch

    Verify:

    powershell
    git --version
    git config --list

Part 4: GitHub — Your Code's Home in the Cloud

GitHub is where your code lives online. It's also where you'll collaborate with others and showcase your work.

Local vs Remote
Git works locally; GitHub stores your code in the cloud
  1. 1

    Create a GitHub Account

    1. Go to github.com
    2. Click Sign up
    3. Pick a professional username (this shows up on your profile)
  2. 2

    Generate SSH Key

    SSH keys let you push code to GitHub without entering your password every time.

    powershell
    ssh-keygen -t ed25519 -C "your.email@example.com"

    When prompted:

    • File location: Press Enter (accept default)
    • Passphrase: Type one (or press Enter for none)
    • Confirm: Press Enter
  3. 3

    Start SSH Agent

    Run these commands in PowerShell (you may need Administrator mode):

    powershell
    # Enable the SSH agent service
    Get-Service -Name ssh-agent | Set-Service -StartupType Manual
    Start-Service ssh-agent
    # Add your key
    ssh-add $env:USERPROFILE\.ssh\id_ed25519
  4. 4

    Add Key to GitHub

    Copy your public key:

    powershell
    Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

    Now add it to GitHub:

    1. Go to github.com/settings/keys
    2. Click New SSH key
    3. Title: "My Windows PC" (or whatever you want)
    4. Key type: Authentication Key
    5. Paste with Ctrl + V
    6. Click Add SSH key
  5. 5

    Test the Connection

    powershell
    ssh -T git@github.com

    If you see a warning about authenticity, type yes and press Enter.


Part 5: Node.js — Foundation for Modern Tools

Node.js powers many development tools, including Claude Code.

  1. 1

    Download and Install

    1. Go to nodejs.org
    2. Download the LTS (Long Term Support) version
    3. Run the installer
    4. Accept defaults, but check this option:
  2. 2

    Verify Installation

    powershell
    node --version # Should show v20+ or similar
    npm --version # Should show 10+ or similar

Part 6: Claude Code — Your AI Coding Partner

Now the reason you're here. Claude Code understands your entire codebase and can read files, write code, run commands, and help you ship real projects.

If you'd rather watch the install before doing it, this covers the same ground as the steps below.Watch on YouTube

Part 7: Python (For Data Analysis)

  1. 1

    Download and Install

    1. Go to python.org/downloads
    2. Download Python 3.11.x (latest stable)
    3. Run the installer
    4. Critical: Check "Add Python to PATH"
    5. Click "Install Now"
  2. 2

    Verify Installation

    powershell
    python --version
    pip --version
  3. 3

    Create a Virtual Environment

    Virtual environments keep each project's packages separate (trust us, you want this):

    powershell
    mkdir ~\projects
    cd ~\projects
    mkdir my-first-project
    cd my-first-project
    # Create virtual environment
    python -m venv venv
    # Activate it
    .\venv\Scripts\Activate.ps1

    Your prompt now shows (venv) — you're in the virtual environment.

  4. 4

    Install Data Science Packages

    powershell
    pip install pandas numpy matplotlib jupyter

    When done working:

    powershell
    deactivate

Part 8: R (Optional)

  1. Go to cran.r-project.org/bin/windows/base
  2. Download and install R
  3. For RStudio: posit.co/download/rstudio-desktop

Verify Your Setup

Run this checklist to confirm everything works:

powershell
# Should all return version numbers
code --version
git --version
node --version
npm --version
python --version # If installed
# Should authenticate successfully
ssh -T git@github.com

Troubleshooting


Quick Reference: Keyboard Shortcuts

ActionShortcut
Open Command Palette (VS Code)Ctrl + ⇧ + P
Open Extensions (VS Code)Ctrl + ⇧ + X
Open Terminal in VS CodeCtrl + `
New Terminal TabCtrl + ⇧ + T
Clear Terminalcls command
Cancel Running CommandCtrl + C

Windows vs Mac: Quick Differences

ConceptWindowsMac
TerminalWindows Terminal / PowerShellTerminal.app
Path separator\ (backslash)/ (forward slash)
Home folder~ or $env:USERPROFILE~
Open VS Codecode .code .
Package managerwinget (or Chocolatey)Homebrew

What's Next?

Your Windows PC is ready. Here's where to go:

Or try the Quick Start Exercise to test your setup with Claude Code.

Share this article