Omniscio

OmniscioGuidesInstall Claude Code on a Mac

Install Claude Code on a Mac

Claude Code installs on a Mac with one line pasted into Terminal, and it needs nothing else installed first. You need macOS 13.0 or later, and a paid Claude plan or a Console account.

This page covers the native installer, the Homebrew route for people who already use Homebrew, the npm route, where the installer puts the program, and what to do when the command is not found afterwards. Every claim names its source at the end.

Last checked against Anthropic's setup and terminal documentation on November 16, 2026. By the Omniscio team. Updated .

What you need first

Anthropic lists the requirements plainly. You need macOS 13.0 or later, a 64-bit processor from either Apple Silicon or Intel, at least 4 GB of RAM, and an internet connection.

You also need an account that includes Claude Code: Pro, Max, Ultra, Team, Enterprise, or a Console account billed for API use. Anthropic states that the free claude.ai plan does not include Claude Code access.

You do not need Homebrew or Node.js. The native installer fetches a single binary built for your Mac's processor, so nothing is compiled on your machine.

Sources: the system-requirements and authenticate sections of Anthropic's advanced setup page, read November 16, 2026.

Install it in Terminal

Open Terminal. Press Command and Space together to open Spotlight, type Terminal, and press Enter. A window with a blinking cursor appears.

Copy this line, paste it into that window with Command and V, and press Enter:

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

The command downloads Anthropic's installer and runs it. Anthropic warns that it shows no progress while Claude Code downloads, so do not assume it has hung. Leave the window open and wait.

When it finishes, Anthropic's terminal guide says you see Claude Code successfully installed!. If you see an error instead, skip ahead to If the install failed.

This is the route Anthropic calls the native install and recommends. It installs the newest version by default, and it can install the stable channel or a pinned version instead — both are on the update guide.

Sources: the macOS and Linux steps of Anthropic's terminal guide and the native-install tab of the setup page, read November 16, 2026.

Check that it worked

Open a NEW Terminal window, then run this. Type the command without the $, which stands for the prompt:

$ claude --version
2.1.325 (Claude Code)

A version number with the product name after it means the install works. The number above is the release that was current when this page was checked, so expect a newer one.

For a fuller check, run claude doctor. Anthropic describes it as read-only diagnostics printed without starting a session: install health, settings-file errors, and warnings with suggested fixes.

Then start your first session by typing claude in any project folder. A browser window opens for sign-in. The login errors guide covers a sign-in that does not complete.

If the install failed

A dyld error, or a message about being built for Mac OS X 13.0, is Mac-specific. It usually means your macOS is older than Claude Code supports; check your version from the Apple menu, About This Mac, and Anthropic's fix is to update macOS through Software Update.

HTML in the terminal, or syntax error near unexpected token '<', means the download returned a web page instead of the installer. Run the command again; if it keeps happening, install with Homebrew instead.

If the install command itself printed an error, Anthropic's install troubleshooting page matches it to a fix. If the install finished but Claude Code misbehaves, run claude doctor: it reports the health of your install and suggests fixes.

Sources: the macOS-and-Linux troubleshooting section of Anthropic's terminal guide and the claude doctor row in the CLI reference, read November 16, 2026.

Install it with Homebrew instead

If Homebrew is already on your Mac, Anthropic documents a cask for Claude Code, as an alternative to the installer. brew --version tells you whether you have it. If that reply is command not found: brew, you do not, and brew.sh is where it comes from.

Pick one route and stay on it. Two installs on one Mac can cause version mismatches and unpredictable behaviour, and the uninstall guide shows how to find and remove the extra one.

brew install --cask claude-code

Homebrew offers two casks, and the name you install decides which releases you get. claude-code tracks the stable channel, which Anthropic says is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel.

The trade is updates. Anthropic states that Homebrew installations do not auto-update, so you run brew upgrade claude-code — or brew upgrade claude-code@latest for the other cask — yourself.

Source: the Homebrew tab of Anthropic's setup page, read November 16, 2026.

Install it with npm instead

The npm package installs the same native binary. It asks for Node.js 22 or later, but the installed claude does not call Node when it runs, so your own Node version is not what executes Claude Code.

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

Do not put sudo in front of it. Anthropic explains why: Claude Code runs npm without sudo when it updates itself, so an install that needed sudo cannot update automatically later.

The Mac packages are darwin-arm64 for Apple Silicon and darwin-x64 for Intel. npm pulls the right one automatically, provided your npm allows optional dependencies.

To update an npm install later, rerun the same command. Anthropic advises against npm update -g, which respects the original version range and can leave you on an older release.

Source: the npm section of Anthropic's setup page, read November 16, 2026.

Where it installs, and who signed it

The native installer puts a launcher at ~/.local/bin/claude. That file is a symlink into ~/.local/share/claude/versions/, where each installed version sits.

Anthropic notes what happens if you replace that launcher with your own script or symlink: auto-update and claude update leave it alone, new versions still land in versions/, and your launcher decides which one runs.

The binary carries Apple's own stamp as well as Anthropic's. Anthropic says the macOS build is signed by Anthropic PBC and notarized by Apple, and gives codesign --verify --verbose ./claude as the check.

Your settings, allowed tools, MCP servers and session history live in ~/.claude and ~/.claude.json, in your home folder. The uninstall guide lists every folder before you delete anything.

Sources: the auto-updates and platform-code-signatures sections of Anthropic's setup page, and the configuration-files warning on its uninstall section, read November 16, 2026.

If the Mac says command not found

The installer does not add ~/.local/bin to your PATH, so a new terminal can say command not found: claude even though the install worked. Anthropic's terminal guide says the installer prints the exact line under Setup notes.

On a Mac the default shell is Zsh. These two lines add the folder for every new window and apply it to the one you are in:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

If you use Bash on macOS, Anthropic says to put the line in ~/.bash_profile instead. Terminal starts Bash as a login shell, which ignores ~/.bashrc.

Then open a new terminal and run claude --version. If no file is there at all, either the install did not finish or you installed another way, which is a different problem. The command not found guide walks through both cases.

Sources: the PATH fix in Anthropic's install troubleshooting page and the macOS-Linux troubleshooting section of the terminal guide, read November 16, 2026.

Updating, removing, and what comes next

A native install keeps itself current. The update guide covers the manual command, the release channels and how to freeze a version.

If an update fails, Claude Code keeps working on the version you already have. The auto-update failed guide explains the footer message and what to run.

To remove it, the uninstall guide has the two commands for a native Mac install, and a warning about what deleting your settings folder costs.

Running several sessions at once

One Mac can hold several Claude Code sessions at once, and each one is its own terminal. Omniscio, the desktop app we make for running many Claude Code sessions at once, puts them in one window with a sidebar instead. It installs on macOS.

It is free to use with up to 8 projects. Pro is $20/month or $192/year, and neither plan includes an AI allowance.

The toolchain update page explains how it keeps Claude Code current: a one-click Update that runs claude update against the binary your sessions actually use.

The multi-session guide compares every way to do it by hand, and the command not found guide covers a terminal that cannot find the program.

Where these answers come from

The release checked here was 2.1.325, the version npm served and claude --version printed on November 16, 2026. Anthropic's install pages change often, so read them again before trusting an older copy.

Common questions

How do I install Claude Code on a Mac?

Open Terminal with Command and Space, type claude.ai's installer line and press Enter: curl -fsSL https://claude.ai/install.sh | bash. It shows no progress while it downloads, so leave the window open. When it finishes, open a new terminal and run claude --version, which prints a version number on a working install.

Which macOS version does Claude Code need?

macOS 13.0 or later, on a 64-bit Intel or Apple Silicon Mac with at least 4 GB of RAM. On an older macOS the program fails with a dyld error or a message about being built for Mac OS X 13.0, and Anthropic's fix is to update macOS through Software Update.

Is the Mac install a download I double-click?

No. Claude Code is a terminal program, and the documented install is one line pasted into Terminal. There is a separate Claude desktop app with a normal Mac download, which Anthropic describes as a way to use Claude Code without the terminal. It is a different application from the claude command this guide installs.

Do I need Homebrew or Node.js to install Claude Code on a Mac?

No. Anthropic calls the native installer the recommended route and it needs neither. Homebrew and npm are documented alternatives. The npm package asks for Node.js 22 or later, and it still installs the same native binary, so your own Node version is not what runs Claude Code.

Why does my Mac say command not found: claude after installing?

The installer put the program in ~/.local/bin and did not add that folder to your PATH. On a Mac the default shell is Zsh, so you add one line to ~/.zshrc and reload it. The install output prints the exact line under Setup notes, and the command not found guide covers every other cause.

Does the Mac install update itself?

The native installer does. It checks for updates when Claude Code starts and periodically while it runs, downloads them in the background and switches on the next start. An npm install also updates itself, unless the npm global folder is not writable. A Homebrew install does not, and needs brew upgrade.

Install once, then run several sessions in one window

Omniscio sits on top of the Claude Code you just installed and runs many sessions side by side. The features page lists what it does today.