New to AI? Start here → Start 1. What can you do with Claude?
Install Claude Code
In one line
Claude Code is Claude that works right on your computer. Install it with one command, type claude, and you can start handing it work.
The big picture
★ Claude vs. Claude Code ★
💬 Claude (chat)
= A conversation partner
Ask, and it answers in writing.
You copy the result and use it yourself.
🛠️ Claude Code
= A helper on your computer
Works right on your computer.
Creates, edits, and organizes files.
It helps to know this before you install. The names are similar, so lots of people mix them up.
- Claude (chat) is a conversation partner. Ask on the website or in the app and it answers in writing. You have to copy the result and use it yourself.
- Claude Code is a helper on your computer. Say “organize this folder” or “make me a web page,” and it creates, edits, and organizes files on your computer directly.
So jobs where you “make something and leave it on your computer” are best handed to Claude Code.
Follow along
Check before you start
- Plan: Claude Code is available on the Pro, Max, Ultra plans. It's not available on the Free plan. (As of November 2026, see official pricing)
- Computer: macOS 13 or later on a Mac, or Windows 10 (version 1809 or later) or Windows 11.
- Internet: you need an internet connection to install and to use it.
Step 1. Open the terminal
The terminal is a window where you give your computer jobs in text instead of with the mouse. It may feel unfamiliar, but in this guide you only need to copy and paste.
🍎 Mac
Press Command + Space to open search, type Terminal, and press Return.
Illustration (may look a little different from the real screen)
🔍 Terminal
Terminal.app (Applications)
🪟 Windows
Click the Start button at the bottom left of the screen, type PowerShell, and click Windows PowerShell in the results. You don’t need to open it as an administrator.
Illustration (may look a little different from the real screen)
🔍 PowerShell
Windows PowerShell (App)
On Windows 11, the Start button is in the middle of the screen. Searching for Terminal and opening it also opens a PowerShell window.
Step 2. Paste the install command
Copy the command below exactly, paste it into the terminal, and press Enter (Return on a Mac).
🍎 Mac
curl -fsSL https://claude.ai/install.sh | bashIllustration (may look a little different from the real screen)
username@MacBook ~ %
curl -fsSL https://claude.ai/install.sh | bash
🪟 Windows
irm https://claude.ai/install.ps1 | iexIf you see PS C:\ at the start of the line, you’re in PowerShell.
Illustration (may look a little different from the real screen)
PS C:Usersyourname>
irm https://claude.ai/install.ps1 | iex
There’s no progress bar while it installs. Even if it looks stuck, give it a moment. When a completion message appears, you’re done.
Illustration (may look a little different from the real screen)
Setting up Claude Code...
✔ Claude Code successfully installed!
Step 3. Check that it installed
Close the window you have open and open a new terminal. Then type this:
claude --version
If you see a version number like 2.1.211 (Claude Code), it installed correctly. It’s fine if your number is different.
🍎 Mac
Illustration (may look a little different from the real screen)
% claude --version
2.1.211 (Claude Code)
🪟 Windows
Illustration (may look a little different from the real screen)
PS C:Usersyourname> claude --version
2.1.211 (Claude Code)
Step 4. Log in
Type claude in the terminal and press Enter. The first time you run it, you’ll get a few simple questions, like choosing a color theme for the text. Choose with the arrow keys and press Enter.
Next, your browser opens to a login screen. Log in with the account you signed up for Claude with, click the allow button, and go back to the terminal.
🍎 Mac
Illustration (may look a little different from the real screen)
Claude Code wants to connect to your Claude account
hello@ellanote.com
🪟 Windows
Illustration (may look a little different from the real screen)
Claude Code wants to connect to your Claude account
hello@ellanote.com
Step 5. Say your first words
It’d be a shame to stop right after installing. Say something to it right away. Type this in the input box:
Hi! What kinds of things can you do on my computer? Explain it in simple words.
Once you’ve read the answer, hand it a real job.
Create a file called “today-todo.txt” in this folder and write three example to-dos in it.
These days Claude Code starts in auto mode, so it goes ahead with creating files in the working folder without asking. If you’d like to check each step, press Shift + Tab before asking, so ⏸ manual mode on shows at the bottom of the screen. Then it asks, “May I create this file?” Permission requests are a safety feature that keeps Claude Code from changing your computer without asking. Open the folder and you’ll find the file really is there. That’s the biggest difference from chat.
Illustration (may look a little different from the real screen)
Do you want to create today-todo.txt?
❯ 1. Yes
2. Yes, and don't ask again this session
3. No, and tell Claude what to do differently (esc)
When you’re done and want to leave, type /exit or close the terminal window.
Where people get stuck
“I installed it, but I don’t know what to have it do”
So many people stop right here. Think of it this way: “the repetitive or tedious stuff on my computer” is Claude Code’s work. Things like cleaning up your Downloads folder, renaming a bunch of files at once, or making a simple web page. We’ll do one together in the next tip, “Organize a folder with Claude Code”.
“I asked chat to make a web page”
I did that at first too, and I made this site. Ask Claude chat to “make a web page” and it shows you code on the screen, and that’s it. Saving that code as a file and opening it is up to you. Ask Claude Code the same thing and it creates the files itself, and applies your change requests right away. We’ll look at when to use which in detail in “Claude vs. Claude Code”, the first Intermediate guide.
“It says claude can’t be found”
On a Mac you might see command not found: claude, and on Windows something like The term 'claude' is not recognized.
- Fully close the terminal, open a new one, and try again. This fixes it most of the time.
- If that doesn’t work, restart your computer once.
- If it still doesn’t work, check the official installation troubleshooting page.
On Windows, the command is rejected in red text
- If you see
'irm' is not recognized as an internal or external command, you opened Command Prompt (CMD) instead of PowerShell. Go back to step 1 and open PowerShell. - Some features on Windows work better if you have a program called Git for Windows. Installing it is optional, so it’s fine to skip it for now.
“I logged in, but it says I can’t use it”
Free plan accounts can’t use Claude Code. Check your plan in the settings on the Claude website. How to choose a plan is covered in “Sign up for Claude and pick a plan”, the second Start guide.
The terminal still scares me
That’s OK. Claude also has a desktop app you can use without the terminal. But from the next tip on, this site explains things with the terminal, so please find the courage to follow the steps above just once.
I'm stuck here
Stuck while following along? Tell me where. Only the site owner sees this. Leave your email only if you'd like a reply.
💌 Get new tips by email
I'll email you when a new tip goes up. No ads, ever.