> Install Claude Code

Get up and running with Claude Code in under a minute. Choose your platform and installation method below.

System Requirements

Operating System

  • • macOS 13.0+ (Ventura or later)
  • • Windows 10 1809+ / Windows Server 2019+
  • • Ubuntu 20.04+ / Debian 10+
  • • Alpine Linux 3.19+

Hardware & Other

  • • 4 GB+ RAM minimum
  • • Internet connection required
  • • Bash or Zsh shell recommended
  • • Supported country

▸ macOS & Linux Installation

Method 1: Native Install (Recommended)

The native installer is the recommended method. It auto-updates in the background to keep you on the latest version.

bash — Native Install
$ curl -fsSL https://claude.ai/install.sh | bash
Downloading Claude Code... ✔ Claude Code installed to ~/.local/bin/claude

Method 2: Homebrew (macOS)

Install via Homebrew. Note: Homebrew installations do not auto-update — run brew upgrade periodically.

bash — Homebrew
$ brew install --cask claude-code

Method 3: npm (Deprecated)

npm installation still works but is deprecated. Migrate to native with claude install.

bash — npm (deprecated)
$ npm install -g @anthropic-ai/claude-code
⚠ Warning: Do NOT use sudo npm install -g — it causes permission issues and security risks.

▸ Windows Installation

Method 1: PowerShell (Recommended)

PowerShell — Native Install
$ irm https://claude.ai/install.ps1 | iex

Method 2: CMD

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

Method 3: WinGet

PowerShell — WinGet
$ winget install Anthropic.ClaudeCode

Windows Options

  • WSL (Recommended): Both WSL 1 and WSL 2 work. WSL 2 supports Bash tool sandboxing for enhanced security.
  • Native with Git Bash: Requires Git for Windows.

▸ Verify & Authenticate

After installation, verify it's working:

bash — Verify installation
$ claude --version
Claude Code v2.x.x
bash — Health check
$ claude doctor
✔ All checks passed

Authentication

Claude Code supports multiple authentication methods:

  • 1. Claude Pro/Max Plan (Recommended): Subscribe to a Claude Pro or Max plan for unified access to both Claude Code and Claude on the web.
  • 2. Anthropic Console: Connect via the Anthropic Console with active billing. Complete the OAuth process.
  • 3. Cloud Providers: Use Amazon Bedrock, Google Vertex AI, or Microsoft Foundry for enterprise deployments.

▸ Start Using Claude Code

bash — Launch Claude Code
$ cd your-project && claude
╭──────────────────────────────────────╮ │ Welcome to Claude Code! │ │ Type your request to get started. │ ╰──────────────────────────────────────╯

Update Claude Code

$ claude update

Stable Channel

curl ... | bash -s stable

Ready to Start Coding?

Visit Claude.ai to create your account and get started.

Go to Claude.ai →