Claude CodeのMacインストール手順｜Homebrewとの違いとエラー対処

「Claude CodeをMacに入れたいけれど、ターミナルを開いたことがない」「Homebrewは必要なのか」と迷っている方も多いのではないでしょうか。

結論から言うと、Macでは、ターミナルにコマンドを1行貼り付けるだけで入れられます。Node.jsを先に入れる必要はなく、Homebrewも必須ではありません。Node.jsを先に入れる手順で紹介している記事もありますが、現在の公式ドキュメントでは、Node.jsは前提になっていません。最初に案内されているのは、この1行の方法です。

この記事では、入れる前に確認すること、ターミナルでの手順、Homebrewやnpm、デスクトップアプリで入れる場合、ログインと動作確認、Macで起きやすいエラーの直し方、更新とアンインストールまでを順に解説します。内容は2026年10月時点の公式ドキュメントをもとにしています。コマンドは変わることがあるので、実行前に公式ドキュメントでも確かめてください。

入れる前に確認すること

Claude Codeは、Anthropic社のAI「Claude」に、パソコンの中のファイルを読ませたり、プログラムを書かせたりできる道具です。ターミナル（文字を入力して操作する画面）から使うのが基本です。入れる前に、次の3点を確かめておきましょう。

動作環境

公式ドキュメントに載っている動作環境のうち、Macに関わるものは次のとおりです。

公式ドキュメントの動作環境に、Node.jsやGitは含まれていません。Node.jsが必要になるのは、npmで入れる場合だけです。

macOSのバージョンの確かめ方

画面の左上にあるAppleマークをクリックして、「このMacについて」を選ぶと、macOSのバージョンが表示されます。13.0より古い場合は、「ソフトウェアアップデート」でmacOSを更新してからインストールします。

古いmacOSのまま入れようとすると、dyld から始まるエラーで止まります。更新しないかぎり、別の入れ方でも直りません。詳しくは、後の「うまくいかないときの対処」で説明します。

必要なプラン

Claude Codeを使うには、Claudeの有料プラン（Pro・Max・Team・Enterprise）か、Claude Console（API）のアカウントが必要です。公式ドキュメントでは、無料のclaude.aiプランにはClaude Codeが含まれないと明記されています。Amazon Bedrock・Google Cloud・Microsoft Foundryといったクラウドサービス経由で使う方法もあります。

インストール自体はアカウントがなくても進められますが、入れたあとのログインで有料プランのアカウントが必要になります。先に契約しておくと、そのまま使い始められます。

入れ方の選び方

Macで入れる方法は、大きく4つあります。迷ったら、一番上の「ターミナルのインストーラー」を選べば問題ありません。

デスクトップアプリは、Claudeのアプリの「Code」タブからClaude Codeを使う方法です。画面を見ながら操作でき、Node.jsやコマンドラインのClaude Codeを別に入れる必要はありません。この記事では、ターミナルで使う方法を中心に説明し、アプリについては後の章で触れます。

ターミナルでのインストール手順

公式が最初に案内している方法です。インストーラーが書き込むのは、自分のユーザーフォルダの中（~/.local や ~/.claude など）です。

ターミナルを開く

Macでは、Spotlight（検索）から開くのが簡単です。キーボードの Cmd を押しながら Space を押し、「Terminal」と入力して Return を押します。点滅するカーソルのあるウィンドウが開けば、それがターミナルです。公式の初心者向けガイドでも、この手順が案内されています。

ターミナルでは、コマンドの貼り付けに Cmd + V を使います。

手順

1. ターミナルを開くCmd + Space で検索を開き、「Terminal」と入力して Return を押します。
2. コマンドを貼り付けて実行する下のコマンドをコピーし、ターミナルに Cmd + V で貼り付け、Return を押します。
3. 終わるまで待つインストール中は、進み具合が表示されません。画面が止まっているように見えても、閉じずに待ちます。終わると「Claude Code successfully installed!」と表示されます。
4. 新しいウィンドウで確認するターミナルをいったん閉じて開き直し、claude --version と入力します。2.1.211 (Claude Code) のようにバージョンの番号が表示されれば成功です。
5. 作業するフォルダで起動するcd コマンドで作業したいフォルダに移動し、claude と入力します。初回はブラウザでのログインに進みます。

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

このコマンドの curl は、インストーラーのファイルを取ってくる命令です。それを bash に渡して実行します。インストールが終わると、Claude Code本体が ~/.local/bin/claude に置かれます。~ は自分のユーザーフォルダのことで、.local は、先頭にドットが付いた隠しフォルダです。

手順5の「フォルダに移動する」は、たとえば次のように入力します。フォルダ名は自分のものに置き換えてください。

cd ~/Documents/my-project
claude

バージョンを指定して入れる

通常は最新版が入りますが、安定版や特定のバージョンを指定することもできます。会社で全員の環境をそろえたいときなどに使います。コマンド末尾の bash のあとに、-s と入れたいものを付けます。

入れたあとに claude --version を実行すると、指定したバージョンが表示されます。公式ドキュメントによると、入れるときに選んだ配信（stableまたはlatest）が、その後の自動更新の既定にもなります。

Homebrew・npmで入れる場合

ターミナルのインストーラーが使えない事情がある場合や、ソフトの管理をHomebrewなどに統一したい場合は、別の方法でも入れられます。どちらも、インストーラーで入れる方法より更新の手間が増えます。

Homebrewで入れる

Homebrewは、Macでソフトを入れたり更新したりするための道具です。すでに使っている方は、次のコマンドで入れられます。Homebrew自体の入れ方は、公式のClaude Codeドキュメントでは説明されていません。入れていない場合は、Homebrewの公式サイトを参照してください。

brew install --cask claude-code

Homebrewには、Claude Code用に2つの「cask」（Mac用のアプリを入れる仕組み）があります。どちらを入れるかで、受け取る版が変わります。

Homebrewで入れたClaude Codeは、自動では更新されません。新しい機能や安全性の修正を受け取るには、入れたcaskに合わせて、次のどちらかを自分で実行します。

brew upgrade claude-code
brew upgrade claude-code@latest

環境変数 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にすると、新しい版が出たときにClaude Codeが裏でこの更新を実行してくれます。

Homebrewは、更新したあとも古い版をディスクに残します。空き容量を確保したいときは、ときどき brew cleanup を実行してください。

npmで入れる

npmは、Node.jsというプログラムの実行環境に付いてくるソフトの管理道具です。すでにNode.jsを使っている開発者向けの方法で、Node.jsを持っていない方が、このためだけに入れる必要はありません。

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

公式ドキュメントによると、npmで入れる場合はNode.js 22以降が必要です。古いバージョンでは「EBADENGINE」という警告が出ますが、インストールは完了し、claude も動きます。npmのパッケージは、インストーラーで入れるものと同じ実行ファイルを取り込むだけで、起動のときにNode.jsは使われないためです。Macには、Apple Silicon用（darwin-arm64）とIntel用（darwin-x64）の2種類が用意されています。

更新するときは、npm update -g ではなく、次のコマンドを使います。npm update -g では、最初に入れたときの範囲に縛られて、最新版にならないことがあるためです。

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

複数の方法で入れてしまったとき

ターミナルのインストーラーとHomebrew、npmの複数で入れると、どれが動いているのか分かりにくくなり、バージョンの食い違いが起きます。次のコマンドで、パスの通っている claude を一覧できます。

which -a claude

複数見つかった場合は、公式がおすすめしているインストーラーで入れたもの（~/.local/bin/claude）を残し、ほかを消します。Homebrewで入れたものは brew uninstall --cask claude-code（claude-code@latest を入れた場合はその名前）、npmで入れたものは npm uninstall -g @anthropic-ai/claude-code で消せます。

デスクトップアプリで使う場合

ターミナルを使うこと自体を避けたい方には、Claudeのデスクトップアプリがあります。公式ドキュメントでは、画面の操作だけでClaude Codeを使う方法として案内されています。

1. アプリをダウンロードする公式ドキュメントのリンクから、Mac用のインストーラー（ディスクイメージ）をダウンロードします。IntelとApple Siliconの両方に対応した「ユニバーサルビルド」です。
2. アプリを起動してサインインするインストーラーを実行し、アプリケーションフォルダからClaudeを起動して、Anthropicのアカウントでサインインします。
3. 「Code」タブを開く画面の上部中央にある「Code」タブをクリックします。有料プランに入っていないと、アップグレードを促されます。
4. フォルダを選んで頼む「Local」を選び、作業したいフォルダを指定して、やりたいことを書きます。

公式ドキュメントでは、デスクトップアプリにはClaude Codeが含まれているため、Node.jsやコマンドラインのClaude Codeを入れる必要はないとされています。一方で、ターミナルから claude と入力して使いたい場合は、このアプリとは別に、前の章の方法でインストールする必要があります。

ログインと動作確認

インストールが終わったら、ログインして、正しく動いているかを確かめます。

ログインする

作業したいフォルダで claude と入力すると、初回はログインの画面になります。画面の案内に従うと、ブラウザが開くので、Claudeのアカウントでサインインします。

1. claudeを起動するターミナルで作業するフォルダに移動し、claude と入力します。
2. ブラウザでサインインする自動で開いたブラウザで、Claudeのアカウントを選んでサインインします。ブラウザが開かないときは、c キーでURLをコピーして、手動でブラウザに貼り付けます。
3. 「Login successful」を確認するターミナルに「Login successful」と表示されたら、Return キーを押して続けます。

Macでは、ログイン情報は暗号化されたmacOSの「キーチェーン」に保存されます。一度ログインすれば、次回からは再度のログインは要りません。アカウントを切り替えたいときや、ログインし直したいときは、Claude Codeの中で /login や /logout と入力します。

動作確認の方法

入れたあとは、次の2つで確かめられます。

claude doctor は、診断結果を表示するだけで、設定を書き換えることはありません。「入ったはずなのに何かおかしい」と感じたときに、まず実行してみるとよいでしょう。

最初の使い方

ログインできたら、聞きたいことをそのまま日本語で入力して、Return キーを押します。公式ドキュメントでは、プログラミングの経験がなくても使え、やりたいことを普通の言葉で伝えればよいと案内されています。最初は、次のような依頼から試すのがおすすめです。

• このフォルダにあるファイルの内容を、簡単に説明してください
• デスクトップにあるスクリーンショットを、画像の内容に合わせて名前を付け直してください
• 簡単な「Hello World」を表示するWebページを作ってください

Claudeがファイルの作成や変更の前に許可を求めてきたときは、内容を確認して、問題なければ Return キーで「Yes」を選びます。操作の覚え方として、次のキーを知っておくと便利です。

ターミナルの画面では、マウスでクリックして操作することはできません。カーソルの移動には、矢印キーを使います。

Macのターミナルで押さえておく設定

Claude Codeは、設定をしなくてもMacのどのターミナルでも動きます。ただし、キーボード操作で次の点が変わることがあります。

Claude Codeの初回起動時に、ターミナルの設定を案内する表示が出て、それを受け入れた場合は、Apple純正のターミナルの Option キーの設定がすでに済んでいます。メニューの表記は、macOSのバージョンや表示言語によって異なることがあります。

うまくいかないときの対処

Macで起きやすいエラーを、画面に出る文言から探せるようにまとめました。公式のトラブルシューティングに載っているものだけを扱っています。

エラー別の早見表

エラーの文言は、シェルやmacOSのバージョンによって、細かい言い回しが変わることがあります。文言の一部が一致していれば、同じ原因の可能性が高いです。

「command not found: claude」が出るとき

インストールは終わっているのに、claude と入力すると見つからないと言われる場合は、インストール先のフォルダがPATHに入っていません。次の順で確かめます。

1. ファイルがあるかを確かめる下の1つめのコマンドを実行します。ファイルの情報が表示されれば、Claude Codeは入っています。No such file or directory と出たら、インストールが終わっていないので、もう一度入れます。
2. PATHに入っているかを確かめる下の2つめのコマンドを実行し、何も表示されなければPATHに入っていません。
3. PATHに追加する下の3つめの2行を実行します。1行目で設定を保存し、2行目で今のウィンドウに反映します。1行目は成功すると何も表示しません。
4. 確かめる新しいターミナルのウィンドウを開き、claude --version を実行します。

ls -la ~/.local/bin/claude

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

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

それでも見つからない場合は、次の3つが原因として考えられます。

• ウィンドウが古いすでに開いているウィンドウは、変更前のPATHのままです。新しいウィンドウを開きます。エディタ（VS Codeなど）の中のターミナルを使っている場合は、エディタを終了して開き直します。
• 設定が保存されていないgrep -n '.local/bin' ~/.zshrc を実行します。行が表示されなければ、3つめのコマンドをもう一度実行します。
• 別のシェルのファイルに書いたecho $0 で使っているシェルを確かめます。zsh なら ~/.zshrc、bash なら次の項目の手順です。

Bashを使っている場合

Macの標準はZshですが、Bashに切り替えて使っている方もいます。Bashの場合は、~/.zshrc ではなく ~/.bash_profile に書きます。MacのターミナルはBashを「ログインシェル」として起動し、~/.bashrc を読まないためです。

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

すでに ~/.bash_login や ~/.profile があり、~/.bash_profile がない場合は、~/.bash_profile を新しく作らず、その既存のファイルに書きます。

会社のネットワークで止まるとき

会社のMacでは、ファイアウォールやプロキシが通信を制限していて、インストールや更新が止まることがあります。インストーラーは downloads.claude.ai からファイルを取得します。次のコマンドで、通信できるかを確かめられます。

curl -sI https://downloads.claude.ai/claude-code-releases/latest

1行目に HTTP/2 200 と出れば、通信はできています。403 は、プロキシなどが通信を止めているか、利用できない国・地域である場合に表示されます。5xx は、サービス側の一時的な問題のことが多く、数分待ってやり直します。何も表示されない、または「Could not resolve host」と出る場合は、ネットワークの設定で止められています。

ログインが毎回求められるとき

Macでは、ログイン情報をキーチェーンに保存します。キーチェーンが書き込みを拒否した場合（ロックされている、ログインパスワードとキーチェーンのパスワードが食い違っているなど）は、代わりに ~/.claude/.credentials.json に保存されます。次の順で戻せます。

1. 診断するclaude doctor を実行します。「macOS Keychain is not writable」で始まる警告が出れば、これが原因です。
2. キーチェーンのロックを解除するこの手順の下にあるコマンドを実行し、キーチェーンのパスワードを入力します。
3. それでも直らなければ、パスワードを合わせ直す「キーチェーンアクセス」アプリで「login」のキーチェーンを選び、メニューの Edit → Change Password for Keychain "login" から、アカウントのパスワードと合わせます。
4. ログインし直す/logout のあとに /login を実行します。ログアウトすると、保存されているログイン情報がすべて消えるため、MCPサーバーのログインなども再設定が必要です。

security unlock-keychain ~/Library/Keychains/login.keychain-db

アップデートとアンインストール

更新のしくみ

ターミナルのインストーラーで入れた場合は、Claude Codeが自分で更新します。起動したときと、動いている間の定期的なタイミングで新しい版を確認し、裏でダウンロードします。更新は、次にClaude Codeを起動したときから反映されます。

すぐに更新したいときは、次のコマンドを実行します。

claude update

更新できたときは「Successfully updated from 旧バージョン to version 新バージョン」、すでに最新のときは「Claude Code is up to date」と表示されます。Homebrewで入れた場合の表示は「Claude is up to date!」です。最後の更新の結果は、claude doctor で確認できます。

更新の頻度を変える

自動更新で受け取る版は、設定で選べます。標準は「latest」で、新機能が出ると同時に反映されます。「stable」を選ぶと、最新版より1週間ほど前の、大きな不具合があった版を飛ばしたものを使います。会社で、新機能よりも安定を優先したい場合に向いています。

設定は、Claude Codeの中で /config を開き、「Auto-update channel」から変えられます。設定ファイル（~/.claude/settings.json）に "autoUpdatesChannel": "stable" と書く方法もあります。自動更新そのものを止めたい場合は、設定ファイルの env で DISABLE_AUTOUPDATER を "1" にします。ただし、これでも claude update の手動更新は使えます。

アンインストールする

入れ方によって、消し方が変わります。

これで、Claude Code本体は消えます。それでも claude が動いてしまう場合は、別の方法で入れたものが残っています。which -a claude で場所を確かめて、そのものを消してください。古い版のClaude Codeが作った、シェルの設定ファイル内の claude の別名（エイリアス）が残っている場合もあります。

設定や会話の履歴も消す

上の手順では、設定や会話の履歴は残ります。これらも消したいときは、次のコマンドを実行します。

rm -rf ~/.claude
rm ~/.claude.json

プロジェクトごとの設定を消すときは、そのプロジェクトのフォルダで、.claude フォルダと .mcp.json を削除します。

よくある質問

まとめ

Claude CodeのMacへのインストールは、手順としては1行のコマンドで済みますが、会社のMacでは、ネットワークの制限やセキュリティ対策のソフトで止まるなど、環境に固有の事情が出やすいところです。

INTERCREATE JAPANでは、Claude CodeやCodexの導入について、社内の環境に合わせた入れ方の整理から、使い方のルールづくりまでをお手伝いしています。社内で何人かに使ってもらう段階でつまずいている場合も、お気軽にご相談ください。