2-2 Claude Code を Mac にインストールする手順

このレッスンで身につくこと

このレッスンは、Mac を使っているあなたが Claude Code を 0 から動かす ためのフルガイドです。Apple Silicon（M1〜M4）も Intel Mac も同じ手順 で動くように整理しています。途中でアーキテクチャに依存する分岐が出てきたら、そのつど明示します。

所要時間 — 約 45 分（実機を触りながら 1 回通すと、だいたいこのくらいです） 難易度 — ★★☆☆☆（コマンドの貼り付けが主、初めての人でも完走できます）

はじめに — Mac は「最短経路」だが、油断するとハマる

Mac は Claude Code をいちばん素直に動かせる OS です。Anthropic 自身が Mac で開発しており、公式ドキュメントの動作確認も Mac が基準。Apple Silicon ならパフォーマンスもダントツで、Sonnet のストリーミング応答が Windows よりも一段なめらかです。

それでも Mac には Mac の罠があります。Intel Mac と Apple Silicon の 2 系統が併存しており、Rosetta や ==Homebrew のインストール先が /usr/local と /opt/homebrew で違う== といった、Windows にはない概念が登場します。「ネットの記事の通りにやったのに claude が見つからない」という失敗は、ほぼ全部この辺りに起因します。このレッスンを最後まで読めば、その手の事故を事前に潰せます。

事前準備チェックリスト

セットアップを始める前に、以下が揃っているか確認してください。3 分で終わります。

必要なもの

あると便利だけど、なくてもいいもの

• iTerm2 — 標準 Terminal.app より高機能。タブ・分割・配色が豊富
• Visual Studio Code — Claude Code が出力したファイルを開くのに便利
• Warp — AI 機能内蔵の新世代ターミナル
• Git — 後の章で必要。Xcode Command Line Tools か Homebrew で入る

macOS バージョンを確認する

ターミナルを開いて以下を実行します。

sw_vers
# ProductName:    macOS
# ProductVersion: 15.3
# BuildVersion:   24D60

ProductVersion が 12.0 以上 ならそのまま進めます。それより古い場合は、まず macOS のアップデート（システム設定 → 一般 → ソフトウェアアップデート）を済ませてください。Claude Code 本体は 12 以上が動作要件ですが、最新の Node.js LTS（22）も macOS 11 以上を要求するので、結局 Monterey 以降にしておく必要があります。

アーキテクチャ（Apple Silicon か Intel か）を確認する

ここが Mac セットアップで最も間違えられないポイント です。インストール先のパスがまるごと変わります。

uname -m
# arm64    → Apple Silicon（M1 / M2 / M3 / M4 系）
# x86_64   → Intel Mac

もう 1 つ、現在のプロセスがネイティブ動作か Rosetta 経由かを見るコマンド。

arch
# arm64  → ネイティブ動作中
# i386   → Rosetta 経由で動作中（要注意）

Apple Silicon 機で arch が i386 を返した場合、そのターミナルは Rosetta セッションで動いています。後述の「ハマりどころ」セクションで対処法を載せます。

ターミナルアプリの選び方

Claude Code は どんなターミナルでも動きます。標準 Terminal.app で十分。慣れてから iTerm2 か Warp に乗り換える人が多数派です。

Homebrew のインストール（すでに入っている人は skip）

Homebrew は Mac の 事実上の標準パッケージマネージャ です。Node.js を最も素直に入れる方法でもあります。すでに brew --version でバージョンが出るならスキップして OK。

# 入っているか確認
brew --version

# 入っていなければ
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

途中で sudo パスワードと Xcode Command Line Tools のダウンロード確認が走ります。合計で 5〜15 分。

PATH を通す（Apple Silicon は必須）

Apple Silicon ではこの 1 行を必ずやる こと。インストール完了時にも案内が出ます。

# zsh の場合(macOS Catalina 以降のデフォルト)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel Mac は /usr/local/bin が標準で PATH に入っているので追加作業不要。brew doctor で Your system is ready to brew が出れば完璧です。

Node.js のインストール — 4 つの選択肢

Claude Code は Node.js（JavaScript 実行環境） の上で動きます。Mac で Node を入れる方法は 4 つあり、それぞれ向き不向きが違います。

迷ったら ① か ②。一度入れてしまえば、後から ③ に乗り換えるのも難しくありません。

方法① 公式インストーラ（.pkg）— 初心者向け

最もハマりどころが少ない方法。Apple Silicon / Intel どちらも自動判別。

1. https://nodejs.org の 「LTS」 ボタンから .pkg をダウンロード
2. ダブルクリックして すべてデフォルトのまま インストール
3. インストール後 ターミナルを新規ウィンドウで開く
4. node --version npm --version で確認

方法② Homebrew で入れる

Homebrew が入っていれば 1 コマンド。Apple Silicon / Intel 自動判別。

brew install node           # 常に最新メジャー
brew install node@22        # LTS 固定

node@22 のような keg-only Formula で入れた場合は PATH を自分で通す必要があります（echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc）。

方法③ nvm — 複数バージョン切り替え

複数プロジェクトで Node のバージョンを切り替えたいときに使います。React Native や Next.js のメジャー更新を追う人に人気。

# nvm 本体をインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# シェル再起動 or 以下を実行
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# LTS をインストール
nvm install --lts
nvm use --lts
nvm alias default 'lts/*'
node --version

Apple Silicon でも Intel でも同じコマンドで動きます。Mac の nvm と Windows の nvm-windows は別物なので混同しないように。

方法④ nodenv — rbenv / pyenv 系

.node-version をディレクトリに置くだけで切り替わる。rbenv / pyenv を普段使う人向け。

brew install nodenv
echo 'eval "$(nodenv init -)"' >> ~/.zshrc && source ~/.zshrc
nodenv install 22.11.0 && nodenv global 22.11.0

このカリキュラム的には ① か ② を推奨。

Node.js のバージョン要件

Claude Code は Node 18 以上。実務的には Node 20 LTS or 22 LTS を入れておけば困りません。古い場合は brew upgrade node で更新。

Claude Code のインストール

Node.js が入ったら、Claude Code 本体のインストールはたった 1 行です。

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

==-g== は「グローバルインストール」のオプション。これで、どのフォルダにいても claude コマンドが使えます。完了まで 30 秒〜1 分。added X packages が出れば成功です。npm WARN は無視 OK、==npm ERR だけ要対処==。

EACCES: permission denied が出る場合

Mac で最頻出。Node を 公式 .pkg で入れた場合、グローバル先が /usr/local/lib/node_modules で root 権限が必要です。sudo を使わず ~/.npm-global 方式に切り替えるのが筋。

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

sudo を 1 回でもやると ~/.npm の所有者が root に変わって以後トラブルの種になります。やってしまった場合は sudo chown -R $(whoami) ~/.npm で戻せます。Homebrew or nvm で Node を入れていれば最初から sudo 不要。

インストールできたか確認

claude --version
# 1.x.x のような番号が表示されれば成功

「command not found: claude」が出る場合は、後述「ハマりどころ」の PATH の罠 を参照。

動作確認 — claude --version まで

API キーを設定する前の段階で、コマンドが認識されているかをチェックします。

claude --version       # 1.x.x が出れば OK
claude --help          # オプション一覧
which claude
# /opt/homebrew/bin/claude     (Apple Silicon + Homebrew)
# /usr/local/bin/claude         (Intel Mac + Homebrew or 公式 .pkg)
# ~/.npm-global/bin/claude      (npm prefix を変えた場合)
# ~/.nvm/versions/node/.../bin  (nvm)

==which claude== の出力は、何かトラブったときに最初に確認すべき情報です。どの Node がインストールしたのかをパスから逆算できます。

Anthropic API キーの取得

Claude Code は Anthropic のサーバーに API を叩いて応答を受け取る クライアントです。そのため API キー（あなた専用の鍵） が必要。

[あなたの Mac] ─── 指示 ───▶ [Anthropic API] ─── 応答 ───▶ [あなたの Mac]
                              ↑ API キーで認証 / 使った分だけ課金

ステップ① Console に登録

https://console.anthropic.com を開いて 「Sign up」 → メール or Google で登録 → メール認証 → 組織名入力。所要時間 2〜3 分。

ステップ② 課金設定（クレジット購入）

Claude Code は プリペイド方式。「Billing」→「Buy credits」で 最初は $5〜$10 購入。1 セッション $0.5〜$3 なので $5 で 5〜10 回試せます。クレジットは 1 年で失効。

ステップ③ 月額上限を必ず設定する

超重要。設定し忘れると Claude が暴走して数千円〜数万円使うリスクがあります。「Settings」→「Limits」→ 「Monthly limit」 を $20〜$50 に。

ステップ④ API キーを発行

「API Keys」→「Create Key」→ 名前入力（例「My MacBook」）→ ==sk-ant-api03-... で始まるキーが表示される。このキーは一度しか表示されない ので必ず 1Password / iCloud Keychain== などに保存。.txt 平文保存はマルウェアに抜かれるリスクがあります。

初回起動 — claude と打ったらどうなるか

API キーが手元にあればいよいよ起動です。

# プロジェクト用フォルダを作って移動
cd ~/Documents
mkdir my-first-claude-project
cd my-first-claude-project

claude

==必ずプロジェクトのフォルダに入ってから claude を起動 してください。Claude Code は 起動したフォルダ以下== をプロジェクトとして認識します。ホームディレクトリで起動すると Downloads や Desktop まで読みに行ってコンテキストが汚染されます。

初回起動するとこんな画面が出ます。

╭──────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code                     │
│ Choose authentication method:                │
│  ❯ 1. Anthropic API Key                      │
│    2. Claude Console (OAuth)                 │
│    3. Use existing credentials               │
╰──────────────────────────────────────────────╯

==1. Anthropic API Key== を選んで、sk-ant-api03-... を貼り付けて Enter。キーは自動で ~/Library/Application Support/claude/config.json に保存されるので次回以降は不要です。==共有 Mac では chmod 600 でアクセス権を絞る== ことを推奨。

利用規約に同意すると対話画面が開きます。==>== が表示されれば準備完了。

> こんにちは。動作確認テストです。今日の日付を教えて。

Claude が応答を返し再度 > が出れば正常です。

Mac 特有のハマりどころ

ここから、Mac ユーザーが 実際にハマりやすい 6 つの罠 をまとめます。先に読んでおくだけで、「動かない」で 1 時間溶かす事故を防げます。

罠① Apple Silicon と Rosetta の混在

Apple Silicon Mac で過去に Rosetta を有効化してターミナルを起動してしまうと、その先で入れた Homebrew・Node・Claude Code は すべて Intel 用バイナリ になります。パフォーマンスが半減 し、ネイティブ版と混在して command not found が頻発します。

arch          # arm64 ならネイティブ / i386 なら Rosetta
# Terminal.app の情報 (⌘+I) で「Rosetta を使用して開く」をオフ

すでに Rosetta 環境で Homebrew を入れてしまったら、==/usr/local/Homebrew を消して /opt/homebrew に入れ直す のが最短。2026 年現在 ほぼ全主要ツールが Apple Silicon ネイティブ対応== しており、Rosetta が必要な場面はほぼゼロです。

罠② PATH が通っていない — command not found: claude

最頻出のエラー。npm のグローバル先が PATH に入っていないだけです。

# どこに入ったか確認
npm config get prefix
ls $(npm config get prefix)/bin/ | grep claude

# PATH に追加
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

罠③ shellrc が複数ある（.zshrc .zprofile .bashrc）

Mac の zsh は ==~/.zshrc（インタラクティブシェル）と ~/.zprofile==（ログインシェル）の 2 つを読みます。Homebrew は .zprofile、nvm は .zshrc という慣習。シンプルなルールは下記の通り。

• ==Homebrew の shellenv== → ~/.zprofile
• PATH 追加 / alias / 環境変数 → ~/.zshrc
• nvm の初期化 → ~/.zshrc

迷ったら ==全部 ~/.zshrc== に書いておけば、まず動きます。

罠④ Gatekeeper / 「開発元を検証できません」警告

claude のような新しいコマンドを最初に実行すると、Gatekeeper が止めてくることがあります。

# 対処: コマンドラインで隔離属性を外す
xattr -d com.apple.quarantine $(which claude)

# システム設定 → プライバシーとセキュリティ から個別許可も可

==spctl --master-disable で Gatekeeper 自体を切るのは絶対 NG==（マルウェアフリーパス状態になります）。

罠⑤ SIP（System Integrity Protection）

/System 配下を root でも書き換え不可にする仕組み。直接 Claude Code に影響する場面は少ないですが、システム由来の Node を sudo で書き換えようとすると弾かれます。対処は素直に Homebrew or nvm を使う ことです。csrutil status が enabled なのが正常。disabled にする必要はありません。

罠⑥ sudo の警告とパーミッション破壊

sudo npm install -g を 1 回でも実行すると、==~/.npm キャッシュの所有者が root に変わって== しまい、以後パーミッションエラーが起こります。

# 復旧:
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.npm-global

根本的には sudo を使わない構成にする のが正解。「Homebrew で Node」「npm prefix 変更」「nvm」のどれでも sudo 不要です。

Windows との違い（補足）

どちらも本質的な操作は同じ です。claude を打って > で指示を入れる。それだけ。2026 年現在 Windows でも 99% 同じ機能・同じパフォーマンス。Mac に憧れて買い替える必要はありません。

アップデート方法

Claude Code は 週単位でアップデート されることもあります。月に 1 回くらい を目安に。

# 普段のアップデート
npm update -g @anthropic-ai/claude-code

# 明示的に最新版を入れ直す
npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest

# 特定バージョンに戻す
npm install -g @anthropic-ai/claude-code@1.0.0

# Homebrew で入れた Node 本体のアップデート
brew upgrade node

アンインストール / クリーンインストール

何かおかしくなったら クリーンインストールが最速。3 ステップ。

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/Library/Application\ Support/claude ~/Library/Caches/claude
rm -rf ~/.claude  # CLAUDE.md など個別設定 (要バックアップ)
npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest

Node.js ごと入れ直したい 場合、Homebrew なら brew uninstall node && brew install node。公式 .pkg なら /usr/local/{bin/node,bin/npm,lib/node_modules} を手動削除して LTS を入れ直し。30 分悩むより 3 分で全部消したほうが早い。

トラブルシューティング Q&A

ここを ブックマーク しておくと安心です。

Q1. EACCES: permission denied と出る

Mac で最頻出。sudo は付けず、~/.npm-global 方式に切り替えるのが筋。

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

Q2. npm install が途中で固まる

ネットワーク不安定が大半。--verbose で止まっている箇所が分かります。

npm cache clean --force
npm install -g @anthropic-ai/claude-code --verbose

Q3. 「Invalid API key」と出る

3 つの原因が考えられます。

1. コピペ時に余分な空白 が入っている
2. クレジット残高がゼロ（Console で確認）
3. キーが古い / 削除済み（Console で新規発行）

claude /logout で再認証フローに入れます。

Q4. モデル名を指定したい

claude --model opus              # 起動時
> /model opus                    # セッション中

利用可能なモデルは ==sonnet / opus / haiku==。詳しくは第 9 章「コスト管理」で扱います。

Q5. 応答が遅い・止まる

• 接続 — ping api.anthropic.com
• プロジェクト巨大 — .claudeignore で node_modules/ .git/ dist/ *.log .DS_Store 等を除外
• メモリ枯渇 — アクティビティモニタで確認

Q6. Apple Silicon で Intel 用バイナリが混ざった

Intel Homebrew（/usr/local/Homebrew）と Apple Silicon Homebrew（/opt/homebrew）が両方あると brew コマンドが どちらを呼んでいるか分からなく なります。which brew で確認 → Intel 側を削除して Apple Silicon ネイティブに揃えるのが安全。

Q7. 日本語入力で文字化けする

ロケールが C や POSIX になっています。

locale
echo 'export LANG=ja_JP.UTF-8' >> ~/.zshrc
echo 'export LC_ALL=ja_JP.UTF-8' >> ~/.zshrc
source ~/.zshrc

まとめ

このレッスンで押さえてほしいことを 7 つ並べます。自分の言葉で説明できる ようになるまで、何度か戻ってきても OK です。

1. Mac は Claude Code が 最も素直に動く OS。brew install node と npm install -g @anthropic-ai/claude-code の 2 行で終わる
2. Apple Silicon と Intel でインストール先パスが違う。uname -m を最初に叩いて確認
3. Node.js は 4 つの方法がある。迷ったら公式 .pkg か Homebrew
4. Anthropic Console で API キーを発行する前に、必ず月額上限を設定 する
5. 初回起動は ==プロジェクトフォルダに移動してから claude==。ホームディレクトリで起動しない
6. ハマりどころ 6 つは Rosetta / PATH / shellrc / Gatekeeper / SIP / sudo 警告。先に潰しておく
7. 何かおかしくなったら クリーンインストールが最速（3 分で復旧）

<Checklist items={["uname -m と arch で自分の Mac のアーキテクチャを確認した","node --version で v18 以上が出ることを確認した","npm install -g @anthropic-ai/claude-code を実行した","claude --version でバージョンが表示された","console.anthropic.com で月額上限を設定した（重要）","API キーをパスワードマネージャに保存した","プロジェクトフォルダで claude を起動して > が表示された"]} />

<Quiz question="Mac（Apple Silicon）で Claude Code を入れる際、PATH 問題を最も避けやすいインストール方法はどれですか？" options={["公式 .pkg をインストール後、sudo npm install -g で Claude Code を入れる","Homebrew で Node を入れ、npm config set prefix で ~/.npm-global に変えてから npm install -g する","Rosetta を有効にしたターミナルで Intel 版の Homebrew を入れる"]} answer={1} />

次のレッスン 2-3: 初回起動と動作確認 では、インストールした Claude Code を起動し、基本操作（指示入力、中断、終了、コスト確認、会話圧縮）まで一通り押さえます。すでに claude が動いているなら、第 3 章「はじめての指示」までジャンプしても OK です。