Claude Code

Running Claude Code on Windows

Claude Code itself runs on Windows: it is an npm package, and if Node.js runs, it runs. The decisions worth getting right are where you install it, whether that is native Windows or WSL2, and how you keep several agents from trampling each other once one stops being enough.

By Kylian Migot · Updated July 2026 · 7 min read

Quick answer

Yes, Claude Code runs on Windows. It ships as an npm package, so the real requirement is Node.js and a terminal rather than a particular Windows version. You can install it natively or inside WSL2, and the right answer is simply wherever your repository and toolchain already live. What is not on Windows yet is AIDEN, the desktop workspace this site sells: it is macOS 12+ today, and the Windows build is in Microsoft Store certification with no date announced. Everything on this page below the install section works for you today, with or without us.
Claude Code CLI on Windows
Supported. Needs Node.js and a terminal
Native or WSL2
Both work — match whichever side your code is on
AIDEN desktop app
macOS 12+ today; Windows in Microsoft Store certification, no date
Windows waitlist
Open, in section 03. One email the day it ships
01

Yes, It Runs on Windows, and Here Is the Install

The question behind most "claude code windows" searches is whether this is a Mac-only tool, and it is not. Claude Code is a command-line program distributed through npm, and this site has said for a while that it runs on macOS, Linux and Windows with Node.js and a terminal as the only real prerequisites. There is no separate Windows edition to hunt for and no port to wait on.

Installing Claude Code on Windows 10 or 11

The Windows version is not the gate. Node.js is. If Node runs on your machine, the install is the same three steps it is everywhere else, from PowerShell or Windows Terminal:

  1. 1

    Install Node.js

    Anything that gives you a working npm on PATH. This is the only step where a Windows-specific decision exists at all, and it is the ordinary one: installer, winget, or a version manager, whichever your team already standardises on.
  2. 2

    Install the CLI globally

    npm install -g @anthropic-ai/claude-code. Same package, same command, same registry as on any other platform.
  3. 3

    Run it inside a git repository

    cd into a repo and run claude. On first run it walks you through signing in with either a Claude subscription or an Anthropic API key. It wants a git repository, not just a folder, because that is what makes its edits reviewable and reversible.
npm install -g @anthropic-ai/claude-code
cd C:\path\to\your\repo
claude
02

Native Windows or WSL2: One Rule Decides It

This is the only genuinely Windows-shaped decision in the whole setup, and it is asked far more often than it is answered usefully. Both work. The rule that resolves it is not about Claude Code at all:

Your project builds on Windows → install on Windows

.NET, MSVC, a Windows-targeted game or desktop app, or a team whose scripts assume PowerShell. Put Claude Code in the same shell you already use. Adding WSL2 here means the agent edits files through a filesystem boundary and runs tests in an environment that is not the one you ship from.

You already develop inside WSL2 → install inside WSL2

If your repo lives under the Linux filesystem and your toolchain is apt-installed, install Claude Code inside the distro. From the CLI's point of view this is simply a Linux install, and every Linux instruction you find applies unchanged.

Do not straddle the two

The setup that reliably disappoints people is a repository on the Windows filesystem driven by an agent running inside WSL2, or the reverse. It usually works, and it is slower and stranger than either clean option, which makes every unrelated problem harder to diagnose.

Git is where it shows up first

Line endings and file permissions are the classic cross-boundary surprise, and an agent making dozens of edits surfaces it faster than you would by hand. Whatever you decide, settle git's line-ending configuration for the repository before you point an agent at it, not after your first thousand-line whitespace diff.

None of the above is a Claude Code limitation, which is worth saying plainly because a lot of writing on this topic implies it is one. It is the ordinary cost of running two operating systems on one box, and it applies identically to any other agent CLI you point at the same repository.

03

Where AIDEN Stands on Windows

Now the part where this site has an interest, stated without decoration. AIDEN is a macOS 12+ desktop app today, on Apple Silicon and Intel, signed and notarized. It is a workspace that drives your own installed Claude Code and Codex CLIs: several agents visible at once, a git worktree per story, a board that outlives the session, and a spec you approve before any code is written. The GUI for Claude Code page is the full description of what it does.

The Windows build is in Microsoft Store certification. That is the whole status, and it is deliberately not a date. Store certification is not a timeline we control, and on this audience a missed date costs more than a vague one. What we will commit to is the email: one message, the day the build is available, to the address you leave below.

Status today
Claude Code CLI on WindowsWorks. Installed and authenticated by you (section 01)
AIDEN on macOS 12+Available. Apple Silicon and Intel, signed and notarized
AIDEN on WindowsIn Microsoft Store certification. No date announced
AIDEN on Linux / mobileOn the waitlist. Nothing is in certification for these

Get the Windows build the day it clears certification

One email when the Windows build is downloadable. No newsletter, no drip sequence, no pre-order, and nothing to pay. If you would rather not leave an address, the rest of this page still works for you.

04

Running Several Agents on Windows, Today

The reason people come looking for a desktop app is rarely the install. It is what happens at the third agent, and that problem arrives on Windows exactly as it does on macOS. Two Claude Code sessions pointed at the same checkout overwrite each other's files, stage each other's changes, and fight over the same dev-server port. None of the fixes for that are macOS-only.

One worktree per agent

git worktree is part of git, so it is available to you on Windows right now. Give each agent its own linked working directory on its own branch and the three collision classes above disappear. The manual recipe is the same set of commands on every platform.

One task per session, written down

Claude Code's todo list is scoped to the session that created it, which is documented behaviour: it goes when the session goes. Until you have a board, the substitute is a file in the repo that survives the terminal, and it is worth the discipline well before you install anything.

A port per agent

Two agents running the same dev server on the same port is the failure that looks like the model went wrong. Pin a port per worktree, whether that is an env var, a compose override, or a convention, before you scale past two.

Review is the real ceiling

Git handles hundreds of worktrees; your attention does not. The limit on parallel agents is how many diffs you can read carefully, which is a constraint no tool on any platform removes.

The full manual recipe, and what it costs to keep doing it by hand, is in running parallel agents with git worktrees. The progression from terminal tabs to something you can actually keep track of is in managing multiple Claude Code sessions, and how stories queue, branch and become pull requests is in Claude Code orchestration. All three describe techniques first and AIDEN second, which is the honest order for a reader who cannot install AIDEN today.

FAQ

Does Claude Code work on Windows?
Yes. Claude Code is distributed as an npm package and runs on macOS, Linux and Windows; the only real prerequisites are Node.js and a terminal. You install it with npm install -g @anthropic-ai/claude-code, open a terminal in a git repository, and run claude. On first run it walks you through signing in with either a Claude subscription or an Anthropic API key.
How do I install Claude Code on Windows 11?
The same way as on Windows 10, because the operating system version is not the gate — Node.js is. Install Node.js, open PowerShell or Windows Terminal, run npm install -g @anthropic-ai/claude-code, then cd into a git repository and run claude. Anthropic's own install documentation is the authoritative source for supported versions and is worth checking before you file a bug against your setup.
Should I run Claude Code natively on Windows or inside WSL2?
Run it wherever your project already builds. If your repository, your toolchain and your test runner live on Windows, run Claude Code on Windows — putting the agent in WSL2 while the code is on the Windows filesystem adds a filesystem boundary for no benefit. If you already develop inside WSL2, install Claude Code inside WSL2 as well, and treat it as the Linux install it is. The rule is to keep the agent on the same side of the boundary as the code it edits and the commands it runs.
Does AIDEN run on Windows?
Not yet. AIDEN is a macOS 12+ desktop app today, on Apple Silicon and Intel. The Windows build is in Microsoft Store certification. We are not announcing a date, because the certification timeline is not ours to promise and a missed date costs more with this audience than no date at all. Join the waitlist and you get an email the day the build is ready.
Is there anything I can use on Windows today instead?
Yes, and pretending otherwise would not help you. OpenAI's Codex app shipped for Windows in March 2026, and of the third-party desktop apps we compare, Nimbalyst is cross-platform. Our Claude Code desktop apps roundup covers what each one actually manages so you can pick on the merits rather than on which page you happened to land on.
Will I need a separate subscription for AIDEN when the Windows build ships?
No. AIDEN is bring-your-own inference: you keep the Claude Code subscription or API key you already have, and AIDEN runs on top of it. AIDEN never resells tokens and adds no per-seat model cost. The free tier covers one project, no credit card required.
Where do my API keys live? Does AIDEN see them?
Your keys live where Claude Code and Codex already keep them (~/.claude, ~/.codex, or wherever you configured them). AIDEN never reads, copies, or transmits your API keys.
Is my code sent anywhere by AIDEN?
No. AIDEN is a desktop app, your code stays on your machine. The only outbound network calls come from your local Claude Code or Codex CLIs talking to their own providers (Anthropic or OpenAI), exactly like they do today without AIDEN.

Keep reading