How to Install and Use Claude Code on Mac — A Complete Beginner's Guide

You don’t need to know how to code.

Seriously. If you can open an app on your Mac, you can use Claude Code. The problem is, most guides out there assume you already know what a “terminal” is, what “Node.js” means, or how to type commands. This guide assumes none of that.

I’m going to walk you through every single step — from finding Terminal on your Mac to having a full conversation with an AI that can actually build things for you. No jargon. No shortcuts. Just a simple, step-by-step walkthrough.

Let’s go.

—

What Is Claude Code?

Claude Code is an AI tool made by Anthropic. Think of it like ChatGPT, but instead of just chatting, it can actually read your files, write code, run commands, and build things directly on your computer.

It runs inside Terminal — the text-based interface that comes with every Mac. If that sounds scary, don’t worry. By the end of this post, you’ll have it up and running.

—

Step 1: Open Terminal

Every Mac has Terminal built in. You don’t need to install anything for this part.

Option A — Spotlight Search (easiest):

Press Cmd + Space on your keyboard
Type Terminal
Press Enter

Option B — Finder:

Open Finder
Go to Applications > Utilities
Double-click Terminal

A window will open with a blinking cursor. That’s it — you’re in Terminal. It looks intimidating, but it’s just a place where you type commands instead of clicking buttons.

—

Step 2: Install Node.js

Claude Code needs something called Node.js to run. Think of Node.js as the engine that powers Claude Code — you install it once and forget about it.

Here’s what to do:

1. In Terminal, type this command and press Enter:

curl -fsSL https://fnm.vercel.app/install | bash

This installs fnm (Fast Node Manager), a tiny tool that helps you install Node.js easily.

2. Close Terminal and open it again (this refreshes your settings).

3. Now install Node.js by typing:

fnm install --lts

4. Verify it worked:

node --version

If you see a version number like v22.x.x, you’re good. If you see an error, try closing and reopening Terminal again.

—

Step 3: Install Claude Code

Now for the main event. In Terminal, type:

npm install -g @anthropic-ai/claude-code

This downloads and installs Claude Code globally on your Mac. It might take a minute — you’ll see some text scrolling by. That’s normal.

When it’s done, verify the installation:

claude --version

You should see a version number. If you do, Claude Code is installed.

—

Step 4: Launch Claude Code

Here’s the moment. Type:

claude

The first time you run it, Claude will ask you to log in to your Anthropic account. Follow the on-screen instructions — it’ll open a browser window where you can sign in or create an account.

Once authenticated, you’ll see Claude’s interface right there in your Terminal. A simple prompt, waiting for your input.

—

Step 5: Start Talking to Claude

Now you can just… talk to it. Type a question or give it a task:

What files are in this folder?

Create a simple HTML page that says "Hello World"

Explain what this Terminal thing is doing

Claude will respond right in the Terminal. If you ask it to create a file, it’ll actually create the file on your computer. If you ask it to explain something, it’ll explain it in plain language.

A few helpful commands to know:

Type /help to see what Claude can do
Type /clear to start a fresh conversation
Press Ctrl + C to stop Claude if it’s doing something you didn’t want
Type exit to close Claude Code

—

What Can You Actually Do With It?

Here’s where it gets interesting. Even if you don’t know how to code, Claude Code can:

Build a website — just describe what you want
Write and edit files — tell it what to create
Answer questions — about your computer, your files, anything
Automate tasks — rename files, organize folders, convert formats
Learn with you — ask it to explain what it’s doing, step by step

The fact that it runs on your actual computer (not just in a browser) means it can do real things with your real files. That’s what makes it different from a regular chatbot.

—

Common Issues (and How to Fix Them)

“command not found: node”
Close Terminal, open it again, and try node --version. If it still doesn’t work, run fnm install --lts again.

“command not found: claude”
Try closing and reopening Terminal. If that doesn’t work, run the install command again: npm install -g @anthropic-ai/claude-code

“Permission denied”
Don’t use sudo. Instead, make sure fnm is properly installed by running the install script from Step 2 again.

Terminal looks frozen
It’s probably just processing. Wait a moment. If nothing happens after 30 seconds, press Ctrl + C to cancel and try again.

—

Wrapping Up

That’s literally it. Four installations (Terminal is already there, fnm, Node.js, Claude Code) and you’re talking to an AI that can build things on your computer.

The whole process takes about 10 minutes. And once it’s set up, you just type claude in Terminal whenever you want to use it.

You don’t need to be a developer. You don’t need to understand code. You just need to be able to describe what you want — and Claude will figure out how to make it happen.

Welcome to the future. It runs in Terminal.

—

How This Post Was Made

This post is a good example of how this blog works behind the scenes.

I (Joseph) had a simple idea: a lot of people hear about AI coding tools like Claude Code but have no idea how to actually install them. The official docs assume you already know your way around a terminal. So I wanted a truly beginner-friendly guide — the kind of post I’d send to a friend who’s never opened Terminal before.

I described this idea to Claude in Korean: “개발에 대해서 아무것도 모르는 사람이 클로드 코드라는 AI를 맥에서 사용해볼 수 있도록 터미널 실행하고 설치하고 AI를 실행하는 과정을 하나의 글로 작성해보자.” Basically: write a guide for someone who knows absolutely nothing about development, covering everything from opening Terminal to running Claude Code.

Claude took that direction and wrote the full guide in English, keeping the tone casual and the steps dead simple. No assumed knowledge, no shortcuts, no jargon without explanation.

The post was then scheduled for publication — also handled by Claude. I didn’t copy-paste anything into WordPress. The AI writes it, formats it, and publishes it directly.

That’s the workflow: I think of what would be useful, describe it in Korean, and Claude handles the rest.

—

This post was written with Claude AI. I provided the direction, topic, and key points in Korean — Claude turned it into the article you just read.

How to Install and Use Claude Code on Mac — A Complete Beginner’s Guide