How to Install Claude Code on Mac

If you’ve been hearing about Claude Code and wondering how to get it running on your Mac — you’re in the right place.

This guide skips the fluff. No 3,000-word rabbit holes. Just a clean, step-by-step walkthrough that gets Claude Code installed and running on your Mac in under 10 minutes.

Let’s go.

What Is Claude Code (And Why Should You Care)?

Claude Code is an agentic AI coding tool that lives right inside your terminal. It reads your codebase, understands your files, and helps you code faster — through plain English commands.

Think of it as a coding partner that:

• Explains confusing code in seconds
• Writes and edits code based on your instructions
• Handles Git workflows without you memorizing every command
• Runs routine tasks so you focus on the real work

Over 80% of developers say AI coding tools have already made them more productive. Claude Code is built specifically for that kind of deep, in-context assistance — not just autocomplete, but actual agentic work on your project.

How to Install Claude Code on Mac

There are three ways to install Claude Code on Mac. Pick the one that fits your workflow.

Before You Start: System Requirements

Make sure your Mac meets the basics:

• macOS 10.15 (Catalina) or newer
• An active internet connection
• A Claude Pro, Max, Teams, or Enterprise account (the free plan does not include Claude Code access)

💡 Quick tip: Not sure which macOS version you’re on? Click the Apple menu → About This Mac.

Method 1: Native Installer (Recommended ✅)

This is the fastest and cleanest option. No Node.js required. Automatic updates built in. This is what Anthropic recommends for most Mac users.

Step 1 — Open Terminal

Press Command (⌘) + Space, type “Terminal,” and hit Return.

Step 2 — Run the installer

Paste this command and press Return:

/bin/bash -c “$(curl -fsSL https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/install.sh)”

⚠️ Always copy this from the official Claude Code docs to make sure you have the latest version.

Step 3 — Follow the prompts

The installer will walk you through theme selection and security notes. Takes about 60 seconds.

Step 4 — Authenticate

Type claude and press Return. A browser tab will open. Log in with your Claude.ai account and click Authenticate.

Step 5 — Verify the install

claude doctor

If you see green checkmarks, you’re good to go. 🎉

Method 2: Install via Homebrew

If you already use Homebrew for package management, this is a one-liner:

brew install –cask claude-code

Note: Homebrew installations do not auto-update. Run brew upgrade claude-code manually when updates drop.

Method 3: Install via npm

If you prefer npm and already have Node.js 18.0+ installed:

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

⚠️ Do NOT use sudo npm install -g — this causes permission issues and security risks. If you hit permission errors, check Anthropic’s troubleshooting docs.

Running Claude Code for the First Time

Once installed, here’s how to actually use it:

Step 1 — Navigate to your project folder

cd /path/to/your/project

💡 Shortcut: Right-click on any folder in Finder → Services → New Terminal at Folder.

Step 2 — Launch Claude Code

claude

Step 3 — Start with a simple prompt

Try something like: “Explain what this file does” or “Write tests for the main function.”

Claude will show you a diff of any changes before applying them. You stay in control at every step.

Useful Terminal Commands to Bookmark

Troubleshooting Common Issues

“Command not found: claude” Your shell can’t find the binary. Add Claude Code to your PATH by updating your .zshrc file:

echo ‘export PATH=”$HOME/.local/bin:$PATH”‘ >> ~/.zshrc

source ~/.zshrc

Permission errors during npm install Never use sudo. Instead, configure npm for global packages without elevated permissions — Anthropic’s docs have a full walkthrough.

Browser doesn’t open during authentication Hold Command (⌘) and click the long URL that appears in Terminal. Or copy-paste it manually into your browser.

Node.js version too old (for npm method) Run nvm install –lts && nvm use –lts to upgrade to the latest stable version.

Conclusion

Installing Claude Code on Mac takes less than 5 minutes once you know the steps.

Quick recap: Use the native installer for the smoothest experience — no Node.js needed, auto-updates handled, and it works right out of the box on macOS 10.15+. Homebrew and npm are solid alternatives depending on your setup.

Once it’s running, start small. Navigate to a project folder, launch claude, and give it one simple task. You’ll see fast how powerful it is when it has full context on your codebase.

The developers who adopt AI tools early don’t just code faster — they ship more, stress less, and stay ahead.