How to Install Claude Code

How to install Claude Code is a practical question for developers and teams who want an AI-powered coding agent that works directly in the terminal with minimal setup. Claude Code is built by Anthropic and is designed to help you plan changes, edit multiple files, and automate coding workflows inside your own repositories. The fastest path is the native installer, which typically completes in under 5 minutes and requires no Node.js or GPU.

This guide covers how to install Claude Code on macOS, Linux, and Windows, how to verify the install, and how to complete first-run authentication. It also addresses common troubleshooting steps and practical tips for VS Code and Cursor workflows.

What is Claude Code (and Why the Native Install Matters)

Claude Code is a terminal-based AI coding agent that can work across a project directory, assist with multi-file edits, and support structured workflows like planning and iterative implementation. The native installation method is generally preferred because it is a low-dependency approach with auto-updates, reducing the risk of version conflicts that can arise with toolchains like Node.js.

Note on terminology: you may see the misspelling Caude Code in some searches or posts. The correct product name is Claude Code.

System Requirements and Account Prerequisites

Operating System Support

• macOS: macOS 13.0 (Ventura) or later

• Linux: Ubuntu 20.04+, Debian 10+, and musl-based distributions such as Alpine (with required runtime libraries and tools)

• Windows: Windows 10 (version 1809+) via native install, Git for Windows, or WSL

Hardware and Connectivity

• RAM: 4 GB minimum, 8 GB recommended for large codebases

• Internet: required for authentication and API calls to Anthropic services

• GPU: not required

• Node.js: not required for the recommended native installer

Claude Account Requirement

Claude Code requires a paid Claude plan such as Pro, Max, Teams, Enterprise, or Console. Free Claude.ai plans do not include access to Claude Code.

How to Install Claude Code (Recommended Native Installer)

For the simplest and most reliable installation, use the native one-line installer for your operating system. This method is designed to be fast, with minimal dependencies and automatic updates.

macOS, Linux, or WSL (Recommended)

Run the following command in your terminal:

Command:

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

After installation, the installer adds claude to your PATH. Close and reopen your terminal (or start a new shell session) to apply the PATH update.

Windows PowerShell (No Admin Required)

Open PowerShell and run:

Command:

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

Windows Command Prompt (CMD)

Open CMD and run:

Command:

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

Windows Prerequisites: Git for Windows or WSL

On Windows, Claude Code commonly relies on Git functionality internally. Most setups work best when Git for Windows is installed first. If you prefer Linux-like workflows, install WSL and then use the Linux installer command inside your WSL distribution.

WSL quick start (admin PowerShell):

wsl --install

Reboot when prompted, launch your WSL distribution, then run the Linux installer command shown above.

Alternative Installation Options

The native installer is the recommended path. Alternatives are available if your environment requires them.

npm (Legacy Approach)

You can install via npm, but this requires Node.js. If you use this method, use Node.js 22 LTS through a version manager such as nvm, and avoid running with sudo to prevent permission issues.

Command:

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

Homebrew (macOS/Linux)

If your organization standardizes on Homebrew, you can install with:

Command:

brew install --cask claude-code

Verify Your Installation

After installing Claude Code, confirm the CLI is available and functioning correctly.

Check Version

Command:

claude --version

Run Diagnostics

Command:

claude doctor

If your terminal cannot find the command, restart the terminal session first. If the issue persists, confirm your PATH was updated and that the installation completed without errors.

First-Run Setup: Authenticate and Trust a Project Directory

Once installed, the next step is first-run configuration. This process is typically quick.

1. Open a terminal in your project folder (the repository you want Claude to work in).

2. Run Claude Code by typing claude.

3. Authenticate via the browser flow using your Anthropic account.

4. Trust the directory when prompted so Claude Code can read and propose edits within that project.

5. Select preferences such as theme (for example, dark mode).

From here, you can begin prompting Claude to analyze code, plan changes, and apply multi-file edits within your repository.

Using Claude Code Effectively After Installation

Common Workflows

• AI-assisted coding: request refactors, bug fixes, and feature scaffolding across multiple files.

• Planning first: use a plan-oriented workflow to outline steps before modifying code, which is particularly useful for larger tasks.

• Automation: generate scripts, update configs, or apply repetitive changes across a monorepo.

Editor Integration (VS Code and Cursor)

Many developers pair Claude Code with editors like VS Code or Cursor, using the terminal agent for project-wide operations and the editor for review and manual edits. This combination can reduce context switching and speed up iteration for tasks such as implementing a feature, updating tests, and adjusting documentation in a single pass.

Troubleshooting: Common Issues and Fixes

1) Command Not Found: claude

• Restart your terminal to reload PATH changes.

• Re-run the installer to ensure it completed properly.

• On managed systems, confirm security tools did not block the install script.

2) Windows Issues Related to Git

• Install or update Git for Windows, then retry the installation.

• If you prefer a Linux environment, use WSL and install via the Linux command.

3) Linux musl-Based Distributions (Example: Alpine)

Musl-based environments may require additional runtime libraries and tools such as libgcc, libstdc++, and ripgrep. Ensure these are installed before running Claude Code.

4) Authentication or Access Errors

• Confirm you are on a paid plan that includes Claude Code access (Pro, Max, Teams, Enterprise, or Console).

• Confirm your network allows outbound access to the required Anthropic endpoints.

Recent Updates to Claude Code

Recent releases focus on stability across macOS, Linux, and Windows (including WSL workflows), along with continued improvements to the native installer and auto-update behavior. The platform roadmap also includes expanded agent features such as MCP server support, custom hooks, headless mode, and more flexible multi-model configurations depending on your plan and environment.

Skills to Pair with Claude Code

Claude Code is most effective when paired with solid engineering practices: version control, testing, secure coding, and clear requirements. Structured learning pathways can reinforce these fundamentals. Blockchain Council certifications in the following areas complement AI coding agent workflows:

• AI and machine learning (prompting, agent workflows, applied AI for developers)

• Cybersecurity (secure SDLC, threat modeling, secure code review)

• Blockchain and Web3 development (smart contract engineering practices that benefit from agent-assisted reviews)

These programs strengthen the fundamentals and governance practices needed for responsible, real-world AI-assisted development.

Conclusion

This guide covers how to install Claude Code across macOS, Linux, and Windows. For most users, the native installer is the best choice: it is fast, low-dependency, and designed to stay current through auto-updates. After installing, verify with claude --version and claude doctor, then authenticate and trust your project directory to start using Claude Code for planning, multi-file edits, and automation.

If you run into issues, the most common fixes are restarting your terminal to refresh PATH, ensuring Git for Windows is installed on Windows, and confirming you have a paid Claude plan with Claude Code access.