Apple Silicon Mac を手に入れて、まず最初に設定したいのが開発環境ですよね。特に Homebrew は macOS での開発に欠かせないパッケージマネージャーです。しかし、Intel Mac から移行した方や、初めて Mac を使う方にとって、Apple Silicon 特有の ​/​opt​/​homebrew というパスや、GUI アプリケーションとの連携設定は少し戸惑うポイントではないでしょうか。

本記事では、Apple Silicon Mac における Homebrew の最適なセットアップ方法を、基本的なインストールから PATH 設定、GUI アプリケーションとの連携まで一気通貫で解説します。この記事を読めば、スムーズに開発環境を整えられるでしょう。

背景

Apple Silicon と Homebrew の関係性

Apple は 2020 年に独自設計の Apple Silicon（M1 チップ）を搭載した Mac をリリースしました。それ以降、M2、M3 と進化を続けています。この ARM64 アーキテクチャへの移行により、多くのソフトウェアが対応を迫られました。

Homebrew もその一つで、Intel Mac と Apple Silicon Mac では インストール先のパスが異なる という重要な変更が加えられました。

以下の図は、Intel Mac と Apple Silicon Mac における Homebrew のインストール先の違いを示しています。

mermaidCopy codeflowchart TB
  mac["Mac の種類"]
  intel["Intel Mac"]
  silicon["Apple Silicon Mac"]
  path1["/usr/local"]
  path2["/opt/homebrew"]

  mac --> intel
  mac --> silicon
  intel --> path1
  silicon --> path2

この違いにより、既存のドキュメントやスクリプトをそのまま使うと、パスが見つからないといったエラーが発生する可能性があります。

Intel Mac との主な違い

Intel Mac では Homebrew は ​/​usr​/​local 配下にインストールされていました。しかし Apple Silicon Mac では ​/​opt​/​homebrew が標準のインストール先となっています。

#	項目	Intel Mac	Apple Silicon Mac
1	アーキテクチャ	x86_64	ARM64
2	インストール先	/usr/local	/opt/homebrew
3	バイナリパス	/usr/local/bin	/opt/homebrew/bin
4	Rosetta 2	不要	Intel バイナリ実行時に必要

この変更には、システムの整合性保護（SIP）やセキュリティ上の理由があります。

課題

PATH 設定の複雑さ

Apple Silicon Mac に Homebrew をインストールした後、多くの開発者が直面するのが「コマンドが見つからない」という問題です。これは ​/​opt​/​homebrew​/​bin が自動的に PATH に追加されないことが原因となっています。

以下は、Homebrew インストール後によく発生する問題のフローを示した図です。

mermaidCopy codeflowchart TD
  install["Homebrew インストール"]
  cmd["ターミナルでコマンド実行"]
  check{"PATH に<br/>/opt/homebrew/bin<br/>が存在？"}
  success["コマンド実行成功"]
  error["command not found エラー"]

  install --> cmd
  cmd --> check
  check -->|はい| success
  check -->|いいえ| error

主な課題一覧

初心者から中級者まで、以下のような課題に直面することが多いでしょう。

#	課題	影響範囲	深刻度
1	PATH が通らず brew コマンドが使えない	CLI 全般	★★★
2	GUI アプリが Homebrew のライブラリを認識しない	GUI アプリ	★★☆
3	シェル起動時の設定ファイルが複数あり混乱	環境設定	★★☆
4	Intel 版と ARM 版のバイナリが混在	互換性	★★★

これらの課題を一つ一つ解決していくことで、快適な開発環境が整います。

シェル設定ファイルの選択

macOS では、デフォルトシェルが bash から zsh に変更されました。そのため、設定ファイルも .bashrc ではなく .zshrc を使用する必要があります。

しかし、複数の設定ファイル（.zshrc、.zprofile、.zshenv など）が存在し、どれに PATH を記述すべきか迷うこともあるでしょう。

解決策

Homebrew の正しいインストール手順

Apple Silicon Mac で Homebrew を最適にセットアップするための手順を、段階的に解説します。

ステップ 1：Xcode Command Line Tools のインストール

Homebrew をインストールする前に、Xcode Command Line Tools が必要です。

bashCopy codexcode-select --install

このコマンドを実行すると、インストールダイアログが表示されます。指示に従ってインストールを完了させてください。

ステップ 2：Homebrew のインストール

公式サイトで提供されているインストールスクリプトを実行します。

bashCopy code/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

このスクリプトは自動的に Apple Silicon を検出し、​/​opt​/​homebrew にインストールを行います。インストールには数分かかる場合があります。

ステップ 3：PATH の設定

インストール完了後、ターミナルに表示される指示に従って PATH を設定します。

以下は、zsh を使用している場合の設定例です（macOS Catalina 以降のデフォルト）。

bashCopy codeecho 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile

この 1 行を実行するだけで、必要な環境変数がすべて設定されます。

設定を即座に反映させるには、以下のコマンドを実行しましょう。

bashCopy codeeval "$(/opt/homebrew/bin/brew shellenv)"

ステップ 4：インストールの確認

正しくインストールされたか確認します。

bashCopy codebrew --version

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

bashCopy codewhich brew

このコマンドで ​/​opt​/​homebrew​/​bin​/​brew と表示されることを確認してください。

PATH 設定の詳細解説

brew shellenv コマンドは、以下の環境変数を設定します。

bashCopy code# 実際に設定される内容を確認
/opt/homebrew/bin/brew shellenv

実行すると、以下のような出力が得られます。

bashCopy code# Homebrewが設定する環境変数の例
export HOMEBREW_PREFIX="/opt/homebrew"
export HOMEBREW_CELLAR="/opt/homebrew/Cellar"
export HOMEBREW_REPOSITORY="/opt/homebrew"

bashCopy code# PATH の設定
export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"

bashCopy code# man ページのパス設定
export MANPATH="/opt/homebrew/share/man:$MANPATH"
export INFOPATH="/opt/homebrew/share/info:$INFOPATH"

これらの環境変数により、Homebrew でインストールしたコマンドやライブラリが正しく認識されるようになります。

シェル別の設定ファイル

使用しているシェルによって、設定ファイルが異なりますので注意しましょう。

#	シェル	設定ファイル	読み込みタイミング
1	zsh（推奨）	~/.zprofile	ログイン時
2	zsh	~/.zshrc	シェル起動時
3	bash	~/.bash_profile	ログイン時
4	bash	~/.bashrc	シェル起動時

macOS Catalina 以降では zsh がデフォルトなので、.zprofile に記述するのが最も適切です。

具体例

基本的なパッケージのインストール

Homebrew のセットアップが完了したら、実際にパッケージをインストールしてみましょう。

Node.js のインストール例

Web 開発でよく使われる Node.js をインストールします。

bashCopy code# Node.js のインストール
brew install node

インストール後、バージョンを確認しましょう。

bashCopy code# Node.js のバージョン確認
node --version

bashCopy code# npm のバージョン確認
npm --version

これで Node.js と npm が使えるようになりました。

Git のインストールと設定

バージョン管理ツールの Git も Homebrew でインストールできます。

bashCopy code# Git のインストール
brew install git

インストール後、ユーザー情報を設定します。

bashCopy code# Git のグローバル設定
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

これで Git を使った開発が始められます。

GUI アプリケーションのインストール（Cask）

Homebrew では、CLI ツールだけでなく GUI アプリケーションもインストール可能です。この機能を Homebrew Cask と呼びます。

以下の図は、Homebrew における CLI ツールと GUI アプリのインストール方式の違いを示しています。

mermaidCopy codeflowchart LR
  brew["Homebrew"]
  cli["CLI ツール"]
  gui["GUI アプリ"]
  install1["brew install"]
  install2["brew install --cask"]
  path1["/opt/homebrew/bin"]
  path2["/Applications"]

  brew --> cli
  brew --> gui
  cli --> install1
  gui --> install2
  install1 --> path1
  install2 --> path2

Visual Studio Code のインストール

人気のコードエディタ VS Code をインストールしてみましょう。

bashCopy code# VS Code のインストール
brew install --cask visual-studio-code

インストールが完了すると、​/​Applications フォルダに Visual Studio Code がインストールされます。Spotlight 検索や Launchpad から起動できるようになります。

その他の推奨 GUI アプリ

よく使われる GUI アプリケーションの例です。

bashCopy code# Google Chrome のインストール
brew install --cask google-chrome

bashCopy code# Docker Desktop のインストール
brew install --cask docker

bashCopy code# Slack のインストール
brew install --cask slack

これらのアプリは通常、公式サイトからダウンロードしてインストールしますが、Homebrew を使えばコマンド一つで完了します。

GUI アプリケーションとの連携設定

GUI アプリケーションが Homebrew でインストールしたライブラリやツールを認識するための設定を解説します。

VS Code でのターミナル統合

VS Code の統合ターミナルで Homebrew のパスを認識させるには、設定ファイルを確認します。

VS Code を開き、Command + , で設定画面を開きましょう。検索ボックスに「terminal.integrated.env」と入力します。

通常、.zprofile に PATH を設定していれば、VS Code は自動的にそれを読み込みます。もし認識しない場合は、以下の設定を settings.json に追加してください。

jsonCopy code{
  "terminal.integrated.env.osx": {
    "PATH": "/opt/homebrew/bin:/opt/homebrew/sbin:${env:PATH}"
  }
}

この設定により、VS Code の統合ターミナルでも Homebrew のコマンドが使えるようになります。

アプリケーション固有の環境変数

一部のアプリケーションは、独自の環境変数設定が必要な場合があります。

例えば、Python の開発環境を構築する場合は以下のようになります。

bashCopy code# Python 3 のインストール
brew install python@3.12

インストール後、pip のパスを確認します。

bashCopy code# pip3 のパスを確認
which pip3
# 出力例：/opt/homebrew/bin/pip3

環境変数 PYTHONPATH を設定する必要がある場合は、.zprofile に追記しましょう。

bashCopy code# .zprofile に追記
echo 'export PYTHONPATH="/opt/homebrew/lib/python3.12/site-packages:$PYTHONPATH"' >> ~/.zprofile

設定を反映させます。

bashCopy codesource ~/.zprofile

パッケージの管理とメンテナンス

Homebrew でインストールしたパッケージは、定期的なメンテナンスが推奨されます。

パッケージのアップデート

インストール済みのパッケージを最新版にアップデートします。

bashCopy code# Homebrew 自体のアップデート
brew update

bashCopy code# インストール済みパッケージのアップデート
brew upgrade

特定のパッケージだけをアップデートすることもできます。

bashCopy code# Node.js のみアップデート
brew upgrade node

不要なファイルのクリーンアップ

古いバージョンのパッケージを削除してディスク容量を節約しましょう。

bashCopy code# 古いバージョンの削除
brew cleanup

自動クリーンアップを有効にすることも可能です。

bashCopy code# 自動クリーンアップの有効化
brew cleanup --prune=all

インストール済みパッケージの確認

現在インストールされているパッケージを確認できます。

bashCopy code# CLI ツールの一覧
brew list

bashCopy code# GUI アプリの一覧
brew list --cask

より詳細な情報を見たい場合は、以下のコマンドを使います。

bashCopy code# パッケージ情報の詳細表示
brew info node

トラブルシューティング

実際の運用で遭遇する可能性のある問題と解決方法を紹介します。

エラー：command not found: brew

このエラーが表示される場合、PATH が正しく設定されていません。

解決方法 1：設定ファイルの確認

.zprofile に以下の行が存在するか確認します。

bashCopy code# 設定ファイルの内容を確認
cat ~/.zprofile | grep homebrew

何も表示されない場合は、PATH が設定されていません。

解決方法 2：PATH の再設定

以下のコマンドで PATH を設定し直します。

bashCopy codeecho 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile

解決方法 3：直接パスを指定

一時的な対処として、フルパスでコマンドを実行することもできます。

bashCopy code/opt/homebrew/bin/brew --version

エラー：Error: Permission denied

権限エラーが発生した場合の対処法です。

原因の特定

Homebrew のディレクトリの所有者を確認します。

bashCopy code# 所有者の確認
ls -la /opt/homebrew

解決方法：所有者の変更

自分のユーザーが所有者になるよう変更しましょう。

bashCopy code# 所有者を変更（YOUR_USERNAMEは実際のユーザー名に置き換え）
sudo chown -R $(whoami) /opt/homebrew

ただし、この操作は慎重に行ってください。通常は Homebrew のインストールスクリプトが自動的に適切な権限を設定します。

Intel 版と ARM 版の混在問題

Rosetta 2 を使って Intel 版のアプリを実行している場合、パッケージが混在することがあります。

以下のコマンドでアーキテクチャを確認できます。

bashCopy code# 現在のアーキテクチャを確認
arch
# 出力：arm64（Apple Silicon ネイティブの場合）

Intel 版で実行する必要がある場合は、以下のように Rosetta 2 経由で実行します。

bashCopy code# Rosetta 2 経由で実行
arch -x86_64 /bin/bash

ただし、基本的には ARM64 ネイティブの環境を維持することをお勧めします。

実践的な開発環境セットアップ例

最後に、実際の開発シーンを想定した環境構築の例を紹介しましょう。

Web 開発環境（Node.js + TypeScript）

モダンな Web 開発環境を構築します。

bashCopy code# 必要なツールのインストール
brew install node
brew install yarn

bashCopy code# TypeScript のグローバルインストール
npm install -g typescript

bashCopy code# バージョン確認
node --version
yarn --version
tsc --version

これで TypeScript を使った開発が始められます。

コンテナ開発環境（Docker）

コンテナベースの開発環境を構築しましょう。

bashCopy code# Docker Desktop のインストール
brew install --cask docker

インストール後、Launchpad から Docker を起動します。初回起動時は権限の確認ダイアログが表示されるので、許可してください。

Docker が起動したら、ターミナルで動作確認を行います。

bashCopy code# Docker のバージョン確認
docker --version

bashCopy code# Docker の動作テスト
docker run hello-world

「Hello from Docker!」というメッセージが表示されれば成功です。

データベース開発環境（PostgreSQL）

データベースを使った開発環境を整えます。

bashCopy code# PostgreSQL のインストール
brew install postgresql@15

サービスを起動しましょう。

bashCopy code# PostgreSQL の起動
brew services start postgresql@15

データベースに接続して動作確認を行います。

bashCopy code# psql でデータベースに接続
psql postgres

正常に接続できれば、PostgreSQL プロンプトが表示されます。終了するには \q と入力してください。

まとめ

本記事では、Apple Silicon Mac における Homebrew の最適なセットアップ方法を解説しました。重要なポイントを振り返りましょう。

主要ポイント

1. インストール先の理解：Apple Silicon Mac では ​/​opt​/​homebrew が標準のインストール先です
2. PATH 設定の重要性：.zprofile に eval "$(​/​opt​/​homebrew​/​bin​/​brew shellenv)" を追記することで、すべての環境変数が自動設定されます
3. GUI アプリとの連携：Homebrew Cask を使えば、GUI アプリケーションもコマンドラインから簡単にインストール可能です
4. 定期的なメンテナンス：brew update と brew upgrade で常に最新の状態を保ちましょう

環境構築のベストプラクティス

• Homebrew のインストール前に Xcode Command Line Tools を導入する
• シェルの設定ファイル（.zprofile）に PATH を正しく記述する
• CLI ツールは brew install、GUI アプリは brew install --cask を使い分ける
• 定期的に brew cleanup を実行してディスク容量を節約する

Apple Silicon Mac での開発環境構築は、Intel Mac の時代と比べて少し手順が変わりましたが、本記事で紹介した方法に従えば、スムーズに環境を整えることができます。

Homebrew を活用することで、開発に必要なツールやアプリケーションを効率的に管理できるようになり、より生産的な開発ライフを送れるでしょう。ぜひこの記事を参考に、快適な開発環境を構築してください。

関連リンク

• Homebrew 公式サイト
• Homebrew GitHub リポジトリ
• Homebrew Cask 公式ドキュメント
• Apple Silicon について - Apple サポート
• Xcode Command Line Tools - Apple Developer
• zsh 公式ドキュメント