Claude Code Mac 入門 — brew + Apple Silicon + 通知設定

Mac で動く要件 — macOS 13.0 以降・Apple Silicon と Intel 両対応・4 GB RAM

Claude Code は Mac でネイティブに動作する Anthropic 公式のエージェント型コーディング環境です。macOS 13.0(Ventura)以降 を要件とし、4 GB 以上の RAM・x64 または ARM64 プロセッサが必要です出典。M1 / M2 / M3 / M4 などの Apple Silicon、Intel Mac の両方で動作するため、近年の Mac であればほぼすべての機種で利用できます。

シェルは Bash・Zsh・PowerShell・CMD のいずれにも対応します。macOS の標準シェル(Zsh)で何の追加設定もなく動く ため、Homebrew や Xcode Command Line Tools が入っていない素の状態の Mac でも、ブラウザログインさえできればすぐに対話開始できます出典。

ネットワーク接続は必須で、Anthropic がサポートする国・地域からの利用に限られます。日本はサポート国に含まれており、追加の VPN 設定などは不要です。検索機能のために ripgrep が内部で同梱されますが、もし検索が動かない場合は別途 brew install ripgrep で解決できます出典。

利用にはサブスクリプションが必須 — 無料プランでは動かない

注意したいのが Free プランでは Claude Code が利用できない という点です出典。Pro($20/月・税別 USD)・Max($100〜)・Team・Enterprise のいずれかのサブスクリプションが必要で、無料の claude.ai アカウントだけでは認証が通りません。

Claude Code を本格的に使うなら Max プラン が推奨される場面が多くあります。Pro でもインストール・基本的な対話は可能ですが、Opus 4.7 をフル活用したり長時間エージェント作業を回す場合は Max が必須レベルです。料金詳細は Claude 料金プラン完全ガイド を参照してください。

3 経路インストール — 公式ネイティブ(推奨)・Homebrew・npm の使い分け

Mac には 3 つのインストール経路があり、用途と更新方針 で選び分けます。Anthropic は 公式ネイティブインストーラを推奨 しており、これを選んでおけば自動更新で常に最新版になります出典。

経路 1: 公式ネイティブインストーラ(推奨・自動更新あり)

ターミナルで以下 1 行を実行するだけで完了します。これが Anthropic 公式の推奨経路で、バックグラウンドで自動更新される 唯一の方法です。

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

インストール先は ~/.local/bin/claude で、初回はシェル設定ファイル(~/.zshrc など)に PATH が自動追加されます出典。自動更新は起動時と稼働中に定期的にチェック され、新版が出るとバックグラウンドでダウンロードされて次回起動時に反映されます。リリースチャネルは latest(常に最新)と stable(約 1 週間遅れで重大リグレッションをスキップ)を ~/.claude/settings.json の autoUpdatesChannel で切り替え可能です。

経路 2: Homebrew(macOS ユーザーに馴染みやすい)

Mac 開発者にとっては最も馴染みのある経路です。ただし自動更新されない 点には注意してください。

brew install --cask claude-code

Homebrew には 2 つの cask があります。claude-code が stable チャネル(リグレッションが除かれた安定版)、claude-code@latest が latest チャネル(リリース直後の最新版)です出典。安定版を選びたいなら前者、最新機能をすぐ試したいなら後者を選びます。

更新は自動で行われないため、定期的に手動でアップグレード する必要があります。

brew upgrade claude-code
# または latest cask を入れた場合
brew upgrade claude-code@latest

Homebrew は古いバージョンをディスクに残すため、brew cleanup を時々実行するとディスク容量を節約できます。Homebrew が入っていない Mac では、まず https://brew.sh からインストールしてください。

経路 3: npm(Node.js 環境がある人向け)

Node.js を既に使っている開発者なら npm 経路も選べます。Node.js 18 以降が必要で、グローバルインストールします。

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

npm パッケージはネイティブインストーラと同じバイナリを内部で配布しており、プラットフォーム別オプション依存(@anthropic-ai/claude-code-darwin-arm64 など) を経由してネイティブバイナリがインストールされます出典。Apple Silicon には darwin-arm64、Intel Mac には darwin-x64 が自動選択されるため、ユーザーが意識する必要はありません。

注意点として sudo npm install -g は使わない こと。権限問題やセキュリティリスクの原因になります。npm のグローバルパスをユーザーディレクトリに設定するか、nvm / volta などのバージョン管理ツール経由で Node.js を入れておくのが安全です。

どの経路を選ぶべきか — 推奨は公式ネイティブ

3 経路の比較を整理します。迷ったら公式ネイティブインストーラ を選んでおけば、自動更新で常に最新版が入ります出典。

インストール完了後は claude --version でバージョン確認、claude doctor で詳細診断ができます。claude doctor は PATH 設定・依存関係・認証状態・ネットワーク接続 を一括チェックしてくれるため、問題が起きたときの最初の調査コマンドとして覚えておくと便利です出典。

初回起動と認証 — claude コマンドでブラウザログイン、Pro 以上が必須

インストールできたら、プロジェクトディレクトリに移動して claude コマンドを叩くだけで対話セッションが始まります出典。

cd ~/projects/my-app
claude

初回起動時は ブラウザが自動で開いて Anthropic アカウントのログイン画面 が表示されます。Pro / Max / Team / Enterprise アカウントのいずれかでログインしてください。Console アカウント(API クレジット利用)でも認証できます出典。

ログイン後、認証情報は ~/.claude/ ディレクトリに保存 され、次回以降は再ログイン不要です。アカウントを切り替えたい場合はセッション内で /login コマンドを実行します。Free プランは認証画面で弾かれるため、登録前に必ず Pro 以上にアップグレードしておいてください。

最初に試す 5 つの定番質問

セッションが開始したら、いきなりコードを書かせるよりも まずプロジェクトを理解させる のが定石です出典。以下 5 つの質問は Anthropic 公式が推奨するスタートパターンです。

what does this project do?
what technologies does this project use?
where is the main entry point?
explain the folder structure
what can Claude Code do?

Claude Code は質問に応じて 必要なファイルを自動で読み込んで 回答するため、ユーザーが手動でコンテキストを追加する必要はありません。最初の数分で「このコードベースを Claude が理解した」状態を作ってから具体的な編集タスクに移ると、精度が大きく上がります。

よく使うコマンド一覧

日常的に使うコマンドをまとめます。claude 単体での起動が基本ですが、ワンショットの質問・前回会話の継続など用途に応じた起動方法があります出典。

セッション内では ? キーでキーボードショートカット一覧、Tab でコマンド補完、↑ で履歴、/ でコマンド・スキル一覧が出ます。詳しい機能は Claude Code 完全ガイド も参照してください。

Mac 固有の使いこなし — Shift+Enter 改行・通知許可・Keychain 連携

Mac で Claude Code を快適に使うには、ターミナルアプリ側の設定 と macOS のシステム設定 の両方を整える必要があります。標準ターミナル(Terminal.app)・iTerm2・Warp・Ghostty などのどれを使うかで挙動が微妙に違うため、まずは自分の環境を確認しましょう。

複数行入力は Shift+Enter — 改行が単独 Enter で送信されないように

長いプロンプトを書くときに必須なのが Shift+Enter での改行 です。単独の Enter は送信扱いになるため、複数行のコードや指示を貼り付けるときは Shift を押しながら改行する習慣を付けてください。

ターミナルによっては Shift+Enter が改行として認識されない場合があります。その場合は iTerm2 の Profile → Keys で Shift+Return を \n 送信に設定、または Warp / Ghostty などの近代ターミナルに乗り換えるのが解決策です。標準ターミナル(Terminal.app)でも近年のバージョンでは Shift+Enter が自然に動くため、macOS をアップデートしておくことも有効です。

macOS 通知を許可する — 長時間タスクの完了を見逃さない

Claude Code を 長時間タスク(Routines や自動モードでの実行) で使うときは、macOS のシステム設定で通知許可を出しておくと作業完了を見逃しません。システム設定 → 通知 → ターミナル(または iTerm2 / Warp 等) で「通知を許可」をオンにします。

Anthropic 公式ドキュメントには macOS 通知の専用設定項目はありませんが、~/.claude/settings.json の env キーに通知関連の環境変数を仕込むことで挙動を制御できます出典。長時間エージェント作業や Routines を使う場合は、ターミナルアプリのバックグラウンド通知 と組み合わせて使うのが快適です。

認証情報は ~/.claude/ に保存 — Mac の Keychain と併用も可能

ログイン後の認証情報は ~/.claude/ ディレクトリに平文 JSON で保存されます。これを Mac の Keychain と統合したい 場合は、企業用の managed settings 機能を使うか、サードパーティのシークレット管理ツール経由で ANTHROPIC_API_KEY を環境変数注入する方法が選択肢になります出典。

複数アカウントを使い分ける場合は、~/.claude/ 全体を切り替えるか、プロジェクトごとの .claude/ 設定で上書きできます。会社用と個人用を Mac 1 台で運用する場合は、ユーザーアカウントを分けるか、CLAUDE_CONFIG_DIR 環境変数で切り替えるのが実用的です。

アンインストールも 2 行で完了

Claude Code を完全に消したくなったときは、ターミナルで以下 2 行を実行するだけです出典。

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Homebrew で入れた場合は brew uninstall --cask claude-code、npm で入れた場合は npm uninstall -g @anthropic-ai/claude-code です。設定・履歴も完全に消したい場合は rm -rf ~/.claude && rm ~/.claude.json を追加で実行します(設定がすべて消えるので注意)。

よくある質問(FAQ)— Mac ユーザーが詰まりやすいポイント

Mac で Claude Code を使い始める際によく寄せられる質問とその回答をまとめます。

Q. M1 / M2 / M3 / M4 Mac で動きますか?

はい、Apple Silicon(ARM64)に正式対応 しています出典。M1 以降のすべての Mac で動作し、Rosetta 2 を介さずネイティブ実行されるため動作も軽快です。npm 経由でもプラットフォーム自動判定で darwin-arm64 バイナリが選ばれます。

Q. Intel Mac でも動きますか?

はい、Intel(x64)対応 です出典。macOS 13.0 以降で 4 GB RAM があれば動作します。古い Intel Mac でも基本機能は問題なく使えますが、長時間エージェント作業ではメモリ不足になる場合があります。

Q. Free プランで Claude Code は使えますか?

使えません。Free の Claude.ai プランは Claude Code を含みません出典。Pro($20/月)以上、または Console アカウント(API 従量課金)が必須です。

Q. command not found: claude が出ます

PATH が通っていない 可能性が高いです。ネイティブインストーラを使った場合は ~/.local/bin が PATH に追加されているか echo $PATH で確認してください。source ~/.zshrc で再読み込みするか、新しいターミナルセッションを開き直すと解決することが多いです。claude doctor を実行すると詳細診断が出ます出典。

Q. Homebrew と公式インストーラはどっちを選ぶべき?

公式ネイティブインストーラを推奨 します出典。自動更新が効くため、放っておいても常に最新版が入ります。Homebrew 派の方は claude-code@latest cask を選び、brew upgrade を定期実行するルーティンを作っておくと安心です。

Q. アップデートはどう確認しますか?

ネイティブインストーラ版なら 起動時に自動でチェック され、バックグラウンドでダウンロードされます出典。手動で確認したい場合は claude update コマンドで即時アップデートできます。Homebrew・npm 経由は手動アップグレードが必要です。

Q. VS Code や JetBrains でも使えますか?

はい、VS Code 拡張・JetBrains プラグイン が公式提供されています出典。CLI と並行して使うのが定石で、コードベース全体の対話は CLI、特定ファイルのインライン編集は IDE 拡張、と使い分けます。詳細は Claude Code 完全ガイド を参照してください。

関連記事

• Claude Code 完全ガイド — 9 機能と料金プランを網羅
• Claude Code 4 月大型更新まとめ — デスクトップ再設計・Routines・xhigh など
• Claude Code ハーネスエンジニアリング入門 — 長時間タスク安定化の設計
• Claude 使い方 5 分入門 — 開発者でない人向け
• Claude 料金プラン完全ガイド — Pro / Max のどちらを選ぶか