Quick summary: This guide shows you 3 ways to install Claude Code on Mac — the Native Installer (easiest, no Node.js needed), Homebrew, or npm. All methods work on both Intel and Apple Silicon (M1/M2/M3/M4) Macs running macOS 10.15 or later.

Claude Code is Anthropic’s AI coding assistant that runs directly in your Mac’s Terminal. Unlike a regular chat interface, Claude Code can actually read your project files, write and edit code, run commands, and handle Git — all through natural language. You just describe what you want, and it does the work.

In 2026, Anthropic introduced a Native Installer that makes the setup dramatically simpler. You no longer need to install Node.js first — one command in Terminal and you’re done. This guide covers all three installation methods so you can choose the one that fits your setup.

---

Before You Start: Requirements

Make sure you have the following before installing Claude Code on your Mac:

Requirement	Details
macOS version	macOS 10.15 Catalina or later (works on all Apple Silicon M-series Macs)
Claude account	A Claude Pro, Max, Team, or Enterprise subscription — or an Anthropic Console account with API credits
Node.js	Not required for Method 1 (Native Installer) or Method 2 (Homebrew). Required only for Method 3 (npm)
Internet connection	Required for installation and authentication

💡 Which Claude plan do you need? Claude Code requires at minimum a Claude Pro plan ($20/month). The free tier does not include Claude Code access. If you’re not sure which plan you have, check at claude.ai.

---

Method 1: Native Installer — The Easiest Way (Recommended)

✅ RECOMMENDED FOR BEGINNERS

This is Anthropic’s officially recommended method as of 2026. It requires zero dependencies — no Node.js, no Homebrew, nothing to install beforehand. One command and you’re done. Claude Code also auto-updates itself in the background so you always have the latest version.

Step 1 — Open Terminal

1Press Command (⌘) + Space to open Spotlight Search, type Terminal, and press Enter. Terminal is the built-in app on every Mac that lets you run commands.

Step 2 — Run the install command

2Copy and paste this official command from Anthropic, then press Enter:

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

3The installer will download and set up Claude Code automatically. It may ask for your Mac password during installation — type it and press Enter (you won’t see any characters as you type, that’s normal).

Step 3 — Verify the installation

4Once finished, verify Claude Code is installed by running:

claude --version

If you see a version number (e.g. 1.x.x), installation was successful. ✅

💡 Auto-updates: The Native Installer automatically updates Claude Code in the background. You don’t need to do anything — you’ll always be on the latest version.

---

Method 2: Install Claude Code via Homebrew

GOOD FOR DEVELOPERS

If you already use Homebrew to manage apps and tools on your Mac, this is the cleanest option — everything stays in one place. If you don’t have Homebrew yet, Method 1 is easier.

Step 1 — Install Homebrew (skip if already installed)

Open Terminal and run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

This takes 3–5 minutes. Follow any on-screen instructions. Check it’s installed with brew --version.

Step 2 — Install Claude Code

brew install --cask claude-code

That’s it. The binary is automatically added to your PATH, so you can run claude from any folder immediately.

⚠️ Important: Homebrew does not auto-update Claude Code. Run brew upgrade claude-code periodically to get new features and security fixes.

Two Homebrew channels available:

• brew install --cask claude-code — Stable channel, about 1 week behind, skips buggy releases. Recommended for most users.
• brew install --cask claude-code@latest — Latest channel, newest features immediately. Good for developers who want cutting-edge updates.

---

Method 3: Install Claude Code via npm (Legacy)

FOR NODE.JS USERS

This is the original installation method and still works perfectly. Use it if you already have Node.js installed and prefer managing global packages with npm.

Step 1 — Install Node.js (skip if already installed)

1Go to nodejs.org and download the LTS version (Long-Term Support). Click the installer and follow the prompts.

2After installation, verify it’s working:

node --version

You need Node.js v18 or higher. If the number shown is lower, download a newer version from nodejs.org.

Step 2 — Install Claude Code

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

Step 3 — Verify installation

claude --version

---

Step 2: Log In to Your Claude Account

Regardless of which installation method you used, the login process is the same for everyone.

1In Terminal, type claude and press Enter to launch Claude Code for the first time.

claude

2Claude Code will display a URL. It will try to open your browser automatically — if it doesn’t, hold Command (⌘) and click the URL, or copy-paste it into your browser manually.

3Sign in with your Anthropic/Claude account in the browser and click Authorize.

4Return to Terminal — you’ll see the Claude Code welcome screen. You’re in! 🎉 Your credentials are saved, so you won’t need to log in again.

💡 Run a quick health check: After logging in, run claude --doctor to verify everything is working correctly. It will show a summary of your installation status.

---

Step 3: Start Your First Session

Now for the fun part. Navigate to any project folder on your Mac and launch Claude Code:

cd ~/Desktop/my-project
claude

Claude Code reads your project files and is ready to help. Try asking it something natural:

what does this project do?

explain the folder structure

add a hello world function to the main file

Claude will show you exactly what changes it wants to make and ask for your approval before touching any file. You’re always in control.

---

Essential Terminal Commands Cheat Sheet

Command	What it does
claude	Launch Claude Code in current folder
claude –version	Check installed version
claude –doctor	Run diagnostics / health check
claude –continue	Continue the most recent session
claude –resume	Open a past session to continue
/help	Show all available commands (inside Claude)
/exit	Exit Claude Code and return to Terminal
/model	Switch between Claude models
/login	Switch accounts or re-authenticate

---

Troubleshooting: Common Problems on Mac

Problem: command not found: claude after installation

Your Terminal shell hasn’t picked up the updated PATH yet. Fix: close Terminal completely and open a new window, then try again. If it still doesn’t work, run the installer again.

Problem: Permission denied during npm install

Don’t use sudo npm install. Instead, configure npm to use a user-level directory:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

Problem: Browser doesn’t open for login

Copy the URL shown in Terminal manually and paste it into your browser. Log in with your Claude account and click Authorize, then return to Terminal.

Problem: claude --doctor shows errors

Try uninstalling and reinstalling:

# For Native Installer:
curl -fsSL https://claude.ai/install.sh | bash

# For npm:
sudo npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

Problem: “This account does not have access to Claude Code”

Claude Code requires a Claude Pro, Max, Team, or Enterprise plan. The free Claude plan does not include Claude Code. Upgrade your plan at claude.ai/pricing.

---

Which Installation Method Should You Use?

Method	Best for	Auto-updates	Node.js needed
Native Installer	Everyone — especially beginners	✅ Yes	❌ No
Homebrew	Developers who use brew for everything	❌ Manual	❌ No
npm	Node.js developers	❌ Manual	✅ Yes (v18+)

For most Mac users — especially beginners — Method 1 (Native Installer) is the right choice. It’s the simplest, has no dependencies, and keeps itself updated automatically.

---

Frequently Asked Questions

---