tool guides

How to install Claude Code: a beginner's walkthrough

How to install Claude Code on Mac, Windows or Linux: the one-line installer, which plan you need, logging in, checking it works and your first command.

Femcode Collective||5 min read

To install Claude Code, open a terminal and run one command: curl -fsSL https://claude.ai/install.sh | bash on a Mac or Linux, or irm https://claude.ai/install.ps1 | iex in Windows PowerShell. Then type claude, log in through your browser, and you are in. You need a paid Claude plan; the free plan does not include Claude Code.

This walkthrough is written for people who have rarely or never used a terminal. Commands and requirements are from Anthropic's setup documentation, checked in November 2026.

Before you start

  • A paid account. Claude Code needs a Pro, Max, Team or Enterprise plan, or an Anthropic Console account billed by usage. The free claude.ai plan does not include it.
  • A supported computer. macOS 13 or newer, Windows 10 (version 1809) or newer, or a recent Ubuntu or Debian, with at least 4 GB of RAM.
  • An internet connection the whole time you use it.

If you would rather not use a terminal at all, Anthropic also has a desktop app that runs Claude Code with a normal window. The steps below are for the terminal version, which is what most tutorials assume.

Step 1: open a terminal

  • Mac: press Cmd + Space, type Terminal, press Enter.
  • Windows: open the Start menu, type PowerShell, press Enter. The line where you type should start with PS C:\.
  • Linux: you probably know already; Ctrl + Alt + T works on Ubuntu.

Step 2: run the installer

Copy the line for your system, paste it into the terminal and press Enter.

Mac, Linux or WSL:

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

Windows PowerShell:

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

The installer shows no progress bar while it downloads, so give it a minute. You do not need administrator rights on Windows. If you use Homebrew on a Mac, brew install --cask claude-code works too, but that version does not update itself.

On Windows, installing Git for Windows is optional but recommended, because it gives Claude Code a Bash shell to run commands in.

Step 3: check that it worked

Close the terminal, open a new one, and run:

claude --version

A version number means it worked. If you see "command not found" or "not recognized", the new terminal cannot find the program yet; the troubleshooting page explains how to fix the PATH. For a fuller check, claude doctor prints a health report without starting a session.

Step 4: make a project folder and log in

Claude Code works on the folder you start it in, so make an empty one first:

mkdir my-first-app
cd my-first-app
claude

The first time you run claude, it opens your browser to log in with your Claude account. After that you see a prompt where you type in plain English.

Step 5: your first request

Try something small you can see straight away:

Make a single web page that lets me add books I have read, with a star rating, and keeps the list after I reload. Tell me how to open it.

Claude Code asks for permission before it creates files or runs commands. Read what it wants to do, and say yes when it makes sense. When it is done, it tells you how to open the page in your browser.

From here, vibe coding with Claude covers how to describe what you want and what to do when it goes wrong.

Keeping it up to date

The installer version updates itself in the background. If you installed with Homebrew, run brew upgrade claude-code now and then. To update immediately, run claude update.

If Claude Code is too much for now

If your idea is a single page, Claude in the browser can build and preview it inside the chat with nothing installed. If you want a hosted app without a terminal, browser builders like Replit or Lovable start from a prompt box. Our tool comparison helps you choose.

read next

How to install Claude Code: a beginner's walkthrough | femcode collective