MacでClaude Codeを使う方法をお探しですね。

広告

【2024年最新】Claude CodeのMacへのインストール方法｜npmは非推奨！Homebrewが正解な理由

話題のAIコーディングツール「Claude Code」、使ってみたいですよね！でも、いざインストールしようとすると「Homebrewがいいの？それともnpm？」って迷っちゃう人が多いんです。

実は、昔はnpmでのインストール方法も紹介されていたんですが、**今はもう違います。

**

**結論から言うと、Macなら「Homebrew」か「公式インストーラー」を使うのが正解です。

npmは今、公式で「非推奨」になっています。

**

この記事では、なんでnpmがダメになったのか、Homebrewでの正しいインストール方法、それに「もうnpmで入れちゃったよ…」って人向けの移行方法まで、わかりやすく説明していきますね！

なんでnpmじゃダメなの？Homebrewが推奨される理由

MacでClaude Codeを使うなら、Homebrewか公式のインストーラーを使うのがベストです。

実は最初の頃、npmでインストールする方法もよく紹介されていたんですが、今はAnthropic社（作ってる会社）の公式ドキュメントで「Deprecated（非推奨）」ってはっきり書かれています。

**じゃあなんでダメになったの？**

一番の理由は、**npmのグローバルインストールってトラブルが起きやすい**からなんです。

npmで`-g`オプションを使ってツールを入れると、パソコンの権限設定とかNode.jsのバージョン管理ツール（nvmとか）との相性で、エラーが出ちゃうことがあるんですよね。

それに、`sudo`（管理者権限）を使ってインストールするのはセキュリティ的にもよくないし、システム全体の設定がぐちゃぐちゃになって、他の開発プロジェクトにも悪影響が出ることがあります。

いわゆる「環境汚染」ってやつですね。

**Homebrewや公式インストーラーだと何がいいの？**

これらの方法だと、システムから独立した場所にツールが入るので、他のライブラリやツールと喧嘩しにくいんです。

しかも公式の署名付きファイルを使うから、セキュリティ面でも安心。

これから入れる人は、迷わずHomebrewか公式インストーラーを選んでおけば、後々困ることがグッと減りますよ！

【実践編】Homebrewを使った正しいインストール方法

それじゃあ実際に、Homebrewを使ってClaude Codeをインストールしてみましょう！HomebrewはMacユーザーなら知っておきたい定番のパッケージ管理ツールで、インストールもアンインストールも簡単です。

**【Homebrewでのインストール手順】**

1. **ターミナルを開く**
「ターミナル」アプリを起動します（LaunchpadやSpotlight検索から探せます）。

2. **このコマンドを入力して実行**
“`

brew install --cask claude-code

“`
これだけ！あとは自動でインストールが進みます。

3. **ちゃんと入ったか確認**
インストールが終わったら、こう入力してみてください。

“`

claude --version

“`
バージョン番号が表示されたら成功です！

**公式インストーラーを使う方法もあります**

「Homebrewは使ってないんだよね」って人や、「公式が一番推してる方法がいい！」って人は、`curl`コマンドを使った公式インストーラーもあります。

この方法だと、自動アップデート機能も有効になるので便利です（Homebrew版は手動で更新する必要があります）。

どっちを選んでも、npmみたいに複雑な問題に悩まされることなく、スッキリ使い始められますよ！

「もうnpmで入れちゃった…」って人へ｜安全な移行方法

「この記事読む前に、もうnpmでインストールしちゃったんだけど…」って人、いますよね？大丈夫です、ちゃんと移行できます！

今のままでも動くかもしれないけど、非推奨の方法を使い続けると、アップデートが受けられなくなったり、変なバグに遭遇したりするリスクがあります。

なので、早めに正しい方法に切り替えちゃいましょう。

難しくないですよ！

**【移行手順】**

**ステップ1：npmパッケージを削除**
ターミナルでこのコマンドを実行します。

“`

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

“`
もし「権限がない」ってエラーが出たら、`sudo`をつけて実行してみてください（慎重に！）。

**ステップ2：ちゃんと消えたか確認**
“`

which claude

“`
このコマンドを入力して、何も出てこなければOKです（`claude not found`って出ることもあります）。

**ステップ3：正しい方法で再インストール**
さっき説明したHomebrewの手順で、改めてインストールしましょう。

「一度きれいに削除してから入れ直す」っていうのがポイントです。

こうすることで、古いのと新しいのが喧嘩して動かなくなる…なんてトラブルを防げます。

ちょっと面倒に感じるかもしれないけど、結果的にはこれが一番早くて確実な方法なんです！

インストール後の初期設定とトラブル対処法

インストールが無事終わったら、実際に使い始める準備をしましょう！

**初回起動と認証**

ターミナルで`claude`って入力してエンターを押すと、初期設定が始まります。

画面の指示に従ってブラウザが開くので、Anthropicのアカウントでログインしてください。

認証が終われば、もうClaude Codeとおしゃべりできるようになります！

**「コマンドが見つからない」って出たら？**

もし変なエラーが出たり、うまく動かなかったりしたら、診断ツールを使ってみましょう。

“`

claude doctor

“`
このコマンドを実行すると、インストール状況や必要なツールが揃っているかを自動でチェックしてくれます。

めっちゃ便利！

**アップデートについて**

Homebrewでインストールした人は、自動更新が効きません。

定期的に
“`

brew upgrade claude-code

“`
を実行して、手動でアップデートしましょう。

公式インストーラーを使った人は、バックグラウンドで自動的に更新されるので楽ちんです。

この違いを知っておいて、定期的にメンテナンスしてあげると、いつも快適に使えますよ！

まとめ

これでClaude Codeの導入は完璧です。

正しい方法でインストールしておけば、トラブルに悩まされることなく、AIと一緒に快適なコーディング生活が送れますよ。

さあ、さっそく使ってみましょう！

広告