Setup — before Day 1
What Claude Code is. Claude Code is Claude — the same AI you might already use in a browser — running inside your terminal. The difference matters. In a browser tab, Claude can only see what you paste in. Here, with your permission, it can read your files, create new ones, run commands, and help you build small tools. Everything stays on your computer. You’re always the one deciding what it does.
Open the Terminal. On your Mac:
- Press
Cmd + Space(this opens Spotlight search). - Type
Terminal. - Hit Enter.
A window opens with some text and a blinking cursor. That’s the terminal. You did it.
You’ll see something like this:
yourname@MacBook ~ %
This is called the prompt. The computer is waiting for you to type. The % (or sometimes $) means “I’m ready for instructions.”
What is “typing a command”? You type words at the prompt, then press Enter. The computer does the thing. That’s the whole interaction.
Try this. Type these letters exactly and press Enter:
pwd
You’ll see something like /Users/yourname. That just told you which folder you’re currently “in.” More on that tomorrow.
Install Claude Code. One command, once. Like getting a passport: you do it a single time, then you just travel. Copy this line, paste it into your terminal (Cmd+V), and press Enter:
curl -fsSL https://claude.ai/install.sh | bash
(On Windows, open PowerShell instead and run
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd
— the rest of the program works the same.)
You’ll see text scroll by. When it finishes, you should see “Claude Code successfully installed!” You don’t need to install anything else first — the installer brings everything it needs. If something goes wrong, the official troubleshooting is at code.claude.com/docs/en/terminal-guide.
To check it worked, close the Terminal window and open a new one, then type:
claude --version
If you see a version number, you’re set.
Log in (first run only). The first time you type claude, it will ask you to sign in — it opens a browser page, you approve it, and you’re back in the terminal. It uses your existing Claude account (a paid plan; Pro at $20/month is plenty for this program). You won’t be asked again.
If anything ever looks off — weird errors, claude not found, login loops — there’s a built-in checkup:
claude doctor
It checks the installation and tells you what to fix, in plain language.
You’re the one deciding. Claude will sometimes suggest commands, and sometimes ask permission to change a file. You are never required to say yes. If anything feels uncertain, you can ask what a command does before running it, ask Claude to explain its plan first, or just close the window and come back tomorrow. Nothing breaks if you pause.
OK. You’re ready.