Skip to content

Claude Code Installation Guide

This guide will walk you through installing Claude Code on your system.

Prerequisites

Before installing Claude Code, ensure you have:

  • A compatible operating system (Windows 10+, macOS 10.15+, or Linux)
  • Administrative privileges on your computer
  • An active Claude Code subscription or trial

Installation Steps

Windows

  1. Download the installer

    • Visit the official Claude Code website
    • Download the Windows installer (.exe file)
  2. Run the installer

    bash
    claude-code-setup.exe
  3. Configure environment variables

    • Open System Properties → Advanced → Environment Variables
    • Add Claude Code to your PATH
    • Restart your terminal
  4. Verify installation

    bash
    claude --version

macOS

  1. Using Homebrew (recommended)

    bash
    brew install claude-code
  2. Manual installation

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

    bash
    claude --version

Linux

  1. Using package manager

    For Ubuntu/Debian:

    bash
    sudo apt update
    sudo apt install claude-code

    For Fedora/RHEL:

    bash
    sudo dnf install claude-code
  2. Manual installation

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

    bash
    claude --version

Post-Installation Setup

1. Authentication

First time setup:

bash
claude auth login

2. Configuration

Create a configuration file:

bash
claude config init

3. Test Your Installation

Run a simple test:

bash
claude "Hello, Claude!"

Troubleshooting

Common Issues

Issue: Command not found

  • Solution: Ensure Claude Code is added to your PATH

Issue: Authentication failed

  • Solution: Check your API key and network connection

Issue: Permission denied

  • Solution: Run with administrator/sudo privileges

Next Steps

Now that you have Claude Code installed:

  1. Learn the basic commands
  2. Configure your environment
  3. Join our community

Need Help?

If you encounter any issues:


Last updated: January 2025