Claude Code Macインストール — ネイティブとHomebrew、どちらを選ぶか
Claude CodeをMacに入れる方法は主に3つ。ネイティブインストーラー・Homebrew・npmの違いと、macOS特有のエラーへの対処までまとめます。
Macでの入れ方は3通りある
MacへのClaude Code導入は、ネイティブインストーラー・Homebrew・npmの3経路があります。迷ったらネイティブインストーラーが最短です。ターミナルで1行のcurlコマンドを実行するだけで、バックグラウンド自動更新まで含めて完結します。Homebrewは他のパッケージをbrewで管理しているユーザー向け、npmはNode.jsのワークフローに組み込みたい場合の選択肢です。
インストール前に確認する3つのこと
導入前に、次の要件を満たしているか確認します。
| 項目 | 要件 |
|---|---|
| OS | 要件macOS 13.0以降 |
| メモリ | 要件4GB以上 |
| プロセッサ | 要件Appleシリコン(ARM64)またはIntel(x64) |
| ネットワーク | 要件インストール・利用ともに常時接続が必要 |
| シェル | 要件zsh(macOSの既定)またはbash |
検索コマンドが使うripgrepは通常はバイナリに同梱されており、個別インストールは不要です。検索が失敗する場合は検索まわりのトラブルシューティングを確認します。
ネイティブインストーラーでインストールする手順
最も手数が少ない方法です。ターミナルを開き、次のコマンドを実行します。
curl -fsSL https://claude.ai/install.sh | bashこのコマンドはclaude本体を~/.local/bin/claudeに、実体を~/.local/share/claude/versions/以下に配置します。以降はClaude Code自身がバックグラウンドで最新版を取得し続けるため、claude updateを手動で叩く必要は基本的にありません。
バイナリは「Anthropic PBC」名義でコード署名され、Appleの公証も済んでいます。公証済みのため、初回起動時にGatekeeperの警告は通常出ません。署名を自分で確認したい場合は次のコマンドで検証できます。
コード署名を手動で検証する
codesign --verify --verbose ./claudemanifest.jsonの署名検証と合わせて使うと、ダウンロードしたバイナリが改ざんされていないかまで確認できます。マニフェスト署名はv2.1.89以降のリリースから提供されています。
インストールが終わったら、作業したいプロジェクトのディレクトリでターミナルを開き、次を実行します。
claude初回起動時はブラウザ経由のログイン画面が開きます。ログインが済むと対話セッションが始まります。インストールが正しく完了したかは、別のターミナルでclaude --versionを実行して確認できます。
Homebrewでインストールする手順
Homebrewで他のCLIツールを管理しているなら、caskでの導入も選べます。
brew install --cask claude-codeHomebrewには2種類のcaskがあります。claude-codeは安定版チャネルで、最新リリースからおよそ1週間遅れて追従し、大きな不具合が見つかったリリースはスキップします。claude-code@latestは最新版チャネルで、リリース直後のバージョンをそのまま追跡します。
Homebrew経由のインストールは、ネイティブインストーラーと違って既定では自動更新されません。更新は手動です。
brew upgrade claude-code環境変数CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEを1に設定すると、新しいバージョンが出たときにClaude Code自身がバックグラウンドでこの更新コマンドを代行し、成功後に再起動を促します。対象はClaude Codeパッケージだけで、他にHomebrewで入れたソフトには影響しません。
3経路の使い分けをより詳しく比較したい場合は、Claude Code Homebrew・npm・ネイティブ導入の比較で評価軸ごとに整理しています。
npmでもインストールできる
Node.jsのワークフローに組み込みたい場合は、npmのグローバルパッケージとしても導入できます。
npm install -g @anthropic-ai/claude-codev2.1.198以降、npmパッケージはNode.js 22以降を要求します。古いNode.jsではEBADENGINE警告が出ますが、インストール自体は完了しclaudeも動きます。パッケージはプラットフォームごとの依存関係(Appleシリコンなら@anthropic-ai/claude-code-darwin-arm64、Intelなら@anthropic-ai/claude-code-darwin-x64)経由でネイティブバイナリを取得する仕組みで、実行時にNode.js自体は使いません。
sudo npm install -gは使わないでください。権限エラーや意図しないファイル所有権の変更につながります。権限エラーが出た場合は、npmのグローバルディレクトリの所有権を自分のユーザーに変更してから入れ直します。
特定のバージョンやチャネルを指定してインストールする
ネイティブインストーラーは、バージョン番号またはlatest/stableのリリースチャネルを引数に取ります。何も指定しなければインストール時に選んだチャネルがそのまま自動更新の既定になります。
curl -fsSL https://claude.ai/install.sh | bash -s stable特定バージョンに固定したい場合はバージョン番号を渡します。
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89stableチャネルは最新リリースからおよそ1週間遅れで追従し、大きな不具合が見つかったリリースをスキップします。検証環境で最新機能をすぐ試したい場合は既定のlatestのまま、業務用のMacで挙動を安定させたい場合はstableを指定する、という使い分けが基本です。
macOS特有のエラーと対処
dyld: cannot loadが出る
dyld: Symbol not foundやdyld: cannot load、Abort trap: 6が出た場合、バイナリがそのMacのmacOSバージョンに対応していません。原因はほぼ常にmacOS 13.0未満です。Appleメニューの「このMacについて」でバージョンを確認し、古ければmacOSを更新します。HomebrewやnpmでもOSレベルのこの制約は変わらず、経路を変えても解決しません。詳しいエラーパターンの見分け方はdyld cannot loadエラーの原因と対処にまとめています。
TLS/SSLの接続エラーが出る
curl: (35) TLS connect errorのようなエラーは、TLSハンドシェイクの失敗です。macOSの標準curlはKeychainの信頼ストアを使うため、大半のケースはmacOS自体を最新に更新すれば解消します。企業のプロキシがTLSを検査する環境では、プロキシのCA証明書を明示的に指定してインストールを実行します。
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bashインストールしたのにclaudeが見つからない
インストール自体は成功していても、ターミナルを再起動していないとcommand not found: claudeが出ることがあります。PATHへの反映とVS Code拡張機能特有の罠を含めた切り分け手順はClaude Codeのcommand not foundをPATH設定で直すで扱っています。
VS Code拡張機能だけ入れている
インストール先ディレクトリへの書き込み権限がない
会社支給のMacで、インストーラーが途中で止まる場合は書き込み権限を疑います。ネイティブインストーラーは~/.local/bin/と~/.claude/への書き込み権限を必要とします。
test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"どちらかがnot writableと出た場合、ディレクトリを作成し所有者を自分のユーザーに変更します。
sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.localアップデートとアンインストール
ネイティブインストールは起動時と実行中に定期的に更新を確認し、バックグラウンドでダウンロードします。適用は次回起動時です。直近の更新結果はclaude doctorで確認できます。
アンインストールする場合、経路ごとにコマンドが異なります。
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeHomebrewで入れた場合は、インストールしたcaskに合わせて次のいずれかを実行します。
brew uninstall --cask claude-codebrew uninstall --cask claude-code@latestnpmで入れた場合は次を実行します。
npm uninstall -g @anthropic-ai/claude-codeアンインストール後もclaudeが動く場合、別経路の古いインストールが残っています。which -a claudeで複数のバイナリが見つからないか確認します。
よくある質問
AppleシリコンとIntel Macで手順は変わりますか
変わりません。ネイティブインストーラーのcurlコマンドは共通で、実行時にアーキテクチャを自動判定します。npm経由の場合も、Appleシリコンならdarwin-arm64、Intelならdarwin-x64のパッケージが自動選択されます。
Homebrewで入れたあとネイティブインストーラーに乗り換えられますか
乗り換え可能です。ただし経路が混在するとwhich -a claudeで複数のバイナリが見つかる状態になり、意図しない古いバージョンが起動することがあります。乗り換える前に元の経路をアンインストールしてから、新しい経路で入れ直すのが安全です。
会社のMacで管理者権限がなくてもインストールできますか
ネイティブインストーラーは~/.local/binと~/.claudeへの書き込み権限があれば動作し、管理者権限は不要です。Homebrew自体の初回導入に管理者権限が必要な環境では、社内配布されたHomebrewを使うか、情報システム部門にネイティブインストーラーの利用可否を確認します。
まとめ
Macへの導入で迷ったら、ターミナルでcurlコマンドを実行するネイティブインストーラーが最短です。Homebrewでツールを一元管理したいならbrew install --cask claude-code、Node.jsのワークフローに組み込みたいならnpmを選びます。導入後はclaude --versionで動作を確認し、dyld: cannot loadが出た場合はmacOSのバージョンを、command not foundが出た場合はPATHの設定を、それぞれ疑います。