「Claude CodeをMacに入れたいが、ターミナルを開いたことがない」という声をよく聞きます。コマンド自体は数行ですが、実際につまずくのはその前後(開き方、PATH設定、エラー対処)です。
この記事では2026年9月2日時点で確認した公式ドキュメントをもとに、Mac特有のつまずきを整理します。本記事はclaudecode道場(malna株式会社が独自に提供する学習サービス)のブログ記事であり、Anthropic公式のドキュメントそのものではありません。
目次
- Macのインストール方法は4種類ある
- 事前確認:システム要件・アカウント・チップの違い
- ターミナルの開き方
- ネイティブインストーラーでインストール(推奨)
- Homebrew・npmでインストール
- 動作確認とログイン
- zshとPATHの設定(最頻出のつまずき)
- Gatekeeper警告への考え方
- よくあるエラーと対処法
- アンインストール方法
- よくある質問(FAQ)
1. Macのインストール方法は4種類ある
事実(出典あり):公式ドキュメントによると、インストール方法は次の4種類です(Claude Code 公式セットアップドキュメント、確認日2026年9月2日)。
| 方法 | 特徴 |
|---|---|
| ネイティブインストーラー(推奨) | 公式が明記する推奨方法。自動更新される |
| Homebrew | 安定版・最新版の2種のcask。手動更新 |
| npm | Node.js 22以上が必須(v2.1.198以降) |
| デスクトップアプリ | ターミナル不要のグラフィカル版 |
デスクトップアプリの導入手順はClaude Codeのインストール方法【Mac・Windows完全対応】で扱っているため、本記事ではターミナルを使う3方法を中心に解説します。
2. 事前確認:システム要件・アカウント・チップの違い
事実(出典あり):システム要件はmacOS 13.0以上、4GB以上のRAM、x64またはARM64プロセッサ、インターネット接続です(出典同上)。バージョンはAppleメニュー→「このMacについて」で確認できます。利用にはPro・Max・Team・Enterprise・Consoleいずれかのアカウントが必要で、無料プランは対象外です。
事実(出典あり):Apple SiliconとIntelの違いは、ターミナルからのインストールではほぼ気にする必要がありません。npm経由の対応プラットフォームにはdarwin-arm64(Apple Silicon用)とdarwin-x64(Intel用)の両方が明記され、自動選択されます(出典同上)。
3. ターミナルの開き方
事実(出典あり):公式のターミナルガイドでは、Macでの開き方として次の手順が案内されています(Claude Code 公式ターミナルガイド、確認日2026年9月2日)。Cmd + Spaceを押し、「ターミナル」と入力してEnterを押します。黒っぽい背景のウィンドウが開けば準備完了です。以降はCmd + Vで貼り付け、Enterで実行します。
4. ネイティブインストーラーでインストール(推奨)
事実(出典あり):公式が「Recommended(推奨)」と明記する方法です(出典同上)。
curl -fsSL https://claude.ai/install.sh | bash
claude.aiからインストーラーをダウンロードして実行し、完了メッセージが表示されれば成功です。バックグラウンドで自動更新される点が、Homebrew・npmとの違いです。
5. Homebrew・npmでインストール
Homebrewの場合
brew install --cask claude-code
事実(出典あり):claude-code(安定版)とclaude-code@latest(最新版)の2種のcaskがあり、自動更新はされません(出典同上)。brew upgrade claude-codeで更新します。
npmの場合
npm install -g @anthropic-ai/claude-code
事実(出典あり):v2.1.198以降Node.js 22以上が必須です。sudo npm install -gは権限・セキュリティリスクにつながるため使わないよう明記されています(出典同上)。
6. 動作確認とログイン
事実(出典あり):インストール後、claude --versionでバージョンが表示されれば成功です。作業フォルダでターミナルを開きclaudeを実行すると初回はログインを求められ、指示に従うとブラウザでAnthropicアカウントのサインインができます(出典同上)。より詳しい診断には読み取り専用コマンドclaude doctorが使えます。
7. zshとPATHの設定(最頻出のつまずき)
Macで最も起きやすいのが、インストール自体は成功しているのにclaudeコマンドが見つからないzsh: command not found: claudeというエラーです。
推論・補足:現在のMacでは「zsh」というシェルが標準です。このエラーは、claudeコマンドの場所がzshの検索対象(PATH)に含まれていないために起きます。
事実(出典あり):対処法として、公式ドキュメントでは次のコマンドが案内されています(Claude Code 公式トラブルシューティング、確認日2026年9月2日)。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
1行目で~/.zshrcにPATHの追加設定を書き加え、2行目でそれをターミナルに読み込み直します。新しいターミナルウィンドウでclaude --versionを試すと、多くの場合ここで解決します。ファイル名先頭の「.」はMacの隠しファイルの意味で、Finderには出ませんがターミナルからは編集できます。
8. Gatekeeper警告への考え方
推論・補足(一般的なmacOSの仕組みについて):macOSには「Gatekeeper」があり、ダウンロードしたアプリを初めて開くとき「開発元を確認できません」という警告を出すことがあります。macOS全般の一般機能で、Claude Code固有の仕様ではありません。
事実(出典あり):公式ドキュメントには、macOS向けバイナリが「Anthropic PBC」によって署名され、Appleによって公証(notarize)されていると明記されています(出典同上)。署名・公証済みのため警告は出にくいと考えられますが、万一出た場合は「システム設定」→「プライバシーとセキュリティ」下部の「このまま開く」から開けます(macOSの一般知識であり、Anthropic公式の記載ではありません)。
9. よくあるエラーと対処法
事実(出典あり):macOSで起きやすいエラーです(出典同上)。
dyld: cannot loadや「built for Mac OS X 13.0」:macOSが13.0未満の可能性があります。ソフトウェアアップデートで更新してください。- HTMLやエラーが返りスクリプトが実行されない:ネットワークや地域制限の影響です。「App unavailable in region」ならサポート対象国を確認し、他は時間を置いて再試行するかHomebrewに切り替えます。
- 権限エラーで止まる:
sudo mkdir -p ~/.local/bin && sudo chown -R $(whoami) ~/.localで書き込み権限を設定します。
解決しない場合は公式ガイドを確認してください。
10. アンインストール方法
方法ごとに手順が異なります(出典同上)。
- ネイティブ:
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude - Homebrew:
brew uninstall --cask claude-code(@latestを入れた場合はそちらを指定) - npm:
npm uninstall -g @anthropic-ai/claude-code
事実(出典あり):設定ファイルまで削除すると、設定・許可されたツール・MCPサーバー構成・セッション履歴が失われます(出典同上)。CLAUDE.mdなど必要な設定は事前にバックアップしrm -rf ~/.claude && rm ~/.claude.jsonを実行します。アンインストール後もclaudeが動く場合はwhich -a claudeで残存分を確認してください(出典同上)。
よくある質問(FAQ)
Q: どのインストール方法がおすすめですか。 A: 公式が「Recommended」と明記するネイティブインストーラーです。自動更新される点もメリットです。
Q: command not found: claudeと表示されます。
A: コマンドの場所がPATHに登録されていません。「zshとPATHの設定」の~/.zshrcへの追記コマンドを実行し、新しいターミナルで再度試してください。
Q: 無料のClaude.aiアカウントでも使えますか。 A: 使えません。Pro・Max・Team・Enterprise・Consoleのいずれかが必要です。
この記事のポイント
- インストール方法は、ネイティブインストーラー(推奨)・Homebrew・npm・デスクトップアプリの4種類
- Apple SiliconとIntelでコマンドに違いはなく、npmが自動でバイナリを選ぶ
- 最も起きやすいのは
command not found: claudeで、原因は~/.zshrcへのPATH未追加 - macOSバイナリは署名・公証済みのため、通常Gatekeeper警告は出にくい
- アンインストールは方法ごとに手順が異なり、設定ファイルまで消すとCLAUDE.mdやMCP設定も失われる
参考情報ソース(確認日:2026年9月2日)
あわせて読みたい:




