// Blog
Blog
In-depth articles, tutorials and guides on software engineering topics.
// Blog
Blog
In-depth articles, tutorials and guides on software engineering topics.
TL;DR: Open Windows PowerShell from the Start menu and run irm https://claude.ai/install.ps1 | iex. When it finishes, open a new window and run claude --version. A version number followed by (Claude Code) means it worked. Then cd into your project and type claude to sign in.
You need a paid Claude plan to use it. Installing Claude Code costs nothing, but using it needs a Pro, Max, Ultra, Team, Enterprise or Console account. The free claude.ai plan does not include Claude Code. No paid plan? See how to use Claude Code for free on Windows with a local model.
Search for PowerShell in the Start menu and open Windows PowerShell. Do not pick Windows PowerShell (x86): that one runs as a 32-bit process and the install fails, even on a 64-bit PC.
How to tell which window you are in: PowerShell shows PS C:\Users\YourName>. CMD shows C:\Users\YourName> without the PS.
Paste this and press Enter:
irm https://claude.ai/install.ps1 | iexIt shows no progress while it downloads Claude Code. That is normal. Wait for it to finish.
Using CMD instead? Run the CMD installer:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdThis native install is the one the docs mark as Recommended, and it updates itself in the background.
Open a new terminal window (the old one keeps its old PATH) and run:
claude --versionYou should see a version number followed by (Claude Code), for example 2.1.211 (Claude Code). For a deeper check, claude doctor prints read-only diagnostics about your install and settings.
Go to your project folder and start it:
cd C:\path\to\your\project
claudeThe first time, Claude Code opens your browser so you can log in with your Claude account. You only log in once. After that the Claude Code prompt opens, with the version, the current model and your folder shown above it.
Git for Windows is optional. It gives Claude Code Git Bash for its Bash tool. Without it, Claude Code uses PowerShell instead. If you install it from git-scm.com, select Add to PATH during setup, then restart your terminal.
'irm' is not recognized as an internal or external commandYou are in CMD, not PowerShell. Open Windows PowerShell and run the irm line again, or stay in CMD and use the CMD installer from Step 2.
The token '&&' is not a valid statement separatorThe reverse: you are in PowerShell but pasted the CMD command. Use the PowerShell installer:
irm https://claude.ai/install.ps1 | iexclaude : The term 'claude' is not recognized as the name of a cmdletThe install folder is not on your PATH yet. Fix it in this order:
Open a new terminal window and try claude --version again. The window you installed from keeps its old PATH.
Check the file is there:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"True means Claude Code is installed and only the PATH is missing. False means there is no native install: run Step 2 again.
Add the folder to your User PATH (run once, it is permanent):
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')Restart your terminal and run claude --version.
In CMD, the same fix is manual: open System Settings, go to Environment Variables, and add %USERPROFILE%\.local\bin to your User PATH. If your terminal runs inside an editor such as VS Code, quit and reopen the editor so it picks up the new PATH.
curl: (22) The requested URL returned error: 403In PowerShell this can show up as an iex parse error or System.Xml.XmlDocument is not recognized. All of these mean the install link sent back a web page instead of the install script. It can be a temporary problem, a company proxy or firewall, or Claude Code not being available in your country (the output then says "App unavailable in region").
winget install Anthropic.ClaudeCode| Error | Fix |
|---|---|
A parameter cannot be found that matches parameter name 'fsSL' | You ran the macOS/Linux command in PowerShell. Use the irm line. |
Claude Code does not support 32-bit Windows | You opened Windows PowerShell (x86). Open Windows PowerShell instead. |
Failed to download binary: The process cannot access the file | Delete the folder $env:USERPROFILE\.claude\downloads and run the installer again. |
claude opens an old version | An old Claude Desktop can take over the claude command. Update Claude Desktop to the latest version. |
winget install Anthropic.ClaudeCode. WinGet installs do not update themselves, so run winget upgrade Anthropic.ClaudeCode now and then.Update now: claude update (the native install also updates itself in the background).
Uninstall the native install (PowerShell):
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -ForceUninstall a WinGet install: winget uninstall Anthropic.ClaudeCode
New step-by-step guides and coding tutorials, straight to your inbox.
Written by
AamerSoftware engineer and creator of Prograamer — practical tutorials on AI tools, AWS, web development, and career growth for software engineers.
Install the HyperFrames animation skill in Claude Code with two commands, type one prompt, render an MP4 on your own computer, then change it by asking. Plus what it can't do and what it really costs.
Read moreInstall skills in Claude Code from the official plugin marketplace or by copying a folder, on Windows or Mac. Then run them, make your own SKILL.md, and fix the four errors people hit.
Read moreMake videos with Claude Code for $0: create motion graphics from one prompt with HyperFrames, or cut your own footage with FFmpeg and local Whisper.
Read more