Start

Home / References

Set up your toolsAbout 10 min, once

Install Claude Code

Last checked . Checked against code.claude.com 1, code.claude.com 2, Terminal guide, Permission modes.md.

In short. Open a terminal, paste one install command, then type claude and sign in through your browser. Claude Code needs a paid Claude plan or a Console account, and the free Claude plan does not include it.

Before you start

You need a Mac with macOS 13 or newer, or Windows 10 (version 1809) or newer, plus an internet connection. You also need a Claude Pro, Max, Ultra, Team, or Enterprise account, or a Claude Console account. If you have not opened a terminal before, do Open a terminal first.

Claude Code can read and change files in the folder you start it in, and it sends what it reads to Claude, so read the safe use notes before you point it at company files. Depending on your version, it may start in a mode that asks before commands (Manual) or one that checks actions with a second AI (Auto), so see the next page to choose.

Steps

Step 1. Paste the install command

On a Mac, paste this and press Return:

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

On Windows, in Windows PowerShell, paste this and press Enter:

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

The command shows no progress while it downloads, so wait until you see "Claude Code successfully installed!" and the cursor comes back. On Windows you do not need Git, because Claude Code uses PowerShell when Git for Windows is missing.

Step 2. Open a new terminal window

Close the window and open a new one, because a new window finds the program you just installed.

Step 3. Start Claude Code and sign in

Type this and press Return or Enter:

claude

A browser page opens. Sign in with your Claude account and approve the request. When Claude Code shows its welcome screen, you are signed in. Type /exit and press Return to leave for now.

Check it worked

Type this and press Return or Enter:

claude --version

It prints a version number followed by (Claude Code). For example, 2.1.329 (Claude Code), and yours may be newer.

Next: set the basics once

Claude Code starts working right away, so set its ground rules first. Check your Claude Code settings covers your first CLAUDE.md, permission modes, allow and deny rules, and where settings live. It takes about 15 minutes.

If something goes wrong

  • "command not found: claude" (Mac). The install folder is not on your path yet. Paste these two lines, then open a new window:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
  • "claude is not recognized" (Windows). Close PowerShell, open a new window, and try again. If it still fails, the install folder .local\bin in your user folder is not on your path, and the Claude Code docs show the fix.
  • "irm is not recognized". You opened Command Prompt. Open Windows PowerShell instead.
  • The page says the app is unavailable in your region. Claude Code is not offered in every country, and you can check the list on anthropic.com.
  • Sign-in says your plan does not include Claude Code. The free plan does not include it, so use a paid plan or a Console account.

Used in

Get your first win this week.

One minute. Three guides picked for your job.

Start my first win