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.