Claude Code install guide: Windows, macOS, Linux, login, and verification
The recommended Claude Code install is Anthropic's native installer, verified with claude --version and claude doctor. This guide covers system and account requirements, native Windows vs WSL, npm caveats, first login, and updates.
The safest Claude Code install path is Anthropic's native installer: on macOS, Linux, or WSL run curl -fsSL https://claude.ai/install.sh | bash, and on Windows PowerShell run irm https://claude.ai/install.ps1 | iex. Open a new terminal, run claude --version to confirm a version number prints, then start claude inside a project folder to sign in. Most failed installs are not download problems. They come from the wrong account type, a PATH that has not picked up the launcher, or choosing native Windows when the project really needs WSL.
Check three things before you install
Start with the operating system. Anthropic's setup documentation lists macOS 13.0+, Windows 10 1809+ or Windows Server 2019+, Ubuntu 20.04+, Debian 10+, and Alpine Linux 3.19+. The hardware floor is 4 GB of RAM and an x64 or ARM64 processor. An internet connection is required, and the supported shells are Bash, Zsh, PowerShell, and CMD.
Next, check the account. The docs state that Claude Code requires a Pro, Max, Ultra, Team, Enterprise, or Console account, and that the free claude.ai plan does not include Claude Code access. You can also connect through a third-party provider such as Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry. If you are on the free plan, fix that first; reinstalling will not change the result.
Finally, check location. Being in an Anthropic supported country is listed as a system requirement. If the install command returns a 403 or an HTML page instead of a script, follow the official installation troubleshooting guide rather than downloading a binary from an unofficial mirror.
Pick an install method for your system
The native installer is the recommended option because it updates itself in the background. Windows CMD users have a separate install.cmd command on the same page. The installer prints no progress while it downloads, so a quiet terminal is expected.
Package managers are supported too. On macOS, brew install --cask claude-code tracks the stable channel, which Anthropic describes as typically about a week behind and skipping releases with major regressions; claude-code@latest tracks every release. On Windows, winget install Anthropic.ClaudeCode works. Debian, Ubuntu, Fedora, RHEL, and Alpine can use Anthropic's signed apt, dnf, and apk repositories. Homebrew, WinGet, and Linux package manager installs do not auto-update by default, so you own the upgrade schedule.
The npm route still exists: npm install -g @anthropic-ai/claude-code. The npm package requires Node.js 22 or later, but it installs the same native binary as the standalone installer and the binary does not use Node at runtime. Anthropic warns against sudo npm install -g because it causes permission problems and blocks self-updates. To upgrade an npm install, use rather than , which may not move you to the newest release.
