macOSでClaude Codeをインストールする手順と初期設定：動作確認・削除まで

結論：macOSではネイティブインストーラーが基本、Homebrew派はbrewでも可

macOSでClaude Codeを使う手順は、2026年4月18日時点の公式セットアップガイドによると次の3ステップに集約できます。

1. AnthropicのPro以上のサブスク、またはAnthropic ConsoleのAPIクレジットを用意する
2. 公式のネイティブインストーラーか、HomebrewのcaskでClaude Codeを入れる
3. claude --versionとclaude doctorで動作確認し、プロジェクトディレクトリでclaudeを起動する

Apple SiliconとIntel Mac、どちらでも公式の同じ手順で入ります。OS要件はmacOS 13.0（Ventura）以降で、Node.jsやXcodeの事前導入は必須ではありません。環境要件の全体像はClaude Codeを始める前に必要な環境と準備まとめにまとめているので、足りない項目がある場合は先にそちらで整えてください。

本記事では、macOSで最短で起動するまでの具体手順と、よくある詰まりどころ、アンインストール手順までを順番にたどります。

インストール前に用意するもの

macOSで詰まずに進めるために、先に次をそろえておくと楽です。

• macOS 13.0（Ventura）以降（アップルメニュー > このMacについてで確認）
• ターミナルアプリ（標準のターミナル.app、iTerm2、Warpなど）
• gitが動くこと（Xcode Command Line ToolsまたはHomebrew経由）
• Anthropicアカウント（Claude.aiのPro／Max／Team／Enterpriseのいずれか、またはAnthropic ConsoleのAPIキー）

Claude.aiの無料プランではClaude Codeは使えません。料金の全体像や、無料で始める現実的な選択肢はClaude Codeは無料で使える？料金・制限・始め方を整理で詳しく整理しています。

Gitが入っているかどうかは次のコマンドで確認できます。

git version 2.x.xのような出力が返ればOKです。command not foundの場合は、xcode-select --installでXcode Command Line Toolsを入れるのが最短です。

ルート1：公式ネイティブインストーラー（推奨）

公式ドキュメントでもっとも推奨されているのが、ワンライナーのネイティブインストーラーです。macOS／Linux／WSLで共通のコマンドが使えます。

このインストーラーは、ユーザー領域（~/.local/bin/claude）にバイナリを配置し、バックグラウンドで自動更新を有効化します。sudoは不要で、システム全体に干渉しないのがメリットです。

ワンライナーを走らせたあと、次の2点を確認しましょう。

• 「~/.local/binをPATHに追加してください」というメッセージが出たら、ターミナルを一度閉じて開き直す（zshなら~/.zshrcにPATHが書き込まれます）
• それでもclaudeが見つからない場合は、~/.local/binがPATHに含まれているかecho $PATHで確認する

バージョンを指定して入れたいときや、安定版（stable）チャンネルに切り替えたいときは、同じスクリプトに引数を渡せます。たとえば安定版は次のコマンドです。

latest（新機能がすぐ届く）とstable（約1週間遅れ、重大な不具合のあるリリースはスキップ）の2チャンネルが用意されています。チームで挙動をそろえたい場合はstableを選ぶのが無難です。

ルート2：Homebrewで入れる

Homebrewを日常的に使っているなら、caskでインストールする手もあります。2つのcaskが用意されていて、挙動が違う点に注意してください。

• claude-code: stableチャンネル（約1週間遅れ、重大不具合はスキップ）
• claude-code@latest: latestチャンネル（公開直後の最新版）

最新版を追いたい場合は次のコマンドで入れます。

Homebrewで入れた場合は自動更新が効きません。バージョンを上げるときはbrew upgradeを手動で走らせます。

claude-code@latestを入れた人は、brew upgrade claude-code@latestが正しいコマンドです。update通知がClaude Code側から出てもHomebrewに反映されていないことがあるので、その場合は少し時間を置いてから再試行してください。

ネイティブ／Homebrewどちらを選ぶか

新規で特にこだわりがなければネイティブインストーラーが素直です。brewで全ツールを管理したい場合のみHomebrewを選んでください。

インストール確認

どちらのルートで入れても、次のコマンドが通れば成功です。

バージョン番号が表示されなかったときは、ターミナルを閉じて開き直してみます。ログインシェルでPATHが再読み込みされれば、ほとんどのケースで解消します。

次に、公式が用意している総合診断コマンドで環境をチェックします。

claude doctorは、シェル、依存コマンド、ネットワーク疎通などを自動で確認して、問題点があれば具体的に教えてくれます。初期導入で何かおかしいときは、まずこのコマンドを走らせるのが鉄則です。

認証：初回ログインの流れ

インストール後、最初にclaudeを起動すると、ブラウザが立ち上がってAnthropicの認証画面が出ます。手順は次のとおりです。

1. 表示されたURLが自動で開く（開かない場合はターミナルに出たURLをブラウザに貼る）
2. Claude.aiにPro／Max／Team／Enterpriseのいずれかのアカウントでログイン
3. 権限確認画面で「Allow」を押す
4. ターミナルに戻り、ログイン成功のメッセージを確認

APIキー経由でログインする場合は、起動時に「API key」を選び、Anthropic Consoleで発行したキーを貼り付けます。環境変数で渡す場合は次のように設定します。

.zshrcや.zprofileに書いて常用するのはキー漏えいのリスクがあるため、セッション単位で設定するか、dotenv系のツールで管理するのが安全です。会社支給のAmazon Bedrock、Google Vertex AI、Microsoft Foundry経由で使う場合の詳細は、公式の認証ページを確認してください。

最初の起動：対話を始めてみる

認証が通ったら、普段使っているプロジェクトのディレクトリに移動して、もう一度claudeコマンドを打ちます。

起動すると、プロンプトが立ち上がって自由に依頼を打ち込める状態になります。初回はたとえば次のような軽い依頼から始めると、挙動や出力形式を把握しやすくなります。

• 「このリポジトリの主要なディレクトリ構成を教えて」
• 「README.mdを読んで、このプロジェクトが何をしているか3行で説明して」
• 「package.jsonのscriptsの用途を整理して」

依頼のベストプラクティスは別記事で扱いますが、入口としては「調査系の依頼」から始めて、書き換え系（ファイル編集・コミット）は慣れてから試すのが安全です。

よくあるエラーと対処

command not found: claude

PATHが通っていないケースがほとんどです。対処は次の順で試します。

1. 新しいターミナルを開き直す
2. echo $PATHに~/.local/binが含まれているか確認する
3. 含まれていなければ~/.zshrcにexport PATH="$HOME/.local/bin:$PATH"を追記し、source ~/.zshrcを実行する

HomebrewでCask 'claude-code' is unavailable

Homebrewのtapが古い可能性があります。次の順で試してください。

permission denied（ネイティブインストーラー）

~/.local/binや~/.local/share/claudeの書き込み権限がない可能性があります。自分のホームディレクトリ配下のはずなので、権限が落ちている場合はls -l ~/.local/binで所有者を確認し、必要に応じてchown -R "$(whoami)" ~/.localで所有者を戻します（システム全体の権限は変更しない）。

ブラウザ認証画面に戻ってこない

会社のVPNやプロキシでclaude.aiやclaude.comがブロックされているケースが疑わしいです。ネットワーク要件を確認し、HTTPS_PROXY環境変数が必要ならターミナル側にも設定します。

認証通過後に401 Unauthorizedが出る

Pro未満のアカウント（Claude.aiの無料プラン）ではClaude Codeは使えません。Claude Codeは無料で使える？料金・制限・始め方を整理で整理した条件を満たしているか再確認してください。

インストール後チェックリスト

最初の1セッションに進む前に、次を一度見直しておくとトラブルが減ります。

• claude --versionがバージョン番号を返す
• claude doctorに赤い警告が出ていない
• ~/.local/binもしくはHomebrewのbinがPATHに含まれている
• 認証がClaude.aiPro以上か、Anthropic ConsoleのAPIクレジットのどちらかで完了している
• .envやAPIキーを含むディレクトリで起動していない（必要なら.gitignoreを整備）
• 最初の依頼は読み取り専用の調査系からスタートする

ここまで通っていれば、macOSでClaude Codeを日常的に使い始める準備は整っています。

バージョン管理とアップデート

ネイティブインストーラーで入れた場合、次のコマンドで即時アップデートを試せます。

通常はバックグラウンドで自動更新されますが、新機能をすぐ試したいときに便利です。Homebrewで入れた場合はbrew upgrade claude-code（またはclaude-code@latest）を走らせます。

組織で同じバージョンにそろえたい場合は、settings.jsonでautoUpdatesChannelやminimumVersionを設定できます。詳細は公式の設定ドキュメントを参照してください。

アンインストール手順

試してみて肌に合わなかった場合や、環境をクリーンにしたいときのアンインストール手順も、公式手順に沿って整理しておきます。

ネイティブインストールを消す

Homebrewで入れたものを消す

stable版を入れた場合は次のコマンドです。

latest版の場合は次のコマンドです。

設定や履歴も消したい場合

ユーザー設定、MCPサーバー構成、セッション履歴ごと削除するコマンドです。実行すると元に戻せない点に注意してください。

プロジェクト固有の設定も消したい場合は、対象プロジェクトで次のコマンドを走らせます。

VS Codeの拡張やJetBrains IDEのプラグインが残っていると、~/.claude/が自動で作り直されます。完全に消したい場合はエディタ側の拡張・プラグインも削除してください。

まとめ：最短15分で導入できる

macOSでのClaude Code導入は、公式のネイティブインストーラーを使えば実質ワンコマンドで終わります。躓くポイントは、ほとんどが「PATHが通っていない」「Pro未満のアカウントでログインしている」「gitが入っていない」の3点に集約されます。この記事のチェックリストをなぞれば、15分程度で対話を始めるところまで到達できます。

初回は調査系の依頼から始めて、慣れてきたら小さな機能追加やリファクタリングに広げるのが安全です。書き換え系のタスクに進んだら、コミット前の差分確認とテストの習慣を崩さないようにしてください。

次に読むべき同シリーズ記事

• Claude Codeを始める前に必要な環境と準備まとめ
• Claude Codeは無料で使える？料金・制限・始め方を整理
• Claude Codeとは？できること・向いている人・他のAIコーディングツールとの違い