Mac向けClaude Code 導入方法｜インストールから初回起動まで整理した

Claude Codeを導入しようとしたとき、インストール方法が複数あって「どれが正解？」となったので、自分なりに整理してみました。npmでやろうとしてハマったのも今となっては笑い話です。

この記事では、2026年3月時点のMac向けClaude Codeのインストール方法を中心に、認証の流れ・起動確認・最初にやっておくべきことまでまとめています。

Claude Codeの概要と他ツールとの違い
Macへの導入前に確認すること（プラン・OS）
ネイティブインストーラーとHomebrewの使い分け
初回起動・認証の手順
最初にやっておくといい設定
ハマりやすいポイントまとめ

Claude Codeって何？
事前に確認しておくこと
1. 対応macOSバージョン
2. 必要なClaudeプラン
Mac向けClaude Codeのインストール方法は2つ
ネイティブインストーラーで入れる（推奨）
Homebrewで入れる場合
初回起動と認証の手順
1. テーマの選択
2. 認証方式の選択
最初にやっておくといいこと
1. /init でCLAUDE.mdを生成する
2. 基本コマンドを把握しておく
ハマりやすいポイント
まとめ

Claude Codeって何？

Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングアシスタントです。ブラウザやIDEのプラグインだけではなく、ターミナルからClaudeと対話しながらコードの生成・修正・ファイル操作・git操作などができます。

CursorやGitHub Copilotとよく比較されますが、Claude Codeは「エージェント型」っぽく動くのが特徴で、自分でファイルを読んで、変更して、確認して、というサイクルを（いい感じに）回してくれます。コードを手動でペーストしなくていいのが個人的にはかなりありがたいです。

余談ですが、最初にデモ動画を見たとき「これ本当に動くのか？」と半信半疑でした。実際に使ってみると、思ってたより普通に動いて逆に驚いた。

事前に確認しておくこと

インストール前にいくつか確認しておくべきことがあります。

対応macOSバージョン

公式ドキュメントではMac向けの手順はmacOS/Linux/WSL向けとしてまとめて案内されています。最小バージョンの明確な記載はQuickstart上では見当たらなかったので、断定は避けておきます。

なので現実的なアプローチとしては、「まず入れてみて claude doctor で診断する」が無難かなと。M1以降のApple SiliconでもIntelでも動作報告は多いですが、最終的には手元の環境次第です。

必要なClaudeプラン

Claude Codeは「Claudeのサブスク」または「API課金（Console等）」で利用できます。公式ドキュメントでは以下のアカウント種別が案内されています。

Claude Pro: $20/月（月額払いの場合）
Claude Max: Proの上位枠として案内（価格はプラン選択画面で確認）
Claude Teams: チーム向け
Claude Enterprise: 企業向け
Claude Console（APIキー）: プリペイドクレジットによるAPI利用

基本はPro/Max/Teams/Enterprise、もしくはConsole(API)で使う、という認識でOKです。自分はとりあえずProプランで試しました。重い作業をバンバンやるとレート制限に引っかかることはありましたが、個人の趣味開発なら普通に使えています。

Mac向けClaude Codeのインストール方法は2つ

2026年3月時点で、MacにClaude Codeをインストールする方法は主に以下の2つです（公式Quickstartに記載あり）。

ネイティブインストーラー（curl コマンド）← 公式推奨
Homebrew

結論から言うと、ネイティブインストーラーを使うのが一番シンプルでおすすめです。バックグラウンドで自動アップデートされる点も公式ドキュメントに明記されています。

なお、以前よく使われていた npmグローバルインストール（npm install -g @anthropic-ai/claude-code）は、現行の公式Quickstartの選択肢からは外れています。自分がnpmでハマったのはここで、今から新規導入するならわざわざnpmを選ぶ理由は薄いかな…という所感です。

ネイティブインストーラーで入れる（推奨）

ターミナルを開いて、以下のコマンドを1行叩くだけです（公式Quickstartの手順）。

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

完了後は、ターミナルを再起動するか source ~/.zshrc などでPATHを反映させます。「再起動」が一番確実かも。

バージョンが表示されればインストール成功です。

claude --version

ちゃんと動いてるか不安な場合は以下も試してみてください。更新絡みのエラーが出るときも、まず claude doctor から入るのがよさそうです。

claude doctor

Homebrewで入れる場合

Homebrewで管理したい場合はこちら（公式Quickstartの手順）。

brew install --cask claude-code

ただし、Homebrew版は自動アップデートされません。公式ドキュメントでも、定期的に brew upgrade claude-code を実行して最新の機能とセキュリティ修正を取得する必要がある、と案内されています。

「自動更新されなくていいから、Brewで一元管理したい」という人はこちらでもいいと思います。そういう人は分かってやってると思うので特に補足はないです。

初回起動と認証の手順

インストールが済んだら、まずプロジェクトのディレクトリに移動して claude コマンドを実行します。

cd ~/your-project
claude

初回起動時はいくつかの設定画面が出てきます。

テーマの選択

最初にテキストのテーマカラーを選択する画面が表示されます。好みで選べばOKです。後から /config で変更できます。

認証方式の選択

次に認証方式を選択します。公式Quickstartでは以下が案内されています。

Claudeのサブスク（Pro / Max / Teams / Enterprise）: ブラウザが開いてログインするタイプ（迷ったらこれ）
Claude Console: API（プリペイドクレジット）での利用。初回ログイン時にConsole側にClaude Code用ワークスペースが作成され、コスト追跡を集約できると案内されています
Amazon Bedrock / Google Vertex AI / Microsoft Foundry: 企業向けクラウドプロバイダ経由

迷ったら「Claudeのサブスク（ブラウザでログイン）」を選ぶのがおすすめです。ブラウザでログインするだけで完了し、追加の設定が少なめで済みます。

ブラウザでログイン → 認証完了のメッセージがターミナルに戻ってくれば準備完了です。アカウントを切り替えたいときは /login で再ログインできます。

最初にやっておくといいこと

/init でCLAUDE.mdを生成する

Claude Codeを使い始める前に、プロジェクトのルートで /init を実行してみてください。

/init

CLAUDE.md は、Claude Codeの挙動をカスタムするための「追加指示」として使えるファイルです。公式ドキュメントでも、カスタム指示の追加方法として案内されています。

自分の場合は「このプロジェクトはPython + AWS Lambda構成で、コードはすべて英語コメントで」みたいな内容を書いておいたら、毎回言わなくても守ってくれるようになりました。地味に助かっています。

基本コマンドを把握しておく

よく使うスラッシュコマンドをざっくりまとめておきます。

/help: コマンド一覧を表示
/config: 設定UIを開く
/doctor: インストール状態の診断（困ったらとりあえず）
/init: CLAUDE.mdを作る/整える
/login: ログインし直す（アカウント切り替えにも）
/exit: 終了

ハマりやすいポイント

導入時に詰まったこととか、よく報告されているトラブルをまとめておきます。

PATHが通っていない: インストール後にターミナルを再起動しないと claude コマンドを認識しないことがある。とりあえずターミナル再起動、それでもダメなら source ~/.zshrc など
Homebrewで入れたのに自動更新されると思っていた: Homebrew版は自動更新されません。brew upgrade claude-code が必要です
認証が通らない: Pro/Max/Teams/Enterprise か Console(API) など、Claude Codeで使えるアカウントになっているか確認する
とりあえず困ったら: claude doctor を叩く。アカウントを切り替えたいなら /login