Build This Now
Build This Now
What Is Claude Code?Claude Code InstallationClaude Code Native InstallerYour First Claude Code Project
Get Build This Now
speedy_devvkoen_salo
Blog/Handbook/Start here/Claude Code Native Installer

Claude Code Native Installer

A single command installs Claude Code on Windows, Mac, or Linux. Zero Node.js, zero npm, zero PATH fiddling. Auto-updates included.

Problem: the old npm install path needed Node.js 18+, caused PATH issues, and broke on some platforms. The native installer solves all of that with one command that works everywhere.

Quick Start: One Command Install

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Homebrew (macOS/Linux):

brew install --cask claude-code

That is it. No Node.js. No npm. No PATH setup. Run claude --version to confirm.

Why the Native Installer Is Better

Anthropic now ships the native installer as the recommended install method for every Claude Code user. Here is the comparison:

FeatureNative Installernpm Install
Requires Node.jsNoYes (v18+)
Auto-updatesYes (background)No (manual)
PATH setupAutomaticOften broken
Platform supportWindows, macOS, Linux, WSLVaries
StabilityProduction-testedPlatform-dependent

The native installer handles the whole thing for you: it downloads the right binary for your system, sets PATH, and keeps Claude Code updated in the background.

Windows: irm https://claude.ai/install.ps1 | iex

The PowerShell command irm https://claude.ai/install.ps1 | iex does three things:

  1. irm (Invoke-RestMethod) downloads the install script from Anthropic
  2. | pipes the script content to the next command
  3. iex (Invoke-Expression) runs the downloaded script

Run as Administrator for the cleanest install:

# Open PowerShell as Administrator, then:
irm https://claude.ai/install.ps1 | iex
 
# Verify installation
claude --version

Alternative for CMD users:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

WinGet option:

winget install Anthropic.ClaudeCode

Note: WinGet does not auto-update. The native installer is the better pick.

macOS and Linux: curl https://claude.ai/install.sh | bash

The bash installer behaves the same way on macOS, Linux, and WSL:

curl -fsSL https://claude.ai/install.sh | bash

The -fsSL flags mean:

  • f: Fail silently on HTTP errors
  • s: Silent mode (no progress bar)
  • S: Show errors if they occur
  • L: Follow redirects

Verify and start:

claude --version
cd your-project
claude

Troubleshooting

"irm is not recognized" (Windows)

You are in CMD, not PowerShell. Open PowerShell and run the command there.

"Execution policy" error (Windows)

PowerShell may block scripts by default:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://claude.ai/install.ps1 | iex

"command not found" after install

Close and reopen your terminal to reload PATH, then try claude --version again.

Already have the npm version installed?

Uninstall the npm version first:

npm uninstall -g @anthropic-ai/claude-code

Then run the native installer.

What Happens After Install

Once Claude Code is in place:

  1. Run claude in any project directory
  2. Complete the one-time auth with your Anthropic account
  3. Start coding with AI

New to Claude Code? Follow the first project tutorial to see it in action. Want more install options? See the full installation guide.

The native installer was announced in October 2025 as Anthropic's recommended method. Simpler, more stable, and it keeps you updated automatically. No Node.js required.

More in this guide

  • Agent Fundamentals
    Five ways to build specialized agents in Claude Code, from sub-agents to .claude/agents/ definitions to perspective prompts.
  • Agent Patterns
    Orchestrator, fan-out, validation chain, specialist routing, progressive refinement, and watchdog. Six ways to wire sub-agents in Claude Code.
  • Agent Teams Best Practices
    Battle-tested patterns for Claude Code agent teams. Troubleshooting, limitations, plan mode quirks, and fixes shipped from v2.1.33 through v2.1.45.
  • Agent Teams Controls
    Stop your agent team lead from grabbing implementation work. Configure delegate mode, plan approval, hooks, and CLAUDE.md for teams.
  • Agent Teams Prompt Templates
    Ten tested Agent Teams prompts for Claude Code. Code review, debugging, feature builds, architecture calls, and campaign research. Paste and go.

Stop configuring. Start building.

SaaS builder templates with AI orchestration.

Get Build This Now

Claude Code Installation

One-command install for Windows, macOS, and Linux. Native installers, Homebrew, and npm. Up and running in under two minutes, no Node.js required.

Your First Claude Code Project

Build a working CLI task manager with Claude Code in five minutes. Conversational development, troubleshooting, and the pattern underneath.

On this page

Quick Start: One Command Install
Why the Native Installer Is Better
Windows: irm https://claude.ai/install.ps1 | iex
macOS and Linux: curl https://claude.ai/install.sh | bash
Troubleshooting
"irm is not recognized" (Windows)
"Execution policy" error (Windows)
"command not found" after install
Already have the npm version installed?
What Happens After Install

Stop configuring. Start building.

SaaS builder templates with AI orchestration.

Get Build This Now