How to Install Claude Code on Mac (The Easy Way)

Claude Code is Anthropic’s AI coding assistant, and it’s quickly become one of the most capable AI coding tools available. It runs directly in your terminal, reads and writes files on your machine, and can build entire projects from a plain English description. Whether you want to create a website, automate a workflow, or build a full app, Claude Code can handle it.

But before you can do any of that, you need to install it. And depending on your experience level, that process can range from straightforward to surprisingly frustrating.

In this guide, we’ll walk through two ways to install Claude Code on your Mac: the manual method using Terminal, and the one-click method using Vibestackr. Pick whichever fits your comfort level.

What you need before installing

Before we get into the installation steps, here’s what you’ll need:

• A Mac running macOS 14 (Sonoma) or later. Claude Code doesn’t support older versions of macOS. You can check your version by clicking the Apple menu and selecting “About This Mac.”
• A Claude Pro subscription or higher. Claude Code requires an active Anthropic subscription, starting at $20/month for Claude Pro. You’ll sign in with your Anthropic account after installation.

That’s it for the basics. If you go the manual route, you’ll also need Node.js installed, but we’ll cover that below.

Method 1: Manual installation via Terminal

This is the “traditional” way to install Claude Code. If you’re comfortable with the command line, or want to understand what’s happening under the hood, this is for you.

Step 1: Open Terminal

Press Cmd + Space to open Spotlight, type “Terminal,” and press Enter. You’ll see a window with a text prompt. This is where you’ll run the installation commands.

Step 2: Install Node.js

Claude Code is built on Node.js, so you need it installed before anything else. This is where many beginners hit their first wall. If you type npm into Terminal and see “command not found,” Node.js isn’t installed yet.

The easiest way to install Node.js is to download it directly from nodejs.org. Grab the LTS (Long Term Support) version, open the downloaded file, and follow the installer steps.

After installation, close and reopen Terminal, then verify it worked:

node --version

You should see a version number like v22.x.x. If you still see “command not found,” the installation didn’t set up your PATH correctly, which is a common issue. You may need to restart your Mac or manually add Node.js to your shell profile.

Step 3: Install Claude Code via npm

Now run the actual installation command:

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

The -g flag installs Claude Code globally, meaning you can run it from any directory on your Mac.

This step can also trip people up. If you see a permissions error (something like EACCES), it means npm doesn’t have write access to the global packages directory. The typical fix is to either prefix the command with sudo (which requires your Mac password) or reconfigure npm’s default directory. If you’ve never dealt with npm permissions before, this can be confusing.

Step 4: Authenticate

Once the installation finishes, type:

claude

Claude Code will start up and prompt you to sign in with your Anthropic account. Follow the on-screen instructions to authenticate, and you’re done.

Where beginners commonly get stuck

We don’t want to sugarcoat this: the manual method works well if everything goes smoothly, but there are a few places where things tend to go sideways for people who are new to the terminal.

• Node.js not being installed and not knowing what it is or why it’s needed.
• npm permission errors that require changing system-level configurations.
• PATH issues where the terminal can’t find the claude command after installation, usually requiring edits to shell config files like .zshrc or .bash_profile.
• Version conflicts if you have an old version of Node.js already installed.

None of these are unsolvable, but they can eat up a lot of time if you’re troubleshooting for the first time. If any of that sounds like more than you want to deal with, the next method exists specifically for you.

Method 2: One-click installation with Vibestackr

Vibestackr is a free Mac app that installs AI coding tools like Claude Code without requiring any terminal knowledge. It handles Node.js, npm, dependencies, and configuration automatically, so you can skip every manual step we just described.

Step 1: Download Vibestackr

Head to vibestackr.com and download the app. Open the .dmg file and drag Vibestackr into your Applications folder, just like installing any other Mac app.

Step 2: Open Vibestackr and click Install

Launch Vibestackr and you’ll see a list of available AI coding tools. Find Claude Code in the list and click the Install button next to it.

That’s the whole process. Vibestackr detects whether you have Node.js installed, installs it if needed, resolves any dependency or permission issues, and sets up Claude Code correctly. The entire installation typically takes about a minute.

Step 3: Authenticate

After installation, open Terminal (Spotlight > “Terminal” > Enter) and type:

claude

Sign in with your Anthropic account when prompted. You’re ready to go.

After installation: Getting started with Claude Code

Now that Claude Code is installed, here’s how to start using it.

Open Terminal and navigate to a folder where you want to work. For example, to create a new project on your Desktop:

cd ~/Desktop
mkdir my-first-project
cd my-first-project

Then start Claude Code:

claude

You’ll see a prompt where you can type natural language instructions. Here are a few things to try for your first session:

• “Create a simple personal website with my name and a short bio.” Claude Code will generate the HTML, CSS, and any other files needed, right in your current folder.
• “Build a todo list app that saves data to local storage.” A great starter project to see how Claude Code handles interactivity.
• “Explain what files are in this directory.” If you open Claude Code inside an existing project, it can read and understand your codebase.

Claude Code works best when you give it clear, specific instructions. Don’t worry about using technical language. Just describe what you want as if you were talking to a colleague.

FAQ

Do I need to know how to code?

No. Claude Code is designed to work with plain English descriptions. You describe what you want, and it writes the code. Many people using Claude Code have zero programming experience. That said, some basic familiarity with files and folders on your Mac will help you stay organized.

How much does Claude Code cost?

Claude Code itself is free to install, but it requires a Claude Pro subscription from Anthropic, which starts at $20/month. Higher-tier plans like Claude Max offer more usage. You can sign up at claude.ai.

Can I install other AI coding tools too?

Yes. If you’re using Vibestackr, you can also install Codex (OpenAI’s coding agent) and Gemini CLI (Google’s AI coding tool) with the same one-click process. Having multiple tools available gives you flexibility since different AI models sometimes handle different tasks better.

Does Claude Code work on Windows or Linux?

Claude Code supports macOS and Linux. It does not currently have native Windows support, though it can run through WSL (Windows Subsystem for Linux). This guide focuses on Mac installation specifically.

What if the installation fails?

If you went the manual route, double-check that Node.js is installed correctly (node --version in Terminal), that you’re using a recent version (v18 or later), and that you don’t have permission issues with npm. If you’d rather skip the troubleshooting, Vibestackr handles all of this automatically.

Wrapping up

Claude Code is one of the most powerful AI coding tools you can run on your Mac. Getting it installed shouldn’t be the hard part.

If you’re comfortable with the terminal, the manual method gives you full control. If you’d rather skip the setup and start building immediately, Vibestackr gets you there in one click.

Either way, once Claude Code is running, the real fun begins.